图片编辑:根据指令编辑参考图(1–5 张)
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
}
}MAI-Image 2.6 生圖/編輯
圖片編輯 API 參考
MAI-Image 2.6 圖片編輯 API 參考與線上除錯 — 上傳 1–5 張參考圖 + 指令改圖或多圖融合,必須使用 multipart/form-data 檔案上傳,參考圖張數不影響價格
POST
/
v1
/
images
/
edits
图片编辑:根据指令编辑参考图(1–5 张)
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 後一鍵傳送即可。🔴 本介面只接受 不支援圖片 URL 入參。手上只有 URL 時,請先在服務端下載成檔案再上傳。檔案上傳不需要圖床,直接傳本地檔案即可。
multipart/form-data 檔案上傳傳送 JSON 到 /v1/images/edits(image 填 URL、data URI 或裸 base64)會返回 400:request Content-Type isn't multipart/form-data
場景說明:本頁用於「基於參考圖改圖」,支援單圖編輯與 1–5 張多圖融合。如需純文本生成圖片,請使用 文生圖介面。
🖼️ 支援 1–5 張參考圖(2026-10-07 起)
- 寫法:重複
image[]欄位,每個欄位放一張圖;OpenAI SDK 直接傳列表client.images.edit(image=[f1, f2, ...])。image同名重複也可以 - 順序:按上傳順序依次是圖1、圖2……,提示詞裡可以直接說「把圖2裡的狐狸放進圖1」
- 價格:按次計費,傳 1 張還是 5 張都是同一個價
- 格式:JPEG、PNG、WebP;GIF 等其他格式返回 400
- 超過 5 張返回 400
at most 5 reference images are accepted for <model>
不要用
image + image2 這類編號欄位名:返回 200,但只有第一張圖生效,第二張被丟棄;image1 + image2 則返回 500 image is required。多張圖請一律用重複的 image[]。引數紅線與文生圖相同:不要傳
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(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
)
# image 傳列表即可,1–5 張;SDK 會把每張圖作為一個 image[] 欄位上傳
# 按上傳順序依次是圖1、圖2……,價格與單圖相同
resp = client.images.edit(
model="MAI-Image-2.6-Flash",
image=[open("teaset.jpg", "rb"), open("fox.jpg", "rb")],
prompt="把圖2裡的狐狸(保留它的全部外觀細節)放進圖1的場景裡,坐在茶具旁邊,圖1其餘部分保持不變"
)
with open("fused.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"]))
files 改用元組列表,每張圖一個 image[](dict 不能放重複的鍵):
files = [
("image[]", ("teaset.jpg", open("teaset.jpg", "rb"), "image/jpeg")),
("image[]", ("fox.jpg", open("fox.jpg", "rb"), "image/jpeg")),
]
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 "[email protected]" \
| 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 "[email protected]"
# 多圖融合:重複 image[] 欄位,1–5 張,按順序為圖1、圖2……
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=把圖2裡的狐狸(保留它的全部外觀細節)放進圖1的場景裡,坐在茶具旁邊,圖1其餘部分保持不變" \
-F "image[][email protected]" \
-F "image[][email protected]" \
| python3 -c "import sys,json,base64; open('fused.png','wb').write(base64.b64decode(json.load(sys.stdin)['data'][0]['b64_json']))"
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');
// 多圖融合:改成多次 form.append('image[]', ...),每次一張,最多 5 張
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 / image[] | file | ✅ | — | 參考圖檔案,1–5 張。單圖用 image;多圖重複 image[] 欄位,按上傳順序為圖1…圖N。支援 JPEG / PNG / WebP,張數不影響價格 |
width / height | integer | ❌ | 跟隨原圖比例 | 指定輸出尺寸,規則同文生圖;與原圖比例不同時會重新構圖 |
n | integer | ❌ | 1 | 出圖張數,本端點有效,按張計費 |
mask | — | — | — | 不支援,傳入返回 400 <model> does not support mask edits |
response_formatseednegative_prompt | — | — | — | 傳入返回 400 |
不傳尺寸時的輸出:按原圖比例貼合到 16 的倍數網格,例如 1344×756 的輸入輸出 1360×768;多圖時以圖1的比例為準。只想改局部、不想動構圖時,不要傳
width / height。編輯效果與提示詞寫法
編輯介面會保留原圖的構圖、配色與細節,只改提示詞指定的部分:
| 寫法 | 效果 |
|---|---|
✅ 把茶壺改成深鈷藍釉,其餘部分完全保持不變 | 只有茶壺變色,尺寸標註、其它物件逐畫素保留 |
✅ 把這張照片改成水彩畫風格,構圖不變 | 風格整體重繪,構圖保持 |
⚠️ 讓它更好看一點 | 指令過於籠統,改動範圍不可控 |
**顯式宣告「其餘保持不變」**是這個模型上最有效的技巧,能最大限度保留原圖。
多圖融合
把圖1當作底圖,其餘參考圖裡的物體按提示詞放進去。下例一次傳入 5 張(茶具圖 + 狐狸 + 橡皮鴨 + 鬧鐘 + 仙人掌),提示詞為「把圖2的狐狸、圖3的黃色橡皮鴨、圖4的紅色復古鬧鐘、圖5的仙人掌盆栽都擺進圖1的茶桌場景裡,每個物體保留原有外觀,圖1其餘部分保持不變」:
| 寫法 | 效果 |
|---|---|
✅ 把圖2裡的狐狸放進圖1的場景裡,圖1其餘部分保持不變 | 用「圖N」指代參考圖,按上傳順序對應,最穩定 |
✅ 點名每張圖裡的物體:圖3的黃色橡皮鴨、圖4的紅色鬧鐘 | 張數多時逐個點名,避免漏放 |
⚠️ 把這幾張圖合成一張 | 沒指明底圖和主體,構圖不可控 |
響應格式
{
"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易 控制台賬單為準。主體
multipart/form-data
這個頁面有幫助嗎?