图片编辑 API 参考

图片编辑：根据指令编辑一张参考图

curl --request POST \
  --url https://api.apiyi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=MAI-Image-2.6-Flash \
  --form 'prompt=把茶壶改成深钴蓝釉，其余部分完全保持不变' \
  --form 'image=@example-file;type=image/png'

import requests

url = "https://api.apiyi.com/v1/images/edits"

files = { "image": ("example-file", open("example-file", "rb"), "image/png") }
payload = {
    "model": "MAI-Image-2.6-Flash",
    "prompt": "把茶壶改成深钴蓝釉，其余部分完全保持不变"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'MAI-Image-2.6-Flash');
form.append('prompt', '把茶壶改成深钴蓝釉，其余部分完全保持不变');
form.append('image', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.apiyi.com/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apiyi.com/v1/images/edits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apiyi.com/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\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))

}

HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apiyi.com/v1/images/edits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "created": 1791000788,
  "data": [
    {
      "b64_json": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 1000,
    "total_tokens": 1000
  }
}

POST

images

edits

图片编辑：根据指令编辑一张参考图

curl --request POST \
  --url https://api.apiyi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=MAI-Image-2.6-Flash \
  --form 'prompt=把茶壶改成深钴蓝釉，其余部分完全保持不变' \
  --form 'image=@example-file;type=image/png'

import requests

url = "https://api.apiyi.com/v1/images/edits"

files = { "image": ("example-file", open("example-file", "rb"), "image/png") }
payload = {
    "model": "MAI-Image-2.6-Flash",
    "prompt": "把茶壶改成深钴蓝釉，其余部分完全保持不变"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('model', 'MAI-Image-2.6-Flash');
form.append('prompt', '把茶壶改成深钴蓝釉，其余部分完全保持不变');
form.append('image', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.apiyi.com/v1/images/edits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apiyi.com/v1/images/edits",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apiyi.com/v1/images/edits"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\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))

}

HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/edits")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apiyi.com/v1/images/edits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model\"\r\n\r\nMAI-Image-2.6-Flash\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prompt\"\r\n\r\n把茶壶改成深钴蓝釉，其余部分完全保持不变\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image\"; filename=\"example-file\"\r\nContent-Type: image/png\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "created": 1791000788,
  "data": [
    {
      "b64_json": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 1000,
    "total_tokens": 1000
  }
}

右侧的交互式 Playground 支持直接上传本地图片。请在 Authorization 中填入你的 API Key（格式：Bearer sk-xxx），选择 image 文件并填入 prompt、model 后一键发送即可。

🔴 本接口只接受 multipart/form-data 文件上传发送 JSON 到 /v1/images/edits（image 填 URL、data URI 或裸 base64）会返回 400：

request Content-Type isn't multipart/form-data

不支持图片 URL 入参。手上只有 URL 时，请先在服务端下载成文件再上传。文件上传不需要图床，直接传本地文件即可。

场景说明：本页用于「基于一张参考图改图」。如需纯文本生成图片，请使用文生图接口。

⚠️ 多图融合暂不可用，目前每次只支持 1 张参考图请只传一个 image 文件字段。目前传第二张参考图不会生效：

image + image2：返回 200，但只有第一张图生效，第二张被忽略，照常计费
image 同名重复、image[] 重复：返回 400 File must be attached in a form field with a name starting with 'image'

OpenAI SDK 的 client.images.edit(image=[f1, f2]) 多图写法同样不可用。多图融合恢复后我们会更新本页。

参数红线与文生图相同：不要传 response_format、seed、negative_prompt（返回 400）。返回值固定为 data[0].b64_json（PNG）。

代码示例

Python（OpenAI SDK · 单图编辑）

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.apiyi.com/v1",
    timeout=180.0
)

# SDK 的 images.edit 内部就是 multipart 文件上传；不要传 response_format
resp = client.images.edit(
    model="MAI-Image-2.6-Flash",
    image=open("teaset.jpg", "rb"),
    prompt="Change the teapot to a deep cobalt blue glaze, keep everything else identical"
)

with open("edited.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

Python（原生 requests · 单图编辑）

import base64
import os
import requests

# 用 files= 传文件，requests 会自动设置 multipart/form-data 及 boundary
# 不要用 json=，也不要手动设 Content-Type
with open("teaset.jpg", "rb") as fp:
    response = requests.post(
        "https://api.apiyi.com/v1/images/edits",
        headers={"Authorization": f"Bearer {os.environ['APIYI_API_KEY']}"},
        data={
            "model": "MAI-Image-2.6",
            "prompt": "把茶壶改成深钴蓝釉，其余部分完全保持不变"
        },
        files={"image": ("teaset.jpg", fp, "image/jpeg")},
        timeout=180
    )
response.raise_for_status()

with open("edited.png", "wb") as f:
    f.write(base64.b64decode(response.json()["data"][0]["b64_json"]))

cURL

# 单图编辑：-F 即 multipart/form-data，@ 前缀表示上传本地文件
curl -X POST "https://api.apiyi.com/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=MAI-Image-2.6-Flash" \
  -F "prompt=把茶壶改成深钴蓝釉，其余部分完全保持不变" \
  -F "image=@teaset.jpg" \
  | python3 -c "import sys,json,base64; open('edited.png','wb').write(base64.b64decode(json.load(sys.stdin)['data'][0]['b64_json']))"

# 编辑时改画幅为 1536×1024（与原图比例不同会重新构图）
curl -X POST "https://api.apiyi.com/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=MAI-Image-2.6" \
  -F "prompt=把这张茶具图改成摆在木桌上的生活场景，自然光，写实摄影" \
  -F "width=1536" \
  -F "height=1024" \
  -F "image=@teaset.jpg"

Node.js（原生 fetch + FormData）

import fs from 'node:fs';

const form = new FormData();
form.append('model', 'MAI-Image-2.6-Flash');
form.append('prompt', '把背景换成雪夜的松林，保持人物不变');
form.append('image', new Blob([fs.readFileSync('./photo.jpg')]), 'photo.jpg');

const resp = await fetch('https://api.apiyi.com/v1/images/edits', {
    method: 'POST',
    // 不要手动设 Content-Type，交给 FormData 自动带 boundary
    headers: { 'Authorization': `Bearer ${process.env.APIYI_API_KEY}` },
    body: form,
    signal: AbortSignal.timeout(120000)
});

const data = await resp.json();
fs.writeFileSync('edited.png', Buffer.from(data.data[0].b64_json, 'base64'));

参数说明速查

参数名	类型	必填	默认	说明
`model`	string	✅	—	`MAI-Image-2.6`（$0.12/张）或 `MAI-Image-2.6-Flash`（$0.06/张），大小写敏感
`prompt`	string	✅	—	编辑指令。建议写明「改什么」并声明「其余保持不变」
`image`	file	✅	—	参考图文件，目前只支持 1 张
`width` / `height`	integer	❌	跟随原图比例	指定输出尺寸，规则同文生图；与原图比例不同时会重新构图
`n`	integer	❌	`1`	出图张数，本端点有效，按张计费
~~`mask`~~	—	—	—	不支持，传入返回 400
~~`response_format`~~ / ~~`seed`~~ / ~~`negative_prompt`~~	—	—	—	传入返回 400

不传尺寸时的输出：按原图比例贴合到 16 的倍数网格，例如 1344×756 的输入输出 1360×768。只想改局部、不想动构图时，不要传 width / height。

编辑效果与提示词写法

编辑接口会保留原图的构图、配色与细节，只改提示词指定的部分：

写法	效果
✅ `把茶壶改成深钴蓝釉，其余部分完全保持不变`	只有茶壶变色，尺寸标注、其它物件逐像素保留
✅ `把这张照片改成水彩画风格，构图不变`	风格整体重绘，构图保持
⚠️ `让它更好看一点`	指令过于笼统，改动范围不可控

**显式声明「其余保持不变」**是这个模型上最有效的技巧，能最大限度保留原图。

响应格式

{
  "created": 1791000788,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zU..."
    }
  ],
  "usage": {
    "prompt_tokens": 1000,
    "total_tokens": 1000,
    "input_tokens": 1000,
    "output_tokens": 0
  }
}

响应字段说明

b64_json 是纯 base64，不带 data: 前缀，解码后为 PNG。
n > 1 时 data 数组有多项，别只取 data[0]。
不返回 url 与 revised_prompt。

usage 不能用来核账：是占位值（prompt_tokens 恒为 1000 × 张数）。编辑与文生图同价，按张固定计费，真实扣费请以 API易控制台账单为准。

授权

Authorization

string

header

必填

在 API易控制台获取的 API Key

请求体

multipart/form-data

model

enum<string>

默认值:MAI-Image-2.6-Flash

必填

模型 ID（大小写敏感）

可用选项:

MAI-Image-2.6-Flash,

MAI-Image-2.6

prompt

string

必填

编辑指令。建议明确「改什么」并声明「其余保持不变」

示例:

"把茶壶改成深钴蓝釉，其余部分完全保持不变"

image

file

必填

参考图文件，目前只支持 1 张。格式 png / jpg / webp

width

integer

可选，输出宽度。规则同文生图：每维 ≥ 768、宽×高 ≤ 2,359,296，须与 height 成对

必填范围: x >= 768

height

integer

可选，输出高度，规则同 width

必填范围: x >= 768

integer

默认值:1

出图张数，本端点有效，按张计费

必填范围: x >= 1

示例:

1

响应

成功生成图片

created

integer

创建时间戳

示例:

1791000788

data

object[]

图片结果数组，长度等于 n

Show child attributes

usage

object

占位值，不能用于核账。 prompt_tokens 恒为 1000 × 张数

Show child attributes

产品基础

基础 API

图片 API（官转）

视频 API（官转）

多模态理解 API

文本生成

音频 API（官转）

检索与安全

代码示例

Python（OpenAI SDK · 单图编辑）

Python（原生 requests · 单图编辑）

cURL

Node.js（原生 fetch + FormData）

参数说明速查

编辑效果与提示词写法

响应格式

授权

请求体

响应

​代码示例

​Python（OpenAI SDK · 单图编辑）

​Python（原生 requests · 单图编辑）

​cURL

​Node.js（原生 fetch + FormData）

​参数说明速查

​编辑效果与提示词写法

​响应格式

授权

请求体

响应

代码示例

Python（OpenAI SDK · 单图编辑）

Python（原生 requests · 单图编辑）

cURL

Node.js（原生 fetch + FormData）

参数说明速查

编辑效果与提示词写法

响应格式