curl --request POST \
  --url https://kaienapi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=qwen-image \
  --form 'prompt=把这张图转成 3D 平面风格' \
  --form image=https://example.com/source.png \
  --form mask='@example-file'

{
  "created": 123,
  "data": [
    {}
  ],
  "usage": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

编辑图片（不推荐）

不推荐调用

新接入不要使用本接口。参考图改图、换装、合成或多图创作统一推荐调用 POST /v1/images/generations/jobs，并把公网图片 URL 放入 JSON image 数组。gpt-image-2-2K 和 gpt-image-2-4K 不支持本接口。

本接口仅保留给必须使用 OpenAI multipart Images Edits 语义的旧客户端。

请求格式

使用 multipart/form-data。必须包含 model、prompt 和至少一张 image。

图片输入

可以传公网可访问的图片 URL，例如 OSS/CDN 地址。
大图建议先通过 OSS/CDN 图片处理 resize 到合适分辨率，再提交编辑请求。
需要多张网络 URL 做参考图创作、换装、合成或改图时，改用 /v1/images/generations/jobs 的 JSON image 数组，创建异步任务并轮询结果。

参数处理

prompt、size、quality、background、output_format 和模型扩展字段会随请求提交。多图参考时，在 prompt 中说明每张图片的用途。

错误定位

提示 image is required：确认请求里包含公网可访问的 image URL。
参考图无法读取：确认 URL 未过期、没有鉴权限制，且图片格式可被模型读取。
多图网络 URL 场景结果不符合预期：改用 /v1/images/generations/jobs 的 JSON image 数组。

POST

images

edits

curl --request POST \
  --url https://kaienapi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=qwen-image \
  --form 'prompt=把这张图转成 3D 平面风格' \
  --form image=https://example.com/source.png \
  --form mask='@example-file'

{
  "created": 123,
  "data": [
    {}
  ],
  "usage": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

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

Body

multipart/form-data

不推荐新接入使用。OpenAI Images Edits 兼容的 multipart 图片编辑请求，仅保留给必须使用 multipart 编辑语义的旧客户端。参考图创作、换装、合成或改图统一推荐使用 /v1/images/generations/jobs 的 JSON image 数组创建异步任务。gpt-image-2-2K 和 gpt-image-2-4K 不支持本接口。

model

string

required

图片编辑模型 ID，例如 qwen-image 或兼容编辑模型。

image

required

要编辑的图片 URL。使用 OSS/CDN 等公网可访问地址时，确保 URL 未过期且模型可读取。多图网络 URL 场景推荐改用 /v1/images/generations/jobs 的 JSON image 数组。

prompt

string

required

编辑指令。说明要保留什么、修改什么、输出风格和限制条件。

mask

file

遮罩图。透明区域表示允许修改的位置；常见要求为 PNG 格式，并与原图尺寸一致。

size

string

输出尺寸。可选值以模型说明为准；不确定尺寸时使用 auto 或模型页列出的尺寸。

Example:

"1024x1024"

Response

图片结果

created

integer

data

object[]

usage

object

查询异步图片生成任务创建异步图片编辑任务

开始使用

图片和视频

AI 工具接入

API Reference

编辑图片（不推荐）

不推荐调用

请求格式

图片输入

参数处理

错误定位

Authorizations

Body

Response