Skip to main content
POST
Gpt image 2

授权

Authorization
string
header
必填

API密钥认证,请在请求头中包含Authorization字段

请求体

multipart/form-data
model
enum<string>
必填

GPT Image 2 模型及输出分辨率档位

可用选项:
gpt-image-2,
gpt-image-2-2k,
gpt-image-2-4k
示例:

"gpt-image-2"

prompt
string
必填

图片生成或编辑指令

Maximum string length: 32000
示例:

"在简洁的影棚背景中生成一张高品质商品图"

size
string

文生图的输出画幅。支持 auto,以及 1:1、4:3、3:4、3:2、2:3、16:9、9:16、21:9、5:4、4:5,也可以传 1920x1080、512x512 等常见 WxH 像素尺寸。图生图请传 1024x1024 等 WxH 像素尺寸。交付尺寸由所选模型档位决定。

示例:

"16:9"

n
integer
默认值:1

生成图片数量

必填范围: 1 <= x <= 10
image
file[]

图生图的可选参考图。传多张图片时重复提交 image 字段;支持 PNG、WebP、JPG 和 JPEG。上传文件与 imageUrl 中的图片总数不能超过 16。

Maximum array length: 16
imageUrl
string

图生图的可选参考图 URL。多个 URL 使用英文逗号分隔;上传文件与 URL 中的图片总数不能超过 16。

mask
file

图生图的可选 PNG 蒙版。至少需要同时传一张参考图,尺寸须与第一张参考图一致;透明区域会被编辑,非透明区域会被保留。

响应

200 - application/json

任务创建成功

通用响应

code
integer
必填

响应状态码:1000=成功,9999=失败,9000=积分不足

msg
string
必填

响应消息

data
object
必填

通用数据响应