22-图像生成使用教程#

重要：Gemini 图像模型和 gpt-image-2 的调用接口不同，不能混用。gpt-image-2 不支持 /v1/chat/completions。

分组说明：Gemini 图像模型放在 Gemini Image 分组；gpt-image-2 放在 GPT Image 分组。

一、Gemini 图像生成#

请求地址#

curl 示例#

Python 示例#

Python OpenAI SDK 默认不会直接透传部分非标准字段，建议把 resolution 和 aspect_ratio 放进 extra_body。

Node.js 示例#

参数说明#

分辨率与比例对照表#

响应格式#

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gemini-3.1-flash-image",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](data:image/jpeg;base64,/9j/4AAQ...)"
      },
      "finish_reason": "stop"
    }
  ]
}

提取 Gemini 图片#

二、GPT-image-2 图像生成#

生成图片请求地址#

curl 示例#

Python 示例#

Node.js 示例#

参数说明#

已验证尺寸#

gpt-image-2 当前不建议传 4096x4096。如果需要 4K，请使用 3840x2160 或其他最长边不超过 3840 的尺寸。

响应格式#

{
  "created": 1777516131,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ]
}

提取 GPT-image-2 图片#

三、GPT-image-2 图片编辑#

改图请求地址#

curl 示例#

四、两类模型的区别#

五、计费说明#

响应里的 usage.prompt_tokens、usage.completion_tokens 如有返回，仅作为兼容字段或透传记录，不代表实际计费方式。图像生成请以每次成功调用为准。

六、常见错误#

1. GPT-image-2 报错：only supported on /v1/images/generations and /v1/images/edits#

2. GPT-image-2 传 4096x4096 报错#

{
  "size": "3840x2160"
}

3. Gemini 传了 resolution 但没有生效#

4. 解析响应时报错#

七、超时建议#

八、选择建议#

九、完整调用对照#

Gemini：Chat Completions 生图#

{
  "model": "gemini-3.1-flash-image",
  "messages": [
    {
      "role": "user",
      "content": "一只橘色的猫坐在窗台上"
    }
  ],
  "resolution": "2K",
  "aspect_ratio": "1:1"
}

GPT-image-2：Images API 生图#

{
  "model": "gpt-image-2",
  "prompt": "一只橘色的猫坐在窗台上",
  "size": "2048x2048",
  "quality": "standard",
  "n": 1
}

GPT-image-2：Images API 改图#