---
title: "异步编辑图像"
method: POST
path: "/api/ai/image/edit/async"
tags: ["AI 服务/图像生成"]
---

# 异步编辑图像

`POST /api/ai/image/edit/async`

接口说明：异步编辑图像，立即返回 logId，通过查询任务状态接口轮询结果。

调用本接口前，请先请求[「图像编辑模型」](/api-reference/get-api-ai-models-image-edit)接口（`GET /api/ai/models/image/edit`），获取当前可用的模型列表及各模型支持的尺寸、最大输入图片数与价格，再据此填写本接口参数。

图像编辑为**图生图**：必须传入参考图片 `image`，按提示词在其基础上修改、重绘。如需仅用文字生成全新图像（文生图），请使用[「异步生成图像」](/api-reference/post-api-ai-image-generate-async)接口。

## Request body

- object
  - `model` string, required — 图像编辑模型名称。先调用[「图像编辑模型」](/api-reference/get-api-ai-models-image-edit)接口（`GET /api/ai/models/image/edit`），传入其返回的 `data[n].name`；各模型支持的尺寸、最大输入图片数与价格以该接口返回为准。
  - `image` union, required — 原始图片
    - string
    - string[]
  - `prompt` string, required — 编辑描述
  - `mask` string — 遮罩图片 URL，用于**局部重绘**（可选）。需为与 `image` 尺寸一致的 PNG 图片：完全透明（alpha 为 0）的区域表示需要按提示词重绘的部分，不透明区域保持原图不变。不传时对整张图片进行编辑。
  - `n` integer — 生成图片数量
  - `size` string — 图像尺寸。可选值随模型而不同，以[「图像编辑模型」](/api-reference/get-api-ai-models-image-edit)接口返回的 `data[n].sizes` 为准；不同尺寸的价格不同，见 `data[n].pricing`。
  - `response_format` 'url' | 'b64_json' — 返回格式

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` AsyncTaskResponseVo
    - `logId` string, required — 任务日志ID
    - `status` 'generating' | 'success' | 'failed', required — 任务状态
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)