跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
image2
/
images
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/image2/images \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的橙色猫咪坐在窗台上看着外面的风景",
    "quality": "high",
    "ratio": "16:9",
    "resolution": "2k",
    "image_urls": []
  }'

{
  "id": "image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "image",
  "created": 1774836724,
  "model": "gpt-image-2",
  "status": "queued",
  "error": null
}

​
创建图片生成任务

使用 GPT Image 2 API 创建高质量的 AI 图片生成任务，支持多种画质档位、宽高比和分辨率选项。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
请求参数

​
model
string
必填
模型名称，固定为 gpt-image-2
​
prompt
string
必填
图片生成提示词示例："一只可爱的橙色猫咪坐在窗台上看着外面的风景"
​
quality
string
默认值:"low"
画质档位，默认为 low可选值：
  • low - 低画质
  • medium - 中画质
  • high - 高画质
​
ratio
string
默认值:"1:1"
宽高比设置，使用 resolution 时必须传入，默认 1:1可选值：
  • 1:1 - 正方形（默认）
  • 16:9 - 宽屏横
  • 9:16 - 宽屏竖
  • 4:3 - 标屏横
  • 3:4 - 标屏竖
  • 3:2 - 经典横
  • 2:3 - 经典竖
  • 5:4 - 近方横
  • 4:5 - 近方竖
  • 2:1 - 宽横
  • 1:2 - 长竖
  • 21:9 - 超宽横
  • 9:21 - 超长竖
​
resolution
string
分辨率设置，与 size 二选一传入即可。使用 resolution 时必须同时传入 ratio可选值：
  • 1k - 1K 分辨率
  • 2k - 2K 分辨率
  • 4k - 4K 分辨率
​
size
string
尺寸设置。传入 size 后，resolution 和 ratio 可不传。若同时传入 size 和 resolution，以 size 为准可选值：
  • 1024x1024 - 正方形
  • 1536x1024 - 横屏
  • 1024x1536 - 竖屏
  • 2048x2048 - 2K 正方形
  • 2048x1152 - 2K 横屏
  • 3840x2160 - 4K 横屏
  • 2160x3840 - 4K 竖屏
​
image_urls
array
参考图片URL数组，用于指导图片生成风格

​
响应参数

​
id
string
图片生成任务的唯一标识符，用于后续查询任务状态
​
object
string
对象类型，固定为 image
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
​
error
string
错误信息，当 status 为 failed 时返回

​
画质档位说明

low

低画质，快速生成，适合草稿预览

medium

中画质，平衡速度与质量，适合一般用途

high

高画质，最高质量，适合精细创作

​
注意事项

重要提示：
  • 图片生成为异步处理，需要通过返回的 id 查询任务状态和结果
  • 传入 size 时，resolution 和 ratio 可不传
  • 传入 resolution 时，必须同时传入 ratio（默认 1:1）
  • 若同时传入 size 和 resolution，以 size 为准
  • 建议轮询间隔为 2-5 秒，避免频繁请求
最佳实践：
  1. 使用 application/json 格式发送请求
  2. 提示词应该清晰描述所需的图片内容和风格
  3. 参考图片可以帮助指导生成风格，但不是必需的
  4. 选择合适的宽高比或尺寸以匹配你的使用场景
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/image2/images \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的橙色猫咪坐在窗台上看着外面的风景",
    "quality": "high",
    "ratio": "16:9",
    "resolution": "2k",
    "image_urls": []
  }'

{
  "id": "image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "image",
  "created": 1774836724,
  "model": "gpt-image-2",
  "status": "queued",
  "error": null
}