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 起。一个独立的产品面,有自己的工厂和契约。
- 许可
- 代码采用 MIT and Apache-2.0,权重采用 FLUX Non-Commercial License。商用
安装
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)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 显存(库给出的数字) |
|---|---|---|---|---|
9b | speridlabs-iris-z、-9b、-small | 9.1B,基于 FLUX.2 [klein] Base 9B | Qwen3 8B FP8 | 约 18 GB,另加 9 GB 文本编码器和 0.2 GB VAE |
32b | speridlabs-iris-z-32b、-big | 32.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) 加载。
导出
| 任务 | ONNX | TorchScript | ExecuTorch | TensorRT | OpenVINO | Paddle | MNN | RKNN | Axelera | ncnn | TFLite | CoreML | Core AI |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Image generation | Image 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:不支持 |
| Depth | Depth 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 上提供的引用块。