查看 Markdown

Speridlabs Iris-Z

Speridlabs Iris-Z 是在 FLUX.2 上微调、在同一个序列里对图像及其深度一起去噪的模型。同一套权重可以根据提示词生成图像、用 4 步从照片估计深度、在给定深度上按提示词作画,以及同时返回一张图像和它的深度。LibreYOLO 通过 LibreGen 工厂运行它的两个尺寸。

任务
image generation, depth
尺寸
9b, 32b at 1024 px
安装
pip install "libreyolo[gen]"
支持层级
兄弟层级,自 v1.8.0 起。一个独立的产品面,有自己的工厂和契约。
上游
Speridlabs Iris-Z,由 Speridlabs 发布,采用 FLUX Non-Commercial License 许可。论文、源码
许可
代码采用 MIT and Apache-2.0,权重采用 FLUX Non-Commercial License。商用

安装

bash
pip install "libreyolo[gen]"

预测

任务在模型加载时就确定了:图像转深度用 task="depth",其他三种模式用默认的 generate。深度模型从不加载文本编码器。

图像转深度
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("speridlabs-iris-z", task="depth")   # 9b;不加载文本编码器result = model(SAMPLE_IMAGE) depth = result.depth_mapprint(depth.encoding)          # "log_depth":值越大越远print(depth.data.shape)        # (H, W),与照片尺寸相同print(depth.valid_mask.shape)  # 天空处为 Falseresult.save("depth.png")       # 上色后的深度图
文生图
from libreyolo import LibreGen model = LibreGen("speridlabs-iris-z")result = model("a lighthouse at dusk", seed=0)result.generated.save("lighthouse.png")
深度转图像
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("speridlabs-iris-z")# 先估计照片的深度,再在上面画出一个新场景result = model("a sunken ruin under the sea", source=SAMPLE_IMAGE, seed=0)result.generated.save("ruin.png")
图像加深度
from libreyolo import LibreGen model = LibreGen("speridlabs-iris-z")result = model("a grand old library, a spiral staircase", depth=True, seed=0)result.generated.save("library.png")print(result.depth_map.data.shape)
CLI
libreyolo generate prompt="a lighthouse at dusk" model=speridlabs-iris-zlibreyolo generate source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/guggenheim-bilbao.jpg task=depthlibreyolo generate source=photos/ task=depth ensemble=10 imgsz=1024

图像转深度。 数据源与 predict 接受的相同。result.depth_map 是一个 DepthMap,encoding="log_depth"(相对对数深度,值越大越远),尺寸与数据源相同, valid_mask 在天空处为 False。imgsz 是工作分辨率,512 或 1024(不到五十万像素 时默认 512,否则 1024)。可调参数:steps(4)和 ensemble(1),后者是在那么多个 seed 上取逐像素中位数。默认 seed 为 0,所以深度结果可以复现。save=True 把上色后的 深度图写到 runs/depth/predict 下。

文生图。 提示词、imgsz、seed 和 n 的用法与所有 图像生成模型相同。可调参数:steps(50)和 guidance(9b 为 4.0,32b 为 3.5)。

深度转图像。 generate 任务上的 source= 是作画所依据的深度:可以是一张照片 (先估计它的深度)、任意深度模型给出的 Results 或 DepthMap,或者配合 depth_format="depth"(越亮越远)或 "disparity"(越亮越近)的灰度深度图。只有当 depth_format 这样指定时,图像才会被当作深度图读取。输出保持深度的宽高比, Results.depth_map 就是作画所依据的深度。

图像加深度。 depth=True 联合采样图像和深度,然后像上游默认做法一样,根据生成 好的图像重新估计深度。结果同时带有 result.generated 和 result.depth_map。

CLI 支持文生图和图像转深度;在 CLI 里 prompt= 和 source= 仍然互斥。

变体

尺寸别名参数量文本编码器GPU 显存(库给出的数字)
9bsperidlabs-iris-z、-9b、-small9.1B,基于 FLUX.2 [klein] Base 9BQwen3 8B FP8约 18 GB,另加 9 GB 文本编码器和 0.2 GB VAE
32bsperidlabs-iris-z-32b、-big32.2B,基于 FLUX.2 [dev]Mistral Small 3.2 24B约 64 GB,另加 48 GB 文本编码器和 0.2 GB VAE

offload=True 会在两次提示之间把文本编码器留在 CPU 上。在缺少 transformers 所需 FP8 内核(kernels 包)的 CUDA 上,以及在 MPS 或 CPU 上,9b 的文本编码器会反量化 为 bfloat16 运行,结果接近但不完全等同于上游的嵌入向量。本地快照或变体文件夹可以用 LibreGen(path) 加载。

导出

任务ONNXTorchScriptExecuTorchTensorRTOpenVINOPaddleMNNRKNNAxelerancnnTFLiteCoreMLCore AI
Image generationImage generation to ONNX:不支持Image generation to TorchScript:不支持Image generation to ExecuTorch:不支持Image generation to TensorRT:不支持Image generation to OpenVINO:不支持Image generation to Paddle:不支持Image generation to MNN:不支持Image generation to RKNN:不支持Image generation to Axelera:不支持Image generation to ncnn:不支持Image generation to TFLite:不支持Image generation to CoreML:不支持Image generation to Core AI:不支持
DepthDepth to ONNX:不支持Depth to TorchScript:不支持Depth to ExecuTorch:不支持Depth to TensorRT:不支持Depth to OpenVINO:不支持Depth to Paddle:不支持Depth to MNN:不支持Depth to RKNN:不支持Depth to Axelera:不支持Depth to ncnn:不支持Depth to TFLite:不支持Depth to CoreML:不支持Depth to Core AI:不支持

与所有 LibreGen 家族一样,export()、train() 和 val() 会抛出异常。

许可证

请检查你所下载的具体权重在 Hugging Face 仓库中的许可。LibreYOLO 组织里的每个检查点都附有许可,同一家族内也不一定相同。该仓库是权威来源;以下摘要说明本页上次验证时适用的情况。

这里只说明涉及的许可证,不构成法律意见。如果答案对商用很重要,请自行阅读许可证并咨询法律顾问。

原始工作
Speridlabs Iris-Z, Speridlabs
上游许可
FLUX Non-Commercial License
LibreYOLO 代码
MIT
权重
采用 FLUX Non-Commercial License 许可,由作者分发。LibreYOLO 不托管或镜像这些权重。
解读
The Iris-Z weights are derived from FLUX.2 [dev] and FLUX.2 [klein] Base 9B and are under Black Forest Labs' FLUX Non-Commercial License, a custom agreement that is not OSI-approved: no commercial or production use, and Section 2(e) asks for content filtering or human review of generated images before they are shared. LibreYOLO's adapter is MIT; the transformer, samplers and prompt embedders it ports from the Speridlabs Iris-Z SDK keep Apache-2.0, as does the FLUX.2 code the SDK builds on, with their notices in libreyolo/models/gen/speridlabs_irisz/NOTICE. LibreYOLO does not redistribute any weights. They download at runtime, unmodified, from their publishers at pinned revisions: speridlabs/iris-z at 16239e1a5444c484b11a04b61d633eceb768574c (9b from Iris-Z-small, 32b from Iris-Z-big, not gated), the FLUX.2 VAE from black-forest-labs/FLUX.2-klein-4B (Apache-2.0), and the text encoders Qwen/Qwen3-8B-FP8 for 9b and mistralai/Mistral-Small-3.2-24B-Instruct-2506 for 32b (both Apache-2.0).

Speridlabs Iris-Z 出自 Speridlabs。 权重采用 Black Forest Labs 的 FLUX Non-Commercial License:不得用于商业或生产 用途,第 2(e) 条要求在分享生成图像之前进行内容过滤或人工审核。LibreYOLO 的适配器 采用 MIT 许可;从 Iris-Z SDK 移植的 transformer、采样器和提示词嵌入器保留 Apache-2.0 许可。

LibreYOLO 不再分发任何权重。它们在运行时从 speridlabs/iris-z 的固定 revision 原样下载,不需要申请访问。FLUX.2 VAE 来自采用 Apache-2.0 许可的 black-forest-labs/FLUX.2-klein-4B 仓库,文本编码器(9b 用 Qwen/Qwen3-8B-FP8, 32b 用 mistralai/Mistral-Small-3.2-24B-Instruct-2506)采用 Apache-2.0 许可。

引用

@article{canada2026irisz,
  title   = {Iris-Z: Scaling One Generative Model Past
             Specialist Geometry Models},
  author  = {Ca{\~n}ada, Alejandro and Garabito, Chema},
  journal = {arXiv preprint arXiv:2611.16010},
  year    = {2026},
  url     = {https://arxiv.org/abs/2611.16010}
}

复制自作者在 speridlabs.com/research/iris-z#citation 上提供的引用块。

已针对 LibreYOLO v1.8.0 验证。本页的支持表、检查点和基准测试数据由已发布的库和权重生成,并非手工编写。