图像生成 · gpt-image-2

通过 Astra API 调用图像生成 / 编辑 / 客户端集成。前置准备见 接入前准备，另外确认控制台首页里你当前等级已开启 gpt-image-2，没开的话先让管理员调一下。

没有单独的 Sora 分组令牌，直接用你在 /settings 创建的 sk- API Key。

调用接口

Images API（推荐）

OpenAI 兼容的 Images API，推荐用这个。

POST https://api.637274.xyz/v1/images/generations

请求示例：

curl https://api.637274.xyz/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张未来感产品海报，深色背景，金属质感，商业摄影风格",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

response_format 支持两种值：

• url：返回 data[0].url，值是 https://images-generations.637274.xyz/... 这样的图片链接
• b64_json：返回 data[0].b64_json，值是裸 base64

常用参数：

尺寸建议：

如果上游拒绝尺寸，优先改成 1024x1024 做连通性测试。

图片编辑

OpenAI 兼容的 Images Edits API，适合上传参考图、局部修改、图生图。

POST https://api.637274.xyz/v1/images/edits

请求示例：

curl https://api.637274.xyz/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "model=gpt-image-2" \
  -F "image=@input.png" \
  -F "prompt=保留主体构图，改成夜间霓虹灯商业海报风格" \
  -F "size=1024x1024" \
  -F "quality=high"

gpt-image-2 只支持 /v1/images/generations 和 /v1/images/edits，不能走 /v1/chat/completions。客户端必须用「图像生成」端点类型，别按普通对话模型配置。

客户端集成

Cherry Studio

按 OpenAI 图片接口配置：

使用建议：

• 如果模型列表没有 gpt-image-2，先确认当前用户等级是否开启该模型
• 文生图使用绘图模式，上传参考图或局部修改使用编辑模式
• 端点类型务必选「图像生成」，不要选普通对话——gpt-image-2 不支持 Chat Completions

常见错误

通用错误（401/403/404 等）见 故障排查。下表只列图像 API 特有的：