图片编辑 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' \
  --form image2='@example-file'

import requests

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

files = {
    "image": ("example-file", open("example-file", "rb")),
    "image2": ("example-file", open("example-file", "rb"))
}
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>');
form.append('image2', '{
  "fileName": "example-file"
}');

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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; 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))

}

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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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' \
  --form image2='@example-file'

import requests

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

files = {
    "image": ("example-file", open("example-file", "rb")),
    "image2": ("example-file", open("example-file", "rb"))
}
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>');
form.append('image2', '{
  "fileName": "example-file"
}');

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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; 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))

}

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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"image2\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\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 时，请先在服务端下载成文件再上传。文件上传不需要图床，直接传本地文件即可。

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

⚠️ 多图字段名是 image + image2，不是 image[]两张参考图时，第一张字段名 image、第二张 image2。image[] 重复两次、image 同名两次、带 mask 字段都会返回 400 File must be attached in a form field with a name starting with 'image'。因此 OpenAI SDK 的 client.images.edit(image=[f1, f2]) 多图写法不可用（它会发 image[]）；单图编辑用 SDK 没问题。

参数红线与文生图相同：不要传 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"]))

Python（双图融合 · image + image2）

import base64
import os
import requests

files = {
    "image": ("scene.jpg", open("scene.jpg", "rb"), "image/jpeg"),     # 图1
    "image2": ("person.jpg", open("person.jpg", "rb"), "image/jpeg"),  # 图2，字段名是 image2
}

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": "让图2的人物坐在图1的桌前，正在摆弄这套茶具，自然光，写实摄影"
    },
    files=files,
    timeout=180
)
response.raise_for_status()

with open("fused.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 "[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=让图2的人物坐在图1的桌前，正在摆弄这套茶具" \
  -F "width=1536" \
  -F "height=1024" \
  -F "[email protected]" \
  -F "[email protected]"

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('image2', ...)

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	✅	—	参考图文件（第一张）
`image2`	file	❌	—	第二张参考图（双图融合时用）
`width` / `height`	integer	❌	跟随原图比例	指定输出尺寸，规则同文生图；与原图比例不同时会重新构图
`n`	integer	❌	`1`	出图张数，本端点有效，按张计费
~~`mask`~~	—	—	—	不支持，传入返回 400
~~`response_format`~~ / ~~`seed`~~ / ~~`negative_prompt`~~	—	—	—	传入返回 400

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

编辑效果与提示词写法

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

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

双图融合时在提示词里用「图1 / 图2」指代 image / image2。实测人物融合时身份保真度一般（脸部特征可能变化），对人像一致性要求高的场景请先小批量验证。

响应格式

{
  "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

image2

file

可选，第二张参考图（提示词中的「图2」），用于双图融合

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 · 单图编辑）

Python（双图融合 · image + image2）

cURL

Node.js（原生 fetch + FormData）

参数说明速查

编辑效果与提示词写法

响应格式

授权

请求体

响应

​代码示例

​Python（OpenAI SDK · 单图编辑）

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

​Python（双图融合 · image + image2）

​cURL

​Node.js（原生 fetch + FormData）

​参数说明速查

​编辑效果与提示词写法

​响应格式

授权

请求体

响应

代码示例

Python（OpenAI SDK · 单图编辑）

Python（原生 requests · 单图编辑）

Python（双图融合 · image + image2）

cURL

Node.js（原生 fetch + FormData）

参数说明速查

编辑效果与提示词写法

响应格式