# 创建异步图片编辑任务

`POST /v1/images/edits/jobs`

创建异步图片编辑任务。该接口立即返回任务 ID，后台继续执行 `/v1/images/edits` 图片编辑链路，适合需要图片编辑任务语义、且希望用轮询方式等待结果的场景。

## 图片输入
只支持公网可访问的网络 URL。请传入 OSS/CDN 图片 URL，不要使用 `@file` 文件形式。大图建议先使用 OSS/CDN 图片处理 resize 到合适分辨率后提交。

## URL 多参考图推荐
需要多张网络 URL 做参考图创作、换装、合成或改图时，推荐使用 `/v1/images/generations/jobs` 的 JSON `image` 数组。客户端保存返回的任务 ID，再轮询查询结果。

## 调用方式
- JSON：`image` 传公网 URL。
- multipart：`image` 作为普通表单 value 传 URL，不要使用 `@file` 文件形式。

## 状态流转
创建后返回 `queued`，后台执行时变为 `running`，完成后为 `succeeded` 并返回 `data`，失败后为 `failed` 并返回 `error.message`。

Tags: 图片生成