1. Grok Imagine Image 是什么
Grok Imagine Image（调用代号 grok-imagine-image）是 xAI Grok Imagine 图片系列的快速出图型号：输入文本提示词即刻返回成图，无需轮询等待，适合高频迭代与批量初稿场景。
它的核心特点：
- 文生图直出：同步接口一次请求返回结果，没有异步排队环节。
- 图片编辑：能力标签包含图片编辑，可基于参考图完成改背景、改风格类任务。
- 轻量参数：
resolution选 1k / 2k 两档，aspect_ratio指定画幅，上手零门槛。 - OpenAI 兼容：遵循 OpenAI Images 规范，现有 SDK 通常只改 Base URL、Key 与 model 即可运行。
2. 文生图与图片编辑两种模式
| 模式 | 端点 | 输入 | 典型用途 |
|---|---|---|---|
| 文生图 | /v1/images/generations | 提示词 + 分辨率 + 画幅 | 从零产出主图、封面、概念稿 |
| 图片编辑 | /v1/images/edits | 参考图 + 编辑指令 | 换背景、局部调整、风格迁移 |
两个模式共用同一套鉴权与 Base URL。编辑模式的参考图传参格式见Grok 图片生成 API 教程；若需要把静态图进一步做成视频，可在出图后接 grok-imagine-video-1.5 图生视频形成流水线。
3. 参数速查表
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 固定 grok-imagine-image |
prompt | string | 画面主体、风格、光影与构图描述，越具体越可控 |
resolution | string | 1k / 2k 两档，可用档位以控制台说明为准 |
aspect_ratio | string | 画幅比例（如 16:9），平台处理常见宽高比 |
提示词写法建议：按「主体 → 环境 → 风格 → 光影 → 用途」五段式组织描述，例如「无线降噪耳机，悬浮于深色磨砂背景，商业广告摄影风，柔和侧逆光，电商主图」，比单句描述的出图稳定性显著更高。
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",
"prompt": "夏日清爽饮料广告主图，水珠飞溅，高光通透",
"resolution": "1k",
"aspect_ratio": "16:9"
}'将 sk-codex789-your-api-key 替换为控制台生成的真实 Key。响应直接包含图片结果，无需轮询。基于参考图的编辑请求（/v1/images/edits）完整示例请参阅图片编辑章节。
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. 价格与计费说明
| 计费项 | 说明 |
|---|---|
| 计费单位 | 图片按张数计费，非 Token 计费 |
| 结算公式 | 单张成本 ≈ 目录基准价 × 模型倍率，受 API Key 等级影响，以控制台实时展示为准 |
| 档位差异 | 1k / 2k 档位单价可能不同，以控制台账单明细为准 |
| 用量查询 | 登录控制台查看张数与费用明细 |
7. 常见问题
Grok Imagine Image 的调用代号是什么？
调用代号为 grok-imagine-image，是 Grok Imagine 系列中的快速图片生成模型，具体可用状态以控制台模型列表为准。
支持哪些分辨率和画幅比例？
通过 resolution 参数选择 1k 或 2k 档位，通过 aspect_ratio 参数指定画幅比例（如 16:9），平台会处理常见宽高比，具体可用档位以当前模型负载和控制台说明为准。
能基于参考图做编辑吗？
支持。模型能力标签包含图片编辑，可通过 /v1/images/edits 接口附带参考图完成背景更换等编辑任务，完整请求示例见 Grok 图片生成 API 教程。
grok-imagine-image 和质量版 grok-imagine-image-quality 有什么区别？
grok-imagine-image 定位快速出图，适合草稿探索和批量初稿；grok-imagine-image-quality 定位高质量生图，适合交付级成品。推荐先用标准版筛选构图，再用质量版输出成品以控制成本。
是否兼容 OpenAI SDK？
兼容。接口路由和 JSON 结构遵循 OpenAI Images 规范，通常只需修改 Base URL、API Key 和 model 参数即可在现有 SDK 中调用。