1. Grok Imagine Image 2.0 是什么
Grok Imagine Image 2.0（调用代号 grok-imagine-image-2.0）是 Grok Imagine 图片系列的 Image 2 版本型号，在基础文生图能力之上，突出多比例输出：由 aspect_ratio 参数直接决定成图画幅，让同一创意可以按渠道规格出图。
它的核心特点：
- 图片生成：文本提示词直出成图，同步返回结果。
- 多比例输出：横版 Banner、竖屏短视频封面、方图信息流可在同一模型内切换画幅产出。
- OpenAI 兼容网关：统一 Base URL 与
sk-codex789-前缀密钥，接入方式与其他 Grok 型号完全一致。
2. 多比例输出解决什么问题
传统做法是先出一张大图再人工裁切成各种尺寸，裁切过程容易破坏构图：主体被切边、文案区域错位、留白失衡。多比例输出的思路是按目标画幅重新生成而非机械裁切：
| 目标渠道 | 常用画幅 | aspect_ratio 写法示例 |
|---|---|---|
| 视频封面 / 网站 Banner | 横版宽幅 | 16:9 |
| 短视频封面 / Story | 竖屏全幅 | 9:16 |
| 信息流 / 社群贴图 | 方形 | 1:1 |
| 详情页配图 / 展示位 | 常规横竖版 | 如 4:3、3:4 |
目录价格为 ¥0.01/张，具体可售档位随模型负载与平台配置变化，以控制台说明为准；若传入暂不支持的比例，接口会返回相应错误提示，更换档位重试即可。
3. 适合哪些业务场景
多平台内容分发矩阵
同一场营销活动需要公众号头图、小红书封面、抖音竖屏图、朋友圈方图时，用一套提示词逐个画幅生成，保持视觉主题统一而规格各自达标。
广告投放素材适配
不同广告位对画幅要求不同，批量按位生成替代「一稿裁多处」，减少素材制作环节的人力消耗。
品牌视觉规范落地
把品牌色、风格关键词固化为提示词模板，各渠道取图时仅改画幅参数，降低执行层面的视觉漂移。
4. API 最小示例
curl https://www.codex789.com/v1/images/generations \
-H "Authorization: Bearer sk-codex789-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-2.0",
"prompt": "新中式茶饮品牌主视觉，水墨山水背景，留白充足",
"resolution": "2k",
"aspect_ratio": "9:16"
}'将 sk-codex789-your-api-key 替换为控制台生成的真实 Key。需要其他渠道素材时，保持 prompt 不变、仅替换 aspect_ratio 再次请求即可。更多用法参见Grok 图片生成 API 教程。
5. 同系列模型对比
| 模型 | 模型代号 | 定位 | 推荐场景 |
|---|---|---|---|
| Grok Imagine Image | grok-imagine-image | 快速出图 | 批量初稿、创意探索、高频迭代 |
| Grok Imagine Image Quality | grok-imagine-image-quality | 高质量生图 | 交付级主图、细节密集画面、图片编辑 |
| Grok Imagine Image 2.0 | grok-imagine-image-2.0 | 多比例输出版本 | 多平台画幅分发、投放素材适配 |
选型建议：单画幅快速迭代选标准版；追求成品细节选质量版；核心诉求是「一套创意、多种规格」时选本页 2.0 版。三个型号共用 Base URL 与鉴权，切换只改 model 参数。
6. 价格与计费说明
| 计费项 | 说明 |
|---|---|
| 计费单位 | 图片按张数计费，目录价格 ¥0.01/张，非 Token 计费 |
| 结算公式 | 单张目录价格为 ¥0.01/张，实际扣费受 API Key 等级与可售档位影响，以控制台实时展示为准 |
| 档位差异 | 不同分辨率与画幅档位单价可能不同，以控制台账单明细为准 |
| 用量查询 | 登录控制台查看张数与费用明细 |
成本控制技巧：多规格需求建议先用标准版小图确认构图方向，再用 2.0 版按最终画幅出正式图，避免每个比例都从零试错。
7. 常见问题
Grok Imagine Image 2.0 的调用代号是什么？
调用代号为 grok-imagine-image-2.0，URL 路径中的连字符写法为 grok-imagine-image-2-0，具体可用状态以控制台模型列表为准。
多比例输出是什么意思？
指通过 aspect_ratio 参数直接产出不同画幅的成图（如 16:9 横版、9:16 竖屏、1:1 方图），无需对同一张图做二次裁切，避免构图元素被切坏。
grok-imagine-image-2.0 和标准版 grok-imagine-image 有什么区别？
标准版定位快速出图，适合高频迭代；Image 2.0 是系列的新版本型号，能力标签为图片生成与多比例输出，适合需要一次产出多种画幅的分发场景。两者接口一致，切换只改 model 参数。
支持哪些画幅比例？
通过 aspect_ratio 参数指定常见宽高比（如 16:9、9:16、1:1 等），平台会处理常见比例，具体可用档位以当前模型负载和控制台说明为准。
Grok Imagine Image 2.0 如何接入？
将 Base URL 设置为 https://www.codex789.com/v1，使用平台 API Key 向 /v1/images/generations 提交请求，model 设为 grok-imagine-image-2.0，并通过 resolution 与 aspect_ratio 控制输出规格。