mingyan
GPT Image 2 - 创建任务
创建 GPT Image 2 图片生成任务，支持多种画质、比例和分辨率选项
创建图片生成任务
使用 GPT Image 2 API 创建高质量的 AI 图片生成任务，支持多种画质档位、宽高比和分辨率选项。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelstring必填模型名称
可选值：
gpt-image-2- 标准模型，按画质计费gpt-image-2-r- 分辨率模型，按分辨率计费gpt-image-2-async- 按次计费image2-pro-async- 按次计费
promptstring必填图片生成提示词
示例：
"一只可爱的橙色猫咪坐在窗台上看着外面的风景"qualitystring画质档位，默认为
low。支持的模型：gpt-image-2可选值：
low- 低画质medium- 中画质high- 高画质
ratiostring宽高比设置，使用
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- 超长竖
resolutionstring分辨率设置，默认为
1k，与 size 二选一传入即可。使用 resolution 时必须同时传入 ratio可选值：
1k- 1K 分辨率2k- 2K 分辨率（仅gpt-image-2）4k- 4K 分辨率（仅gpt-image-2）
gpt-image-2-r 仅支持 1k 分辨率。4K 仅支持 6 个比例：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21，其它比例 + 4K 因总像素超上限不可用。sizestring尺寸设置。传入
size 后，resolution 和 ratio 可不传。若同时传入 size 和 resolution，以 size 为准建议值：
1024x1024- 正方形1536x1024- 横屏1024x1536- 竖屏2048x2048- 2K 正方形2048x1152- 2K 横屏3840x2160- 4K 横屏2160x3840- 4K 竖屏
尺寸规则：
- 最大边长必须小于或等于 3840px
- 两条边必须是 16px 的倍数
- 长边与短边的比例不得超过 3:1
- 总像素数必须至少为 655,360 个，不超过 8,294,400 个
gpt-image-2-async 仅支持 1024x1024、1536x1024、1024x1536。image_urlsarray参考图片URL数组，用于指导图片生成风格
gpt-image-2- 最多 6 张gpt-image-2-r- 最多 16 张gpt-image-2-async- 最多 6 张image2-pro-async- 最多 6 张
响应参数
idstring图片生成任务的唯一标识符，用于后续查询任务状态
objectstring对象类型，固定为
imagecreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中
errorstring错误信息，当 status 为
failed 时返回画质档位说明
low
低画质，快速生成，适合草稿预览
medium
中画质，平衡速度与质量，适合一般用途
high
高画质，最高质量，适合精细创作
注意事项
重要提示：
- 图片生成为异步处理，需要通过返回的
id查询任务状态和结果 - 传入
size时，resolution和ratio可不传 - 传入
resolution时，必须同时传入ratio（默认1:1） - 若同时传入
size和resolution，以size为准 - 建议轮询间隔为 2-5 秒，避免频繁请求
最佳实践：
- 使用
application/json格式发送请求 - 提示词应该清晰描述所需的图片内容和风格
- 参考图片可以帮助指导生成风格，但不是必需的
- 选择合适的宽高比或尺寸以匹配你的使用场景