Создаёт изображения по текстовому описанию и редактирует загруженные картинки по инструкции — до 5 изображений за раз, можно с прозрачным фоном. Цена зависит от модели: Обычная — 1K 7 ₽, 2K 25 ₽, каждое загруженное изображение плюс 4 ₽; Flash — 1K 2 ₽, 2K 8 ₽, каждое изображение плюс 1,50 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
MAI Image 2.7 рисует изображения по текстовому заданию и правит готовые картинки по инструкции: меняет фон и свет, заменяет предметы, переписывает надписи, реставрирует старые фото и собирает сцену из нескольких референсов. Через API её удобно запускать для:
Режим определяется составом запроса: без image_urls - генерация по тексту, с одной ссылкой - правка, с несколькими - композиция. Каждый вызов создаёт асинхронную операцию: в ответ сразу приходят id и стартовый статус, а ссылку на готовую картинку вы забираете запросом проверки статуса.
POST /api/v1/operationsAuthorization: Bearer brth_...id, стартовый статус и стоимость.Доступны две модели:
standard - обычная модель с лучшим качеством;flash - быстрее и дешевле, качество немного ниже. Параметры и возможности те же.Сценарии:
prompt, aspect_ratio, resolution;prompt и одна ссылка в image_urls;prompt и 2-5 ссылок в image_urls.Пропорции, разрешение, прозрачный фон и формат файла работают во всех сценариях.
Базовая форма запроса:
{
"tool": "mai-image-2-7",
"input": {
"...": "..."
}
}
tool - slug нейросети, для этой модели всегда "mai-image-2-7".input - параметры запуска. Поля передаются прямо внутри input, без дополнительной вложенности.prompt, остальные параметры можно не передавать - тогда используются значения по умолчанию из таблицы ниже.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
mai_model_tier | enum | Нет | Модель: standard или flash. Если не передать, используется standard. |
prompt | string | Да | Описание картинки или инструкция, что изменить. От 3 до 10000 символов. В правке полезно назвать и то, что должно остаться как было: форму товара, лицо, надписи. С несколькими изображениями прямо напишите, что взять с каждого: «товар с первого изображения, интерьер со второго». |
image_urls | string[] (url) | Нет | Ссылки на изображения для правки или композиции, до 5 штук. Только внешние http/https URL. Расширения: .jpg, .jpeg, .png, .webp. Без этого поля запускается генерация по тексту. |
aspect_ratio | enum | Нет | Соотношение сторон: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. auto с image_urls - пропорции близки к исходному изображению, без изображений получится 1:1. Если не передать, используется auto. |
resolution | enum | Нет | Разрешение: 1K (около 1 Мп, 1024×1024 для 1:1) или 2K (каждая сторона вдвое больше, около 4 Мп, 2048×2048 для 1:1). Если не передать, используется 1K. С image_urls и aspect_ratio = auto доступно только 1K: размер подстраивается под исходник. Для правки в 2K передайте конкретные пропорции. |
background_transparent | boolean | Нет | true - объект на прозрачном фоне. Работает только с форматами png и webp: запрос с jpeg и прозрачным фоном будет отклонён. По умолчанию выключено. |
output_format | enum |
Нужна только текстовая подсказка, при желании - пропорции и разрешение.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "standard",
"prompt": "Постер летнего фестиваля уличной еды: фудтраки на набережной на закате, гирлянды, крупная надпись «ВКУСНЫЙ ВЕЧЕР» сверху",
"aspect_ratio": "2:3",
"resolution": "2K",
"output_format": "jpeg"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'mai-image-2-7',
input: {
mai_model_tier: 'standard',
prompt:
'Постер летнего фестиваля уличной еды: фудтраки на набережной на закате, гирлянды, крупная надпись «ВКУСНЫЙ ВЕЧЕР» сверху',
aspect_ratio: '2:3',
resolution: '2K',
output_format: 'jpeg',
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "standard",
"prompt": "Постер летнего фестиваля уличной еды: фудтраки на набережной на закате, гирлянды, крупная надпись «ВКУСНЫЙ ВЕЧЕР» сверху",
"aspect_ratio": "2:3",
"resolution": "2K",
"output_format": "jpeg",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Передайте одну ссылку в image_urls и опишите, что изменить и что оставить как есть.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "flash",
"prompt": "Замени серый фон на светлую кухню с утренним светом из окна, сам товар, его форму и надписи на упаковке не меняй",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
]
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'mai-image-2-7',
input: {
mai_model_tier: 'flash',
prompt:
'Замени серый фон на светлую кухню с утренним светом из окна, сам товар, его форму и надписи на упаковке не меняй',
image_urls: ['https://cdn.example.com/source-image-1.jpg'],
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "flash",
"prompt": "Замени серый фон на светлую кухню с утренним светом из окна, сам товар, его форму и надписи на упаковке не меняй",
"image_urls": ["https://cdn.example.com/source-image-1.jpg"],
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Передайте от 2 до 5 ссылок. Главный исходник ставьте первым и в prompt объясните, что взять с каждой картинки.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "standard",
"prompt": "Поставь кресло с первого изображения в гостиную со второго изображения, у окна слева, сохрани цвет и фактуру обивки кресла",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.png"
],
"aspect_ratio": "16:9"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'mai-image-2-7',
input: {
mai_model_tier: 'standard',
prompt:
'Поставь кресло с первого изображения в гостиную со второго изображения, у окна слева, сохрани цвет и фактуру обивки кресла',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/source-image-2.png',
],
aspect_ratio: '16:9',
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "standard",
"prompt": "Поставь кресло с первого изображения в гостиную со второго изображения, у окна слева, сохрани цвет и фактуру обивки кресла",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.png",
],
"aspect_ratio": "16:9",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Включите background_transparent и выберите png или webp.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "flash",
"prompt": "Наклейка в мультяшном стиле: рыжий кот в очках держит кружку кофе, толстая белая обводка",
"aspect_ratio": "1:1",
"background_transparent": true,
"output_format": "png"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'mai-image-2-7',
input: {
mai_model_tier: 'flash',
prompt:
'Наклейка в мультяшном стиле: рыжий кот в очках держит кружку кофе, толстая белая обводка',
aspect_ratio: '1:1',
background_transparent: true,
output_format: 'png',
},
}),
})
const data = await response.json()
console.log(data)
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Content-Type": "application/json",
},
json={
"tool": "mai-image-2-7",
"input": {
"mai_model_tier": "flash",
"prompt": "Наклейка в мультяшном стиле: рыжий кот в очках держит кружку кофе, толстая белая обводка",
"aspect_ratio": "1:1",
"background_transparent": True,
"output_format": "png",
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "7c1e4b92-5a3d-4f08-b6e1-9d2a8f4c3e57",
"status": "queued",
"tool": "mai-image-2-7",
"cost": 15,
"balance_after": 485,
"created_at": "2026-11-18T08:00:00.000Z"
}
{
"id": "7c1e4b92-5a3d-4f08-b6e1-9d2a8f4c3e57",
"status": "completed",
"tool": "mai-image-2-7",
"cost": 15,
"created_at": "2026-11-18T08:00:00.000Z",
"completed_at": "2026-11-18T08:00:38.000Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/mai-image-2-7/image-1.png"
]
},
"error_message": null
}
{
"id": "7c1e4b92-5a3d-4f08-b6e1-9d2a8f4c3e57",
"status": "failed",
"tool": "mai-image-2-7",
"cost": 15,
"created_at": "2026-11-18T08:00:00.000Z",
"completed_at": "2026-11-18T08:00:12.000Z",
"result": null,
"error_message": "Не удалось выполнить операцию"
}
Статус проверяется по id, который пришёл в ответ на создание операции. Сохраните его - без id результат конкретного запуска не получить. Опрашивать удобно раз в 3-5 секунд, пока статус не станет completed или failed.
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/7c1e4b92-5a3d-4f08-b6e1-9d2a8f4c3e57
const operationId = '7c1e4b92-5a3d-4f08-b6e1-9d2a8f4c3e57'
const response = await fetch(
`https://bratuha.ru/api/v1/operations/${operationId}`,
{
headers: {
Authorization: 'Bearer brth_ваш_ключ',
},
},
)
const operation = await response.json()
console.log(operation)
После успешного выполнения в result приходит объект изображения:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/mai-image-2-7/image-1.png"
]
}
urls - массив ссылок. Один запуск создаёт одно изображение, поэтому ссылка в массиве одна. Формат файла - тот, что передан в output_format (по умолчанию PNG).
Цена складывается из стоимости изображения и доплаты за каждую ссылку в image_urls. Изображение стоит по-разному в зависимости от модели и разрешения. Пропорции, формат и прозрачный фон на цену не влияют.
| Модель | 1K | 2K | Каждое изображение в image_urls |
|---|---|---|---|
standard | 7 ₽ | 25 ₽ | +4 ₽ |
flash | 2 ₽ | 8 ₽ | +1,50 ₽ |
Примеры:
standard, без изображений, resolution = 1K - 7 ₽;standard, две ссылки в image_urls, resolution = 1K - 7 + 2 × 4 = 15 ₽;flash, одна ссылка, resolution = 2K - 8 + 1,50 = 9,50 ₽;standard, пять ссылок, resolution = 2K - 25 + 5 × 4 = 45 ₽.Точная сумма приходит в поле cost ответа на создание операции.
POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию и снова списывает стоимость.POST нет, используйте GET /api/v1/operations/{id}.image_urls нужны внешние http/https URL, доступные из интернета. Локальные пути, localhost, blob: и data: не подходят.image_urls. Подходят .jpg, .jpeg, .png и .webp.21:9, 5:4, 4:5 и другие, которых нет в списке, не поддерживаются - запрос с ними будет отклонён.image_urls, aspect_ratio = auto и resolution = 2K будет отклонён: в этом сочетании размер результата всегда около 1 Мп. Укажите пропорции, например 3:4, - тогда правка придёт в 2K.| Нет |
Формат файла: png, jpeg или webp. Если не передать, используется png. |