Skip to main content
grok-imagine-image 与 grok-imagine-image-quality 是 Grok Imagine 的旧型号图像模型,2026 年 8 月 13 日在老张API上线,目前仍可通过 Images API 调用;已有集成无需立即迁移。
  • 发布日期:2026 年 8 月 13 日
  • 最后核对:2026 年 9 月 24 日
  • 当前状态:有效(旧型号);具体可用分组和实时价格以控制台为准
价格调整: grok-imagine-image 上线时为 $0.02/张,2026 年 9 月 3 日起调整为 $0.025/张;grok-imagine-image-quality 仍为 $0.045/张。两款模型都按成功生成的图片张数计费。

关键事实

三个模型 ID 相互独立,不能混用:旧型号不带版本号,新款写作 grok-imagine-image-2.0(末尾有 .0)。 xAI 官方文档列出了更多宽高比,并使用自己的价格表;老张API为旧型号支持的比例只有上表 5 种,售价以老张API控制台和调用日志为准。 “单次最多 10 张”指 n 的输出图片数量,不是参考图输入上限。

谁适合继续使用旧型号

  • 已接入 grok-imagine-image 或 grok-imagine-image-quality,效果与成本满足要求的项目;
  • 需要一次提交 4 张参考图的工作流:旧标准模型支持 1–4 张,grok-imagine-image-2.0 最多 3 张;
  • 需要低单价草稿或批量候选图的任务。
依赖 4K、mask 局部重绘、任意像素尺寸或固定 seed 复现的流程,不应假设旧型号支持这些能力。需要 15 种固定宽高比等新能力时,请评估 grok-imagine-image-2.0。

如何调用

1

确认令牌分组与价格

打开控制台模型价格,确认目标令牌可见模型 ID 和当前单价。
2

选择标准或高质量模型

日常素材和 3–4 图组合使用 grok-imagine-image;成片或 1–2 图精细编辑可用 grok-imagine-image-quality 做同提示词小样对比。
3

先生成一张图片

先用 n=1 测试目标比例和分辨率,检查图片真实像素、内容、返回字段与扣费记录,再增加批量和并发。
最小文生图请求(下载图片需要安装 jq):
请求结构、Python SDK、参考图编辑与错误处理见 Grok Imagine Image API 接入指南;旧型号的宽高比与参考图数量以本页为准。

常见问题

旧型号的正确模型 ID 是什么?

grok-imagine-image 和 grok-imagine-image-quality,都不带版本号。新款模型是 grok-imagine-image-2.0,价格与参数范围不同,三者不能混用。

价格是每次请求还是每张图片?

按成功生成的图片张数计算,单价见页首的价格调整说明;n=10 时会产生最多 10 张的费用。实际扣费以控制台调用日志为准。

1K 与 2K 是否同价?

同一模型的 1K 与 2K 同价。价格可能调整,批量调用前请复核控制台。

为什么只列 5 种宽高比?

这 5 种是老张API为旧型号支持的比例。xAI 文档列出的其他比例不在旧型号的支持范围内;需要更多固定比例时,可评估支持 15 种固定宽高比的 grok-imagine-image-2.0。

参考图应该发到哪个端点?

使用 /v1/images/edits,并通过 multipart/form-data 上传:
  • 字段:单图字段可用 image,多图重复 image[]。
  • 数量:grok-imagine-image 支持 1–4 张,grok-imagine-image-quality 支持 1–2 张。
文生图仍使用 /v1/images/generations 的 JSON 请求。

旧型号需要迁移到 2.0 吗?

不需要立即迁移,旧型号仍可调用。需要 2.0 的新能力时,先用相同提示词各生成一张,比较质量与成本后再决定;依赖 4 张参考图的流程要注意 2.0 最多支持 3 张。

证据来源与相关文档