Skip to main content
POST
使用 gpt-image-2 和参考图片生成新图片。请求必须使用 multipart/form-data 上传图片文件。
使用 curl -F 或 SDK 的 multipart 功能时,不要手动设置 Content-Type。客户端需要自动生成包含 boundary 的请求头。

请求示例

请求参数

string
required
Bearer API Key,例如 Bearer sk-xxxxxxxx
string
default:"gpt-image-2"
required
固定填写 gpt-image-2
string
required
描述希望如何参考或修改上传的图片,并说明哪些内容需要保留。
file
required
参考图片文件。推荐使用 JPEG 或 PNG。
file
可选蒙版图片,用于局部重绘。建议与参考图片尺寸一致。
integer
default:"1"
生成图片数量。建议使用 1
string
default:"1024x1024"
输出尺寸,例如 1024x1024。实际支持的尺寸取决于当前渠道。
string
图片质量,例如 autostandardhigh。该参数可能因渠道不同而被忽略。
string
输入图片保真度,可传 lowhigh。是否生效取决于当前渠道。
string
期望的返回格式,可传 urlb64_json。客户端应同时兼容两种实际返回形式。

成功响应

响应结构与图像生成接口一致。
图片生成通常需要几十秒到数分钟。建议将客户端请求超时时间设置为至少 300 秒。