Image editing: edit reference images (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=Change the teapot to a deep cobalt blue glaze, keep everything else identical' \
--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": "Change the teapot to a deep cobalt blue glaze, keep everything else identical"
}
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', 'Change the teapot to a deep cobalt blue glaze, keep everything else identical');
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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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 редактирования изображений
Справочник API редактирования изображений MAI-Image 2.6 с интерактивным Playground — загрузите 1–5 референсных изображений и инструкцию для их редактирования или объединения, поддерживается только загрузка файлов через multipart/form-data; количество референсных изображений не влияет на стоимость
POST
/
v1
/
images
/
edits
Image editing: edit reference images (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=Change the teapot to a deep cobalt blue glaze, keep everything else identical' \
--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": "Change the teapot to a deep cobalt blue glaze, keep everything else identical"
}
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', 'Change the teapot to a deep cobalt blue glaze, keep everything else identical');
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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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\nChange the teapot to a deep cobalt blue glaze, keep everything else identical\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 справа поддерживает загрузку локальных изображений. Введите свой API-ключ в поле Authorization (формат:
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 изображений. Для генерации только по тексту используйте API генерации изображений по тексту.
🖼️ Поддерживается от 1 до 5 референсных изображений (с 2026-10-07)
- Способ: повторяйте поле
image[], по одному изображению на поле. В OpenAI SDK передайте список:client.images.edit(image=[f1, f2, ...]). Повторениеimageтакже работает - Порядок: изображения нумеруются в порядке загрузки (изображение 1, изображение 2, …), поэтому в prompt можно указать «поместите лису с изображения 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
)
# images.edit uses a multipart file upload under the hood; do not pass 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
)
# Pass a list of 1-5 files; the SDK uploads each one as an image[] field
# Images are numbered in upload order (image 1, image 2, ...); same price as a single image
resp = client.images.edit(
model="MAI-Image-2.6-Flash",
image=[open("teaset.jpg", "rb"), open("fox.jpg", "rb")],
prompt="Put the fox from image 2 (keeping every detail of its look) into the scene of image 1, sitting next to the tea set; keep everything else in image 1 unchanged"
)
with open("fused.png", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))
Python (requests · одно изображение)
import base64
import os
import requests
# Pass the file via files=; requests sets multipart/form-data and the boundary for you
# Do not use json=, and do not set Content-Type by hand
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": "Change the teapot to a deep cobalt blue glaze, keep everything else exactly the same"
},
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[] на каждое изображение (словарь не может содержать повторяющиеся ключи):
files = [
("image[]", ("teaset.jpg", open("teaset.jpg", "rb"), "image/jpeg")),
("image[]", ("fox.jpg", open("fox.jpg", "rb"), "image/jpeg")),
]
cURL
# Single-image edit: -F means multipart/form-data, @ uploads a local file
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=Change the teapot to a deep cobalt blue glaze, keep everything else identical" \
-F "[email protected]" \
| python3 -c "import sys,json,base64; open('edited.png','wb').write(base64.b64decode(json.load(sys.stdin)['data'][0]['b64_json']))"
# Edit and change the canvas to 1536×1024 (a different aspect ratio recomposes the image)
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=Turn this tea set into a lifestyle scene on a wooden table, natural light, photorealistic" \
-F "width=1536" \
-F "height=1024" \
-F "[email protected]"
# Multi-image fusion: repeat the image[] field, 1-5 images, numbered in upload order
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=Put the fox from image 2 (keeping every detail of its look) into the scene of image 1, sitting next to the tea set; keep everything else in image 1 unchanged" \
-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', 'Replace the background with a snowy pine forest at night, keep the person unchanged');
form.append('image', new Blob([fs.readFileSync('./photo.jpg')]), 'photo.jpg');
// Multi-image fusion: call form.append('image[]', ...) once per image instead, up to 5
const resp = await fetch('https://api.apiyi.com/v1/images/edits', {
method: 'POST',
// Do not set Content-Type by hand; FormData adds the 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 | ❌ | Наследует соотношение оригинала | Размер на выходе, те же правила, что и для text-to-image; другое соотношение сторон меняет композицию изображения |
n | integer | ❌ | 1 | Количество изображений. Работает на этом эндпоинте, тарифицируется за изображение |
mask | — | — | — | Не поддерживается; возвращает 400 <model> does not support mask edits |
response_formatseednegative_prompt | — | — | — | Возвращают 400 |
Размер на выходе, если параметр опущен: размер на выходе наследует соотношение сторон оригинала с округлением до чисел, кратных 16, например, ввод 1344×756 дает 1360×768; при наличии нескольких изображений соотношение сторон задает изображение 1. Для локальных правок, где требуется сохранить композицию, не передавайте
width / height.Результаты редактирования и составление prompt
Эндпоинт редактирования сохраняет композицию, цвета и детали оригинала и изменяет только то, что запрошено в prompt:
| Prompt | Результат |
|---|---|
✅ Change the teapot to a deep cobalt blue glaze, keep everything else exactly the same | Изменяется только цвет чайника; надписи и другие объекты остаются попиксельно идентичными |
✅ Turn this photo into a watercolor painting, keep the composition | Стиль перерисован, композиция сохранена |
⚠️ Make it look better | Слишком расплывчато; объем изменений непредсказуем |
Явное указание «keep everything else the same» — наиболее эффективная техника при работе с этой моделью, позволяющая максимально сохранить оригинал.
Объединение нескольких изображений
Изображение 1 служит основой, а объекты из других референсных изображений размещаются на нем в соответствии с описанием в prompt. В приведенном ниже примере в одном запросе отправляются 5 изображений (чайный сервиз + лиса + резиновая уточка + будильник + кактус) с prompt, где требуется разместить лису из изображения 2, желтую резиновую уточку из изображения 3, красный винтажный будильник из изображения 4 и кактус в горшке из изображения 5 на чайный столик из изображения 1, сохранив внешний вид каждого объекта и оставив остальную часть изображения 1 без изменений:
| Prompt | Результат |
|---|---|
✅ Put the fox from image 2 into the scene of image 1, keep everything else in image 1 unchanged | Указывайте изображения как image N в порядке загрузки; это наиболее надежная формулировка |
✅ Назовите объект на каждом изображении: the yellow rubber duck from image 3, the red alarm clock from image 4 | При большом количестве изображений указание названия каждого объекта гарантирует, что ни один из них не будет пропущен |
⚠️ Combine these images into one | Базовое изображение и объект не названы, поэтому композиция непредсказуема |
Формат ответа
{
"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 × количество изображений). Редактирование стоит столько же, сколько генерация из текста в изображение, тарифицируется за изображение, при этом количество референсных изображений не влияет на цену; определяющим является счет в консоли APIYI.Тело
multipart/form-data
Была ли эта страница полезной?