Skip to main content
POST
gpt-image-2-vip 生成图像 API

gpt-image-2-vip 生成图像 API

gpt-image-2-vip 用于提交 VIP 图像生成请求。请求体使用 JSON 格式,按模型名、提示词、输出尺寸和返回格式描述本次生成任务。
  • 请求路径为 POST /v1/images/generations
  • 通过 model = "gpt-image-2-vip" 选择目标模型。
  • prompt 描述要生成的图像内容。
  • size 传实际输出尺寸,例如 2560x14403504x23363808x1632
  • 每条边必须是 16px 的倍数,最长边不超过 3840px
  • 长短边比例不超过 3:1,总像素数必须在 655,3608,294,400 之间。
  • 可在 JSON 中附带 image 作为参考图。

方法与路径

请求示例

响应示例

认证

Body

model
string
required
固定传 gpt-image-2-vip
prompt
string
required
生成提示词,用于描述想要生成的图片。
n
integer
生成数量。若不传或显式传 0,按 1 处理。
size
string
required
输出尺寸,使用 WxH 格式,例如 2048x20482560x14403504x23363808x1632。VIP 尺寸必须满足下方约束。
image
string | array<string> | object
可选参考图输入。常见写法是 Base64 字符串或 Base64 数组,适合需要图像风格参考的渠道。
quality
string
质量字段。常见值为 lowmediumhighauto,是否真正生效取决于最终命中的渠道。
response_format
string
返回格式字段。VIP 通道建议不传该字段,由通道返回 urlb64_json;若传入,是否生效取决于实际命中的渠道。
style
string | object
风格字段,原样透传给支持的上游。
background
string | object
背景控制字段,原样透传给支持的上游。
watermark
boolean
显式水印开关。false 与不传语义不同。

尺寸约束

size 必须同时满足:

尺寸表

接口请求体中的 size 传“实际目标尺寸”这一列。1K2K4K 是业务侧常用预设分组。

1K 档位

2K 档位

4K 档位

如果你按比例预设做业务封装,请先映射为上表中的实际 WxH 尺寸再提交请求。

Response

created
integer
生成时间戳。
data[].url
string
返回 URL 时的图片地址。
data[].b64_json
string
返回 Base64 时的图片数据。
data[].revised_prompt
string
部分上游会改写提示词并返回在这个字段里。

异步调用

如需提交后异步查询结果,可以使用图像异步生成入口:
异步请求仍传 model = "gpt-image-2-vip"size 仍需满足本页列出的尺寸约束。提交成功后读取返回的 id / task_id,再通过 GET /v1/images/generations/async/{taskId} 查询状态和结果。

相关页面