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

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

gpt-image-2-pro 用于提交高分辨率图像生成请求。请求体使用 JSON 格式,按模型名、提示词、输出尺寸和返回格式描述本次生成任务。
  • 请求路径为 POST /v1/images/generations
  • 通过 model = "gpt-image-2-pro" 选择目标模型。
  • prompt 描述要生成的图像内容。
  • size 传实际输出尺寸,例如 2048x20482560x17123840x2160
  • 支持 urlb64_json 两种返回格式。
  • 可在 JSON 中附带 image 作为参考图。

方法与路径

请求示例

响应示例

认证

Body

model
string
required
固定传 gpt-image-2-pro
prompt
string
required
生成提示词,用于描述想要生成的图片。
n
integer
生成数量。若不传或显式传 0,按 1 处理。
size
string
输出尺寸。常见值为 2048x20482048x15362560x17121712x25603840x21602160x3840
image
string | array<string> | object
可选参考图输入。常见写法是 Base64 字符串或 Base64 数组。
response_format
string
返回格式,常见值为 urlb64_json
quality
string
质量字段。是否真正生效取决于最终命中的渠道。
style
string | object
风格字段,原样透传给支持的上游。
background
string | object
背景控制字段,原样透传给支持的上游。
watermark
boolean
显式水印开关。false 与不传语义不同。

尺寸表

2K 档位

4K 档位

请求体中的 size 传“实际目标尺寸”这一列。

Response

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

异步调用

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

相关页面