Skip to main content
POST
使用 gpt-image-2.5 调用同步图像生成接口。请求会保持 HTTP 连接,直到图片生成完成并返回结果。客户端超时建议设置为至少 300 秒。

请求示例

请求参数

string
required
Bearer Token,例如 Authorization: Bearer YOUR_API_KEY。你可以在 API Key 管理页面 创建密钥。
string
default:"gpt-image-2.5"
required
固定填写 gpt-image-2.5
string
required
图片内容描述。支持中文和英文。建议清晰描述主体、环境、构图和风格。
string
default:"1024x1024"
输出尺寸必须使用下方列出的支持值。
string
default:"auto"
图片质量。可选值为 autolowmediumhigh
integer
default:"1"
生成数量。
string
default:"url"
返回格式。建议填写 url

支持尺寸

size 仅支持以下尺寸:

成功响应

data[0].url 读取生成图片。图片 URL 可能具有有效期,请及时下载并保存到自己的存储服务。

注意事项

  • 同步请求通常需要几十秒,客户端超时建议至少为 300 秒。
  • 图片尺寸必须使用本文列出的值。
  • 生产环境应检查 HTTP 状态码,并在图片生成完成后及时转存。
  • 不能保持长连接的业务请使用 GPT Image 2.5 异步图像生成