跳转到主要内容
POST
创建图像编辑

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

multipart/form-data
model
string
必填
image
必填
prompt
string
必填
models
string[]

在 model 之后按顺序尝试的可选回退模型。model 为必填项,且始终是主模型。当某次尝试以 429、500、502、503 或 504 失败时,会尝试下一项;其他错误按原样返回。最多接受 25 个模型 ID 或预设;重复项以及与 model 相同的项会被忽略。每次尝试都会作为独立请求进行验证、记录和计费,响应中的 model 字段和路由追踪会显示实际处理请求的模型。流式请求仅在发送第一个字节之前回退,视频和音乐任务仅在提交时回退。Batch、realtime 和 council 请求会拒绝 models。动态路由上设置的回退优先,且 phaseo/auto 不能与 models 一起使用。

Required array length: 1 - 25 elements
Minimum string length: 1
示例:
mask
string
markup
string

覆盖在第一张图像上的透明 PNG 标注层,可以是上传的文件、URL 或 base64 字符串。需要 GPT Image 2.5 或更高版本,且不能与 mask 同时使用。

complexity
enum<string>
可用选项:
low,
medium,
high
size
string
resolution
string
n
integer
必填范围: 1 <= x <= 10
quality
enum<string>

图像渲染质量。xhigh 和 max 仅适用于 GPT Image 2.5 模型。

可用选项:
standard,
low,
medium,
high,
xhigh,
max,
auto
stream
boolean
partial_images
integer
必填范围: 0 <= x <= 3
output_format
enum<string>
可用选项:
png,
jpeg,
webp
output_compression
integer
必填范围: 0 <= x <= 100
background
enum<string>
可用选项:
transparent,
opaque,
auto
moderation
enum<string>
可用选项:
auto,
low
input_fidelity
enum<string>
可用选项:
high,
low
user
string
meta
boolean
usage
boolean
provider
object

用于网关选择的提供商路由偏好设置。

响应

图像编辑响应

created
integer
data
object[]
最后修改于 2026年11月16日