curl --request POST \
--url https://kaienapi.com/v1/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form model=qwen-image \
--form 'prompt=把背景改成白色' \
--form image=https://example.com/source.png \
--form mask='@example-file'import requests
url = "https://kaienapi.com/v1/edits"
files = { "mask": ("example-file", open("example-file", "rb")) }
payload = {
"model": "qwen-image",
"prompt": "把背景改成白色",
"image": "https://example.com/source.png"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('model', 'qwen-image');
form.append('prompt', '把背景改成白色');
form.append('image', 'https://example.com/source.png');
form.append('mask', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://kaienapi.com/v1/edits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://kaienapi.com/v1/edits"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nqwen-image\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把背景改成白色\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\nhttps://example.com/source.png\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"created": 123,
"data": [
{}
],
"usage": {}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}图片编辑兼容别名
图片编辑的旧路径别名,行为与 /v1/images/edits 一致。
请求格式
使用 multipart/form-data,提交 model、prompt 和公网可访问的图片 URL。
兼容说明
本路径保留给仍调用旧地址的客户端。新接入优先使用异步任务;需要多张网络 URL 做参考图创作、换装、合成或改图时,推荐使用 /v1/images/generations/jobs 的 JSON image 数组。大图建议先通过 OSS/CDN 图片处理 resize 到合适分辨率。
读取结果
响应结构与图片编辑接口一致,可能返回图片 URL 或 base64。前端展示和结果保存逻辑可复用 /v1/images/edits 的处理方式。
curl --request POST \
--url https://kaienapi.com/v1/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form model=qwen-image \
--form 'prompt=把背景改成白色' \
--form image=https://example.com/source.png \
--form mask='@example-file'import requests
url = "https://kaienapi.com/v1/edits"
files = { "mask": ("example-file", open("example-file", "rb")) }
payload = {
"model": "qwen-image",
"prompt": "把背景改成白色",
"image": "https://example.com/source.png"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('model', 'qwen-image');
form.append('prompt', '把背景改成白色');
form.append('image', 'https://example.com/source.png');
form.append('mask', '{
"fileName": "example-file"
}');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://kaienapi.com/v1/edits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://kaienapi.com/v1/edits"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nqwen-image\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把背景改成白色\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"\r\n\r\nhttps://example.com/source.png\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"mask\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"created": 123,
"data": [
{}
],
"usage": {}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}Authorizations
在请求头中传入:Authorization: Bearer sk-...
Body
不推荐新接入使用。OpenAI Images Edits 兼容的 multipart 图片编辑请求,仅保留给必须使用 multipart 编辑语义的旧客户端。参考图创作、换装、合成或改图统一推荐使用 /v1/images/generations/jobs 的 JSON image 数组创建异步任务。gpt-image-2-2K 和 gpt-image-2-4K 不支持本接口。
图片编辑模型 ID,例如 qwen-image 或兼容编辑模型。
要编辑的图片 URL。使用 OSS/CDN 等公网可访问地址时,确保 URL 未过期且模型可读取。多图网络 URL 场景推荐改用 /v1/images/generations/jobs 的 JSON image 数组。
编辑指令。说明要保留什么、修改什么、输出风格和限制条件。
遮罩图。透明区域表示允许修改的位置;常见要求为 PNG 格式,并与原图尺寸一致。
输出尺寸。可选值以模型说明为准;不确定尺寸时使用 auto 或模型页列出的尺寸。
"1024x1024"