Генерація медіа (від'єри, картини, музика)

NordRouter вміє генерувати ізображення, відео і музику з тією ж ключом sk-nr-… і з тієї ж баланси, що і текстові моделі.

Як це працює?

Асинхронна генерація (від секунди до декількох хвилин займають відео і музика):

1. ** Створюйте задачу** POST /media/generate з моделем і параметрами.
2. Чоки ви отримаєте результат запитайте GET /media/job/:id, поки status не стане done.
3. Витягуйте файл по result_url (посилається на nordrouter.com).

1. Створювати завдання.

curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-ВАШ-КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image/nano-banana-2",
    "input": { "prompt": "уютная хижина в зимнем лесу, акварель", "resolution": "2K" }
  }'

Відповідь:

{ "id": "beefb531-…", "model": "image/nano-banana-2", "status": "processing",
  "poll": "https://nordrouter.com/media/job/beefb531-…" }

2. чекати результату.

curl https://nordrouter.com/media/job/beefb531-…

{ "id": "beefb531-…", "status": "done",
  "result_url": "https://nordrouter.com/media/file/beefb531-…",
  "cost_usd": 0.052, "error": null }

status: processing → done (або failed). Готовий файл по result_url.

🎵 Suno генерує два треки за завдання: перший в result_url, другий в result_url_2 (такий же формат посилання).

Вебхуки (замість полінга)

Не хочете запитувати передайте поле POST /media/generate callback_url, і ми поправляємо результат самим по POST-запиті, коли завдання закінчиться:

curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-ВАШ-КЛЮЧ" -H "Content-Type: application/json" \
  -d '{
    "model": "image/nano-banana-2",
    "input": { "prompt": "…" },
    "callback_url": "https://ваш-сервер.com/webhooks/nordrouter",
    "callback_secret": "ваш-секрет"
  }'

Коли завдання перейде в done/failed, на callback_url POST з'явиться з тією ж темою, що і GET /media/job/:id, плюс поле event:

{ "event": "media.completed", "id": "beefb531-…", "status": "done",
  "result_url": "https://nordrouter.com/media/file/beefb531-…", "cost_usd": 0.052, "error": null }

event: media.completed або media.failed.

Проверка підпису. Якщо зайти callback_secret, у заголовку X-NR-Signature вийде sha256=<hmac> HMAC-SHA256 від компанії запиту на вашій таємниці.

import hmac, hashlib
expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
assert hmac.compare_digest(expected, request.headers["X-NR-Signature"])

Запази та надійність:

• callback_url тільки https:// і тільки публічний адрес (внутрішній/приватний IP відхиляється з помилкою 400).
• До 4 спроб доставки з збільшуючою перервою; відповідіть 2xx, інакше ми повторюємо.
• Вебхук не скасує полювання можна комбінувати або використовувати GET /media/job/:id як заплюнок.

Деталі про це далі

Життєвий цикл задач, перевірка підписів з прикладами і надійність доставки на сторінці Задачі і веб-хоки.

3. Список моделей і ціни

GET /media/models повертає доступні моделі, їх параметри та оцінку вартості:

{ "models": [
    { "id": "image/nano-banana-2", "type": "image",
      "fields": [ {"name":"prompt","type":"textarea"}, {"name":"resolution","type":"select","options":["1K","2K","4K"]} ],
      "est_usd": 0.052 }
  ], "retention_days": 14 }

Повний справочник

Всі моделі з параметрами input і ціною на сторінці ЗМІ: всі моделі і викладання.

Моделі

Доступні 95 моделей повний актуальний список з параметрами і ціною завжди на GET /media/models.

Тип	Родина	Режим	≈ ціна
Картини	Nano Banana / 2 / Pro (image/nano-banana*)	текст→картина, правка, до 4K	від $0.025
	Imagen 4 Fast / Ultra (image/imagen4*)	текст→картинка	від $0.025
	GPT Image 1.5 / 2 (image/gpt-image-*)	text→картина, правка, до 4K	від $0.025
	Flux 2 Pro / Flex (image/flux2-*)	текст→картинка, правка	від $0.03
	Seedream v4 / 4.5 / 5 Lite (image/seedream-*)	текст→картинка, правка	від $0.04
	Ideogram v3 / Character (image/ideogram-*)	текст, ремікс, персонаж	від $0.02
	Qwen / Wan Image / Grok / Z-Image	текст→картина, правка	від $0.01
Утилити	Topaz / Recraft (image/*upscale*, image/recraft-remove-bg)	апскейл до 8K, видалення фон	від $0.01
🎬 Видео	Veo 3.1 Lite / Fast / Quality (video/veo-3.1-*)	текст/фото→видео видео	від $0.19
🎬	Kling 2.1 → 3.0 (video/kling-*)	текст/фото→видео, рух, аватари, до 4K і 15с	від $0,16
🎬	Wan 2.2 → 2.7 video/wan-*)	текст/фото/відео →видео, виступ-на відео	від $0.25
🎬	Seedance 1.5 / 2 / Fast / Mini (video/seedance-*)	текст/фото→видео, до 4K, звук	від $0.06
🎬	Hailuo 02 / 2.3 (video/hailuo-*)	текст/фото→видео	от $0.08
🎬	HappyHorse 1.0 / 1.1 (video/happyhorse-*)	текст/фото/референс→видео, правка відео	від $0.70
🎬	Grok Video / 1.5 (video/grok-*)	текст/фото→видео, до 30с	від $0.06
🎬	Gemini Omni (video/gemini-omni)	відео з звуком, до 4K	від $0.39
Аватари	Kling Avatar, OmniHuman, InfiniteTalk, Lip Sync	фото+аудио→говоряче відео	від $0.19
🎵 Музика	Suno V4V5.5 (music/suno-v5)	текст/стиль→2 трек	~$0.08
Звук	ElevenLabs Turbo / Multilingual (audio/elevenlabs-*)	текст→речь, ізоляція голосу	від $0.04 / 1000 зн.

Параметри

Параметри залежать від моделі точного списку в /media/models (поле fields: ім'я, тип, варіанти, дефолт).

• prompt Опис (для всіх генеративних моделей).
• resolution 1K/2K/4K (картини) або 480p/720p/1080p/4k (відповіді).
• aspect_ratio 1:1, 16:9, 9:16 і т.д.
• duration Продовність відео в секундах (у більшості 5/10, у Клінга 3.0 і Ван 2.7 до 15, у Грока до 30).
• sound / generate_audio звукова дорога (Kling, Seedance). /media/estimate Це враховується.
• mode / quality / rendering_speed рівень якості (Клінг 3.0 std/pro/4K, GPT Image medium/high, Ідеограмма TURBO/BALANCED/QUALITY).
• image вхідна картина (правка, фото→video; передайте прямий посилання або завантажте через /media/upload).
• video_url / audio_url Вхідні відео/аудіо (від'ясова редакція, липсинк, аватари).
• Для музики: title, style, instrumental, version (V4...V5_5).

Точний ціна конкретної конфігурації до запуску показує POST /media/estimate з такими ж model + input.

Вартість та зберігання

• Виписано з вашого балансу в USD по фактичній вартості генерації точна сума, видно на cost_usd після завершення.
• Неудавні генерації (помилка постачальника) не тарифіруються резервова повертається автоматично.
• Файли зберігаються на наших серверах ** обмежений час** (див. retention_days в /media/models) завантажуйте, щоб зберегти.