Ideogram 确实发布了可下载权重，但两个前提决定全部细节：公开的是量化版本而非全精度，并且默认只能非商用。这篇讲清楚 Hugging Face 上有什么、每档许可允许什么、自托管分几层，以及官方给出的命令。
Ideogram 到底发布了什么
2026 年 6 月 3 日，Ideogram 同时发布了推理代码与权重。官方说法很直接：放出权重是让研究社区一起往前推。GitHub README 称 Ideogram 4 为该公司首个开放权重的文生图模型，从零训练，而非对已有模型微调。
Hugging Face 上有什么
仓库的 Model Zoo 只列了两条，都需要先在 Hugging Face 上接受许可才能下载。
- Ideogram 4 (nf4)——93 亿参数，nf4 量化，支持硬件 CUDA，Diffusers 支持为「是」。
- Ideogram 4 (fp8)——93 亿参数，fp8 量化，支持硬件为「全部」，Diffusers 支持为「否」。
两条的许可一栏都写 Ideogram 4 Non-Commercial。README 说未来会支持更多量化格式。
官方没有公布什么
一手材料里没有任何权重体积数字，别处引用的体积属于引用者自己。显存或 GPU 下限也没给：Model Zoo 只说硬件类别。延迟与吞吐同样未公布。另外 docs.ideogram.ai 上根本没有自托管章节，那个路径返回官方 404 页。
三档许可各适合谁
许可页卖三条路，差别在模型访问级别，不在功能。
| 路径 | 模型访问 | 自托管 | 月产量 |
|---|---|---|---|
| 非商用 | 公开量化权重 | 仅限非商用 | 仅研究 |
| 自助商用 | 公开量化权重 | 可以 | 1 万–10 万张 |
| 企业 | 全精度 | 可以 | 10 万张或定制 |
自助商用按年付标价每月 300 美元、含 10,000 张图，明确不包含全精度权重、官方托管 API、实施支持与定制法律条款。全精度只有企业档才有。
协议允许你做什么
权重的约束来自 Ideogram Non-Commercial Model Agreement，更新于 2026 年 6 月 3 日。授权范围刻意收窄：只能在非商用目的下行使这些权利。范围仍然够用——营利公司在非生产环境里测试同样算非商用。输出是另一回事，Ideogram 声明不对输出主张权利。
微调与修改
非商用前提下，微调、LoRA 和修改都允许，许可页写得很直接。衍生模型在增量权利上归你，但再分发要带上同样的限制。
再分发与使用限制
再分发要求条款不得更宽松、随模型附上协议副本、在 NOTICE 文件里保留署名原文，并标注改过的文件。不得暗示衍生模型是 Ideogram 官方产品。禁止用途包括军事与监控、生物特征处理，以及金融、雇佣、医疗这类高风险决策。输出不得用来训练竞争模型。
自托管部署的三层结构
把自托管拆成三层看，因为每层的归属和适用许可都不一样。
第一层：权重
权重是官方、量化、带门禁的。先在模型页接受许可，再完成认证，否则下载会以 404 失败。这层带非商用许可，也是买自助商用后唯一会变的一层。
第二层：推理运行时
推理代码在 GitHub 上是 Apache 2.0，所以运行时本身宽松，尽管权重不是。pipeline 暴露 height、width、num_steps、guidance_scale、guidance_schedule、mu、std 和 seed，采样预设放在 ideogram4.sampler_configs.PRESETS。分辨率支持 256 到 2048、16 的倍数，宽高比最高 6:1。
第三层：API 层
一旦把模型暴露给别人，就离开了非商用授权。协议把「通过 API、网页访问或任何其他远程方式把模型或其功能作为托管服务提供」也算作分发，对外接口按许可页归企业档。如果走托管路线，Ideogram API 接入指南记录了各个端点，JSON 提示词指南覆盖了命令行需要的描述结构。
按文档跑起来
安装和认证两步，认证是为了让带门禁的权重能下载。
git clone https://github.com/ideogram-oss/ideogram4
cd ideogram4
pip install . # or: pip install -e . to edit src/ideogram4/
hf auth login # the weights are gated, so authenticate before the first run
export HF_TOKEN="hf_..." # alternative to hf auth login命令行路径
run_inference.py 会把普通提示词扩写成模型需要的结构化 JSON 描述。这个扩写默认走 Ideogram 的托管 magic prompt API，README 说它是免费的，所以需要一把 key。
python run_inference.py \
--prompt "a ginger cat wearing a tiny wizard hat reading a spellbook" \
--output out.png \
--quantization "nf4" \
--magic-prompt-key "$IDEOGRAM_API_KEY"想要最高质量，README 指明要放大画布并使用具名采样预设；安全筛查走 Hive，需要两把独立的 key。
python run_inference.py \
--prompt "an isometric illustration of a tiny city floating in the clouds" \
--output out.png \
--quantization "nf4" \
--height 2048 --width 2048 \
--sampler-preset V4_QUALITY_48 \
--magic-prompt-key "$IDEOGRAM_API_KEY" \
--hive-text-key "$HIVE_TEXT_MODERATION_KEY" \
--hive-visual-key "$HIVE_VISUAL_MODERATION_KEY"托管 API 路径
同一批模型也能直接走 HTTP，不用下载也不用显卡，这在许可挡住自托管时是最有用的对照。
API="https://api.ideogram.ai/v1/ideogram-v4/generate"
curl -s "${API}" \
-H "Api-Key: ${IDEOGRAM_API_KEY}" \
-F 'text_prompt=A poster on a wall with text that reads: "Everything you can imagine is real."' \
-F "resolution=1024x1024" \
-o generated.json
jq -r '.data[0].is_image_safe' generated.json
curl -sL -o poster.png "$(jq -r '.data[0].url' generated.json)"自托管还是用 API
决定因素有三个：许可、数据驻留、单位成本。自托管把提示词和输出留在自己的技术栈里，这正是许可页为数据驻留和延迟举的理由；托管 API 按张计费，不需要硬件。非商用研究看权重，商用自托管看自助商用档，对外的场景归企业档。只是需要定时出图的话，webhooks可能让自托管没必要；浏览器流程可对照教程。
常见问题
Ideogram 真的发布了权重吗？ 真的。nf4 与 fp8 两个量化版本，都是 93 亿参数，挂在 Hugging Face 上，适用 Ideogram Non-Commercial Model Agreement。全精度权重没有公开，属于企业档。
这些权重能商用吗？ 开源版本不行。自助商用档为同一批公开量化权重补上商用权利，按年付每月 300 美元。
需要多少显存？ 官方没有公布任何数字。Model Zoo 只给了硬件类别。
推理代码也受限吗？ 不受限。许可页把 GitHub 上的推理代码单列为 Apache 2.0，与权重许可分开。