API генерации изображений и видео

Базовый адрес: https://themegabrain.ru/api/gateway/v1. Ключ — в кабинете на странице «API-ключ», он передаётся в заголовке Authorization: Bearer <ключ>. Тот же ключ работает с API текстовых моделей. Генерации оплачиваются с рублёвого баланса.

export MEGABRAIN_API_KEY="ваш ключ"

Каталог моделей

Список моделей с ценой за единицу в рублях (pricing.rub). Единица — image (изображение), megapixel (мегапиксель) или second (секунда видео). Те же модели с примерами — в каталоге моделей генерации.

curl https://themegabrain.ru/api/gateway/v1/media/models

Очередь: отправить задачу

Тело запроса — входные параметры самой модели (prompt, image_size, num_images, image_urls для редактирования, start_image_url для «картинка → видео», duration…). Полный список полей каждой модели — в разделе «Параметры моделей» ниже и на странице модели; поле, которого нет в списке, вернёт 400. Стоимость считается до запуска и списывается сразу; если баланса не хватает, вернётся 402.

curl -X POST https://themegabrain.ru/api/gateway/v1/queue/kling-video/v3/standard/text-to-video \
  -H "Authorization: Bearer $MEGABRAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "дрон пролетает над зимним Байкалом, рассвет", "duration": "5", "generate_audio": false}'

{
  "request_id": "6c1f…",
  "model": "kling-video/v3/standard/text-to-video",
  "status": "IN_QUEUE",
  "status_url": "https://themegabrain.ru/api/gateway/v1/queue/requests/6c1f…/status",
  "response_url": "https://themegabrain.ru/api/gateway/v1/queue/requests/6c1f…",
  "refunded": false,
  …
}

Статус и результат

GET status_url возвращает IN_QUEUE, IN_PROGRESS, COMPLETED или FAILED. GET response_url отдаёт выход модели (например {"video": {"url": …}} или {"images": [{"url": …}]}), а пока задача идёт — статус 202. Опрашивайте раз в 2–5 секунд.

curl https://themegabrain.ru/api/gateway/v1/queue/requests/$REQUEST_ID/status -H "Authorization: Bearer $MEGABRAIN_API_KEY"
curl https://themegabrain.ru/api/gateway/v1/queue/requests/$REQUEST_ID -H "Authorization: Bearer $MEGABRAIN_API_KEY"

То же на Python: отправить задачу и дождаться результата.

import os
import time

import requests

BASE = "https://themegabrain.ru/api/gateway/v1"
headers = {"Authorization": f"Bearer {os.environ['MEGABRAIN_API_KEY']}"}

job = requests.post(
    f"{BASE}/queue/nano-banana-pro",
    headers=headers,
    json={"prompt": "матрёшки на заиндевевшем подоконнике, фото"},
).json()

# Опрашиваем статус, пока задача не завершится
while True:
    status = requests.get(job["status_url"], headers=headers).json()["status"]
    if status in ("COMPLETED", "FAILED"):
        break
    time.sleep(3)

result = requests.get(job["response_url"], headers=headers).json()
print(result)  # {"images": [{"url": ...}]} или описание ошибки

Возвраты

Если провайдер завершил задачу ошибкой, статус становится FAILED, а полная стоимость возвращается на баланс ("refunded": true). Если модель отклонила входные данные при отправке (422), деньги не списываются.

OpenAI-совместимые изображения

POST /images/generations принимает тело OpenAI (model, prompt, n, size) и ждёт готовую картинку до ~110 секунд. Если картинка не успела, вернётся 202 со ссылками на очередь, как выше. Остальные поля — параметры модели (см. «Параметры моделей»); size переводится в image_size или aspect_ratio модели, а поля OpenAI без аналога (quality, style…) отбрасываются.

import os

from openai import OpenAI

client = OpenAI(base_url="https://themegabrain.ru/api/gateway/v1", api_key=os.environ["MEGABRAIN_API_KEY"])
img = client.images.generate(
    model="nano-banana-pro",
    prompt="инфографика: как устроен API генерации",
    size="1024x1024",
)
print(img.data[0].url)

Параметры моделей

Поля тела запроса для каждой модели: тип, значение по умолчанию, допустимые значения и как поле меняет цену. Тот же список отдаёт GET /media/models в поле parameters.

FLUX.1 [schnell] flux/schnell

promptстрокаобязательный
Описание того, что нужно получить.
До 50 000 символов
image_sizeстрока или объектнеобязательный
Размер изображения: одно из названий или свой размер {"width": …, "height": …}.
По умолчанию:
landscape_4_3
Значения:
square_hd (1024×1024), square (512×512), portrait_4_3 (768×1024), portrait_16_9 (576×1024), landscape_4_3 (1024×768), landscape_16_9 (1024×576) или {"width", "height"}, стороны 64–4096 px
Цена:
За каждый начатый мегапиксель результата.
num_imagesцелое числонеобязательный
Сколько изображений сгенерировать.
По умолчанию:
1
Диапазон:
1–4
Цена:
Умножается на число изображений.
seedцелое числонеобязательный
Зерно генерации: тот же seed и тот же запрос дают тот же результат.
output_formatстроканеобязательный
Формат файла результата.
По умолчанию:
jpeg
Значения:
jpeg, png
num_inference_stepsцелое числонеобязательный
Число шагов генерации: больше — детальнее, но дольше.
По умолчанию:
4
Диапазон:
1–12
guidance_scaleчислонеобязательный
Насколько строго следовать описанию.
По умолчанию:
3.5
Диапазон:
1–20
accelerationстроканеобязательный
Ускорение генерации: выше — быстрее, детали могут упроститься.
По умолчанию:
none
Значения:
none, regular, high