通用接口

GPT Image 通用接口用于图片生成和图片修改：不传 image 时生成图片，传入 image 时根据 prompt 修改图片。

接口信息

项目	值
请求地址	`POST https://token.aiznt.com/v1/images/generations`
认证方式	Header `Authorization: Bearer sk-你的密钥`
Content-Type	`application/json`

生成图片

不传 image 参数即可生成图片：

{
  "model": "gpt-image-2",
  "prompt": "一只橘猫坐在未来城市的屋顶，电影灯光，写实摄影",
  "size": "2048x2048",
  "quality": "high",
  "n": 1,
  "response_format": "url"
}

修改图片

在同一个请求中加入 image 数组即可修改图片。image 中可以传入图片 URL 或 Base64 data URL：

{
  "model": "gpt-image-2",
  "prompt": "保留主体和构图，把背景改成夜晚的上海外滩",
  "size": "2048x2048",
  "quality": "high",
  "n": 1,
  "response_format": "url",
  "input_fidelity": "high",
  "image": [
    "https://example.com/source.png"
  ]
}

curl 示例

curl https://token.aiznt.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "保留主体和构图，把背景改成夜晚的上海外滩",
  "size": "2048x2048",
  "quality": "high",
  "n": 1,
  "response_format": "url",
  "input_fidelity": "high",
  "image": [
    "https://example.com/source.png"
  ]
}'

请求参数

参数	类型	必填	说明
`model`	string	是	GPT Image 模型 ID，以控制台可用模型为准。
`prompt`	string	是	图片生成或修改指令。
`image`	array	否	参考图片数组。支持图片 URL 或 Base64 data URL；传入时为图片修改，不传时为图片生成。
`input_fidelity`	`high` \| `low`	否	传入 `image` 时控制对输入图片的保真度。
`size`	string	否	输出尺寸，如 `1024x1024`、`1536x1024` 或 `2048x2048`。
`quality`	`low` \| `medium` \| `high` \| `auto`	否	图片质量。
`n`	integer	否	生成图片数量，范围 `1`–`10`。
`response_format`	`url` \| `b64_json`	否	选择返回 URL 或 Base64；仅在当前接口支持时传入。
`background`	`transparent` \| `opaque` \| `auto`	否	图片背景模式。
`output_format`	`png` \| `jpeg` \| `webp`	否	输出图片格式。
`output_compression`	integer	否	JPEG 或 WebP 压缩等级，范围 `0`–`100`。
`moderation`	`low` \| `auto`	否	内容审核级别。
`stream`	boolean	否	是否流式返回。
`user`	string	否	最终用户标识。

返回结果

图片生成和携带参考图使用相同的返回结构。使用 URL 返回模式时，图片地址位于 data[0].url。

{
  "created": 1787888579,
  "data": [
    {
      "b64_json": "",
      "revised_prompt": "",
      "url": "https://cdn.aiznt.com/relay-temp-images/20260828/b13c70b8-5e24-4936-a54f-d158aadf980a.jpg"
    }
  ]
}

字段	类型	说明
`created`	integer	响应创建时间的 Unix 时间戳，单位为秒
`data`	array	生成的图片结果列表
`data[].url`	string	生成图片的临时访问地址
`data[].b64_json`	string	Base64 图片数据；URL 返回模式下通常为空字符串
`data[].revised_prompt`	string	服务端修订后的提示词；未提供时通常为空字符串

当使用 Base64 返回模式时，从 data[].b64_json 读取图片数据。每个结果通常只包含一种有效的图片数据字段，请以实际响应为准。

临时图片地址

建议获取响应后及时下载并保存 url 指向的图片，不要将临时地址作为长期存储地址。