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

# 编辑图像

`POST /api/ai/image/edit`

接口说明：同步编辑图像，基于参考图与指令进行编辑。

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

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

如已在使用 OpenAI SDK 或生态工具，可改用 OpenAI 兼容端点[「OpenAI 图像编辑」](/api-reference/post-api-ai-images-edits)。

## 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` ImageResponseVo
    - `created` number, required — 创建时间戳
    - `list` object[], required — 生成的图片列表
      - `url` string — 图片URL
      - `b64_json` string — base64编码的图片
      - `revised_prompt` string — 修订后的提示词
    - `usage` object — token使用情况
      - `input_tokens` number — 输入token数
      - `output_tokens` number — 输出token数
      - `total_tokens` number — 总token数
    - `background` string — 背景
    - `output_format` string — 输出格式
    - `quality` string — 质量档位
    - `size` string — 图片尺寸
  - `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)