POST
每张参考图片都必须填写模型服务可访问的公网 URL。你可以先调用 POST /v1/upload/presign 获取 public_url，也可以直接填写自己已有的公网 URL。模型接口不接收本地路径、Base64、multipart 文件体或预签名上传地址。

​
参考图片的两种来源

​
方式一：使用平台上传流程

1

申请上传地址

为每张图片调用 POST /v1/upload/presign。
2

上传参考图片

分别向返回的 url 发送 PUT 请求，并携带返回的 headers。
3

提交图片编辑

把每个 public_url 写入 images[].image_url，再调用本接口。
4

获取结果

直接读取 data[].url；如果返回任务 ID，则调用查询图片任务。

​
方式二：直接提供公网 URL

已有公网图片时，可跳过前两步，直接在 images[].image_url 中填写 URL：
URL 必须无需登录、无需 Cookie 或临时签名即可访问，并在任务执行期间保持有效。请确认模型服务所在网络可以访问该地址。 单图可用于背景替换、风格转换和局部重绘；多图可分别提供人物、服装、场景或风格参考。参考图片数量上限由目标模型决定。

授权

​
Authorization
string
header
必填

请求头格式：Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
model
string
必填

图片模型 ID，例如 gpt-image-2。实际值以 GET /v1/models 返回结果为准。

Minimum string length: 1
​
prompt
string
必填

图片生成或编辑指令。

Minimum string length: 1
​
images
object[]
必填

参考图片列表。每张图片都必须是模型服务可访问的公网 URL，可使用上传接口返回的 public_url，也可直接提供已有公网 URL。具体数量上限以目标模型为准。

Required array length: 1 - 15 elements
​
n
integer
默认值:1

生成图片数量。具体上限由目标模型决定。

必填范围: 1 <= x <= 10
​
size
enum<string>
默认值:2048x2048

输出像素尺寸。支持 1K、2K、4K 的 1:1、16:9、9:16、4:3、3:4、3:2、2:3 组合。

可用选项:
1024x1024,
1536x864,
864x1536,
1360x1024,
1024x1360,
1536x1024,
1024x1536,
2048x2048,
3072x1728,
1728x3072,
2720x2048,
2048x2720,
3072x2048,
2048x3072,
2880x2880,
3840x2160,
2160x3840,
3328x2496,
2496x3328,
3520x2336,
2336x3520
​
quality
enum<string>
默认值:auto

生成质量。除 auto 外的值是否生效由目标模型决定。

可用选项:
auto,
low,
medium,
high
​
output_format
enum<string>
默认值:jpeg

输出图片格式。

可用选项:
jpeg,
png,
webp
​
moderation
enum<string>
默认值:auto

内容审核强度。可用值由目标模型决定。

可用选项:
auto,
low
​
response_format
enum<string>
默认值:url

结果返回方式。当前文档统一使用公网 URL。

可用选项:
url

响应

同步编辑结果或异步任务信息

​
id
string

异步图片任务 ID。

​
task_id
string

部分实现使用的异步图片任务 ID 字段。

​
status
enum<string>
可用选项:
queued,
pending,
processing,
running,
succeeded,
completed,
failed,
cancelled,
expired
​
progress
number
必填范围: 0 <= x <= 100
​
created
integer

创建 Unix 时间戳，单位秒。

​
data
object[]
​
error
object | null