Перейти к основному содержанию
POST
Image editing: edit reference images (1–5)
Интерактивный Playground справа поддерживает загрузку локальных изображений. Введите свой API-ключ в поле Authorization (формат: Bearer sk-xxx), выберите один или несколько файлов image, заполните prompt и model и отправьте запрос.
🔴 Этот эндпоинт принимает только загрузку файлов через multipart/form-dataОтправка JSON на /v1/images/edits (с image в виде URL, data URI или необработанного base64) возвращает 400:
URL изображений не поддерживаются в качестве входных данных. Если у вас есть только URL, сначала скачайте файл на свой сервер, а затем загрузите его. Для загрузки файлов не требуется хостинг изображений — достаточно просто отправить локальный файл.
Сценарий использования: эта страница предназначена для редактирования с референсными изображениями, включая обработку одного изображения и объединение от 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 · одно изображение)

Python (OpenAI SDK · объединение нескольких изображений)

Python (requests · одно изображение)

Для нескольких изображений передайте files в виде списка кортежей с одним image[] на каждое изображение (словарь не может содержать повторяющиеся ключи):

cURL

Node.js (fetch + FormData)

Справочник параметров

Размер на выходе, если параметр опущен: размер на выходе наследует соотношение сторон оригинала с округлением до чисел, кратных 16, например, ввод 1344×756 дает 1360×768; при наличии нескольких изображений соотношение сторон задает изображение 1. Для локальных правок, где требуется сохранить композицию, не передавайте width / height.

Результаты редактирования и составление prompt

Эндпоинт редактирования сохраняет композицию, цвета и детали оригинала и изменяет только то, что запрошено в prompt:
Пример редактирования MAI-Image-2.6-Flash: цвет чайника изменен с кремового на кобальтово-синий, все остальное осталось без изменений
Явное указание «keep everything else the same» — наиболее эффективная техника при работе с этой моделью, позволяющая максимально сохранить оригинал.

Объединение нескольких изображений

Изображение 1 служит основой, а объекты из других референсных изображений размещаются на нем в соответствии с описанием в prompt. В приведенном ниже примере в одном запросе отправляются 5 изображений (чайный сервиз + лиса + резиновая уточка + будильник + кактус) с prompt, где требуется разместить лису из изображения 2, желтую резиновую уточку из изображения 3, красный винтажный будильник из изображения 4 и кактус в горшке из изображения 5 на чайный столик из изображения 1, сохранив внешний вид каждого объекта и оставив остальную часть изображения 1 без изменений:
Пример объединения нескольких изображений MAI-Image-2.6-Flash: на входе 5 референсных изображений, все четыре объекта помещены на изображение с чайным сервизом, остальная часть оставлена без изменений

Формат ответа

Поля ответа
  • b64_json — это чистый base64 без префикса data:, который декодируется в PNG.
  • При n > 1 массив data содержит несколько элементов; не считывайте только data[0].
  • url и revised_prompt не возвращаются.
Не сверяйте тарификацию по usage: здесь содержатся фиктивные значения (prompt_tokens всегда равно 1000 × количество изображений). Редактирование стоит столько же, сколько генерация из текста в изображение, тарифицируется за изображение, при этом количество референсных изображений не влияет на цену; определяющим является счет в консоли APIYI.

Авторизации

Authorization
string
header
обязательно

API key from the APIYI console

Тело

multipart/form-data
model
enum<string>
по умолчанию:MAI-Image-2.6-Flash
обязательно

Model ID (case-sensitive)

Доступные опции:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
обязательно

Edit instruction. State what to change and that everything else stays the same

Пример:

"Change the teapot to a deep cobalt blue glaze, keep everything else identical"

image
file[]
обязательно

Reference image files, 1–5, numbered image 1…N in upload order. png / jpg / webp. In code, repeat the image[] field for several images

Required array length: 1 - 5 elements
width
integer

Optional output width. Same rules as text-to-image: each side ≥ 768, width × height ≤ 2,359,296, sent together with height

Требуемый диапазон: x >= 768
height
integer

Optional output height, same rules as width

Требуемый диапазон: x >= 768
n
integer
по умолчанию:1

Number of images. Works on this endpoint, billed per image

Требуемый диапазон: x >= 1
Пример:

1

Ответ

Image generated

created
integer

Creation timestamp

Пример:

1791000788

data
object[]

Image results; length equals n

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images