04 · гайд

Изображения

Генерация — синхронная: ответ приходит в том же запросе, обычно за 10–90 секунд. Цена фиксированная за изображение и зависит от модели и разрешения (разрешение зашито в имя позиции: nano-banana-2-1k, -2k, -4k).

Генерация по тексту

curl https://api.node404.ru/v1/images/generations \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-1k",
    "prompt": "уютный маяк на скалистом берегу на закате",
    "size": "16:9",
    "output_format": "png"
  }'

Ответ: data[0].url — ссылка на готовый файл. Пропорция задаётся полем size — принимается только значение из списка допустимых у конкретной позиции (см. страницу модели; у разных разрешений одной модели списки отличаются). output_format есть не у всех моделей, и наборы значений разные (png/jpg у Nano Banana, png/jpeg у Kontext и Seedream, у GPT Image и FLUX.2 параметра нет) — у модели без него поле вернёт 400.

Правка по изображению (i2i)

Модели с правкой (Nano Banana, FLUX Kontext, GPT Image, FLUX.2 Pro, Seedream 5 Pro, Grok) принимают исходники на POST https://api.node404.ru/v1/images/edits двумя способами: публичными ссылками в JSON-поле image_urls (строка или массив) — как у видео — либо multipart-формой с файлами image[] (JPG, PNG, WebP) до 20 МБ каждый. Лимит исходников — на странице модели (Nano Banana 2 — до 14, Kontext — ровно 1, остальные — до 5).

curl https://api.node404.ru/v1/images/edits \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "замени небо на грозовое",
    "image_urls": ["https://ваш-домен/input.png"]
  }'

То же формой:

curl https://api.node404.ru/v1/images/edits \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -F model=flux-kontext-pro \
  -F prompt="замени небо на грозовое" \
  -F image[]=@input.png

Фильтр контента

Поле moderation поддерживают только FLUX.2 и Seedream 5: auto — фильтр включён, low — выключен. Если поле не передано, действует настройка модели по умолчанию (у этих семейств фильтр по умолчанию выключен; собственная модерация провайдера работает всегда). Остальным моделям это поле не передавайте — вернётся 400.