GPT 生成图像

使用 POST /v1/images/generations 调用 GPT 图像模型的统一生图入口；可选模型见下方「当前可用模型」。

POST /v1/images/generations

• 通过 选择目标模型。
• 支持 与 两种返回格式。
• 可在 JSON 中附带 作为参考图，是否生效取决于实际命中的图像渠道。
• 不传或显式传 时，统一层会回退为 。

当前可用模型

模型	说明
	GPT 图像生成统一入口当前可选模型

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：
	string	是	请求内容类型，必须设置为

请求体

名称	类型	必填	说明
	string	是	模型 ID，可选值见上方「当前可用模型」
	string	否	生成提示词。文生图语义下应视为必填
	integer	否	生成数量。若不传或显式传 ，统一层回退为
	string	否	输出尺寸。支持 （默认）与任意 ：宽、高均为 16 的倍数，宽高比在 –，最长边 ≤ ，总像素 –（超过 属实验性）。常见档位见下方表格
	string | array | object	否	可选参考图。常见写法是 Base64 字符串或 Base64 数组
	string	否	返回格式： /
	string	否	质量： / / / （默认）。是否真正生效取决于最终命中的渠道
	string | object	否	风格字段，原样透传给支持的上游
	string | object	否	背景控制。官方仅支持 / （默认），不支持
	string	否	输出格式：（默认）/ /
	integer	否	压缩级别 –；仅 / 时生效
	string	否	内容审核强度：（默认）/
	boolean	否	显式水印开关。 与不传语义不同

基础比例与尺寸档位

预设	实际目标尺寸

如果实际渠道不原生接受目标尺寸，网关或插件会回退到更接近的官方尺寸，并把比例意图附加到 prompt。

请求示例

curl -X POST https://octopusx.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张现代 API 平台首页插图，白底，青蓝色块，干净留白",
    "n": 1,
    "size": "1536x1024",
    "response_format": "url"
  }'

响应示例

200 - URL

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://example.com/images/img-abc123.png",
      "revised_prompt": "一张现代 API 平台首页插图，白底，青蓝色块，干净留白"
    }
  ]
}

200 - Base64

{
  "created": 1735689600,
  "data": [
    {
      "b64_json": "<BASE64_IMAGE_DATA>",
      "revised_prompt": "一张现代 API 平台首页插图，白底，青蓝色块，干净留白"
    }
  ]
}

响应字段

名称	类型	说明
	integer	生成时间戳
	array	生成结果数组
	string	为 时返回的图片 URL
	string	为 时返回的图片 Base64 数据
	string	部分上游会改写提示词并返回在此字段

相关接口

• 图像系列概览
• 错误码查询