Grok Imagine Image Quality API 中转

1. Grok Imagine Image Quality 是什么

Grok Imagine Image Quality（调用代号 grok-imagine-image-quality）是 Grok Imagine 图片系列中的质量型号：与快速出图的标准版相对应，它面向「确定构图后产出可交付成品」的环节，同时具备基于参考图的图片编辑能力。

它的核心特点：

• 高质量生图：面向交付场景优化画面细节与完成度，适合直接进入设计与投放环节的成图。
• 图片编辑：通过 /v1/images/edits 接口附带参考图，执行换背景、局部调整类任务。
• OpenAI 兼容网关：与其他 Grok 型号共用统一 Base URL 与鉴权，切换只改 model 参数。

2. 标准版还是质量版

推荐工作流（两段式）：第一阶段用标准版以低成本跑出十几张候选构图；第二阶段锁定满意的提示词与参数，交由本页质量版重新输出成品。这样探索阶段的张数消耗不占用成品档位预算，整体成本通常低于全程使用质量版。

3. 图片编辑：参考图改图

质量版的编辑能力走 /v1/images/edits 端点：请求中附带一张参考图和一段编辑指令，模型在保留原图主体的前提下完成指定修改。典型用法：

• 更换产品主图背景：保留商品主体，把杂乱实拍背景替换为干净的棚拍质感或场景化背景。
• 局部风格调整：对已有设计稿做色调、光影层面的重绘，而保持版式不变。
• 素材二次加工：为旧素材注入新季节、新场景元素，延长素材生命周期。

参考图的传参字段与更多约束见Grok 图片生成 API 教程的编辑章节。

4. 适合哪些业务场景

电商交付级主图

详情页首图、推广主图等需要经受放大检视的画面，用质量版输出减少细节瑕疵，降低返修率。

品牌视觉与印刷物料

海报、展架、包装提案等对质感要求高的物料初稿，质量版成图更接近最终印刷观感。

存量素材改造

利用图片编辑能力盘活已有实拍图库：换季、换背景、换氛围，无需重新拍摄即可批量出新版本。

5. 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-quality",
    "prompt": "高端腕表特写，金属拉丝纹理清晰，深色渐变背景，商业摄影级布光",
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }'

参考图编辑（换背景）

curl https://www.codex789.com/v1/images/edits \
  -H "Authorization: Bearer sk-codex789-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "更换产品主图背景，替换为简洁的大理石展台场景",
    "image": {"url": "https://example.com/product.png"}
  }'

将 sk-codex789-your-api-key 替换为控制台生成的真实 Key；image.url 填写需要编辑的原图地址。完整字段说明见图片编辑章节。

6. 价格与计费说明

由于质量版定位成品输出，建议配合上文两段式工作流使用：试错交给标准版，预算集中在质量版的关键出图上。

7. 常见问题