Skip to main content
POST
使用 gpt-image-2.5 根据一张或多张参考图片生成新图片。参考图片通过 images 数组传入,支持单张和多张图片。

请求示例

请求参数

Header 参数

string
Bearer Token,例如 Authorization: Bearer YOUR_API_KEY。你可以在 API Key 管理页面 创建密钥。
string
default:"application/json"
请求体格式。请使用 application/json。

Body 参数

string
default:"gpt-image-2.5"
required
模型名。固定填写 gpt-image-2.5。
string
required
图像编辑提示词,例如需要替换、添加、删除或修改的内容。
string
default:"1024x1024"
输出图片尺寸。支持的尺寸见下方的支持尺寸列表。
string
default:"url"
返回图片格式。目前仅支持 url。
array[string]
required
参考图片 URL 数组,支持传入单张或多张图片。图片 URL 必须可以被服务端访问。
integer
default:"1"
生成数量,范围为 1 到 4。

支持尺寸

gpt-image-2.5 支持以下 size 值:

成功响应

从 data[0].url 读取生成图片。使用 n 大于 1 时,遍历 data 数组读取全部结果。图片 URL 可能具有有效期,请及时下载并保存到自己的存储服务。

注意事项

  • images 至少需要包含一个图片 URL,也可以同时传入多张参考图片。
  • 图片 URL 必须可以被 Xcompute 服务端访问,不能使用仅本机可访问的地址。
  • response_format 目前仅支持 url。
  • n 的取值范围为 1 到 4。
  • 图片尺寸必须使用本文列出的值。