POST
创建异步图片编辑任务

授权

Authorization
string
header
必填

在请求头中传入:Authorization: Bearer sk-...

请求体

异步图片编辑任务请求,支持 JSON 或 multipart/form-data。JSON 参考图可使用公网 URL、Base64 Data URL 或标准 Base64,通过 image 或 images 数组提交;Base64 会流式上传到临时图片存储,再以 URL 执行任务。multipart 参考图字段保留原有 URL 调用方式。新接入多参考图创作、换装、合成或改图仍推荐 /v1/images/generations/jobs。

model
string
必填

图片编辑模型 ID,例如 qwen-image-edit。

prompt
string
必填

编辑指令。多图参考时说明图 1、图 2、图 3 各自用途。

image
必填

公网图片 URL 或 JSON 请求中的 Base64 图片,可传单个字符串或数组。Base64 支持 PNG、JPEG、WebP、GIF,推荐携带 data:image/...;base64,... 前缀。multipart/form-data 调用时使用普通 URL value,也可以重复传 image[] 字段。不要同时传 images。

images
any
size
string

输出尺寸。按模型支持范围填写。

示例:

"960x1280"

quality
string

输出质量。按模型支持范围填写。

示例:

"standard"

响应

任务已创建

id
string
必填
示例:

"imgtask-..."

object
string
必填
示例:

"image.edit.job"

status
enum<string>
必填
可用选项:
queued,
running,
succeeded,
failed
created
integer
必填

Unix 秒级时间戳。

updated
integer
必填

Unix 秒级时间戳。

model
string
started_at
integer | null
completed_at
integer | null
reference_urls
string<uri>[]
data
object[]

任务成功后返回图片结果,结构与 Images 响应 data 数组一致。

error
object | null