Медіа API — зображення, відео, музика

Генеруйте зображення, відео та музику тим самим ключем sk-nr-… і з того самого балансу, що й текстові моделі. Єдиний рахунок, оплата за фактом, без підписок і пакетів.

• База: https://nordrouter.com (або https://global-api.nordrouter.com для закордонних мереж).
• Автентифікація: заголовок Authorization: Bearer sk-nr-… (або X-API-Key: sk-nr-…).
• Формат: JSON, генерація асинхронна (створити завдання → опитувати → отримати файл).

Ендпоінти

Метод	Призначення
POST /media/generate	Створити завдання генерації
GET /media/job/:id	Статус і результат завдання
POST /media/estimate	Дізнатися ціну конфігурації заздалегідь
GET /media/models	Машиночитаний список моделей і параметрів
POST /media/upload	Завантажити вхідний медіафайл
GET /media/file/:id	Готовий файл (посилання з result_url)

Життєвий цикл запиту

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

curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-ВАШ-КЛЮЧ" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-2.6-i2v",
        "input": { "prompt": "плавний наїзд камери", "image": "https://…/photo.png", "duration": "5", "audio": true } }'

{ "id": "b1f2…", "model": "video/kling-2.6-i2v", "status": "processing", "poll": "https://nordrouter.com/media/job/b1f2…" }

2. Опитувати статус (раз на 3–5 сек)

curl https://nordrouter.com/media/job/b1f2…

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

3. Отримати файл — за result_url. Посилання на nordrouter.com (ваш бренд); файли зберігаються 14 днів, потім видаляються — завантажуйте або переносіть до себе заздалегідь.

Завантаження вхідних медіафайлів

Поля image, image2, audio_url і video_url приймають пряме публічне посилання. Моделі з полем attachments приймають масив об’єктів, які повернув POST /media/upload: надішліть { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }, потім передайте всю відповідь завантажувача в input.attachments. Для Suno можна натомість передати публічний URL в input.source_url, а для mashup — два URL в input.source_urls.

Білінг

Кошти списуються з вашого доларового балансу (того самого, що й у текстових моделей) — за фактом виконаної генерації, рівно на суму з таблиць нижче.

• Резерв → факт. Під час створення завдання резервується оцінена вартість; після завершення сума перераховується за фактичним результатом, надлишок повертається на баланс.
• Відео — посекундно. Ціна зростає з тривалістю та роздільною здатністю; з увімкненим звуком — дорожче. У таблицях указано ціну «від» для типових налаштувань, позначка /сек — тариф за секунду.
• Помилка не тарифікується. Якщо завдання завершилося зі статусом failed, резерв повертається повністю — платите лише за успішні генерації.
• Точна ціна заздалегідь — POST /media/estimate з тими самими model + input поверне { "usd": … } до запуску.
• Поповнення балансу — у рублях (≈ $1 = 89–96 ₽); далі все обчислюється в USD.

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

Ціна: для відео — ставка за секунду (/сек), підсумок = ставка × тривалість (роздільна здатність і звук можуть її змінювати); для решти — за одну генерацію з налаштуваннями за замовчуванням. Точну вартість будь-якої конфігурації повертає POST /media/estimate.

Полів у input може бути більше — машиночитаний список (типи, варіанти, значення за замовчуванням, діапазони секунд) завжди повертає GET /media/models. Обов’язкові позначено *. Будь-які додаткові поля моделі (negative_prompt, seed, cfg_scale…) можна надсилати прямо в input.

Попередні назви параметрів

19 жовтня 2026 параметри отримали єдині назви та значення: snake_case, значення малими літерами (наприклад, version: "v6-wild", resolution: "720p", audio: true). Назви та значення з попередньої версії документації й надалі приймаються — інтеграції, написані раніше, змінювати не потрібно: завдання, результат і ціна ті самі. У GET /media/models, MCP і цій документації — лише нові. Якщо в запиті надійшли і попередня, і нова назва одного параметра — діє нова.

🖼 Зображення

model	Режим	Параметри input	Файл	Ціна
image/nano-banana	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3|3:2|2:3|21:9|auto, safety_filter=bool	PNG	$0.025
image/nano-banana-2	текст→зображення	prompt *, aspect_ratio=auto|1:1|16:9|9:16|3:4|4:3|21:9, resolution=1k|2k|4k, image=url, safety_filter=bool	PNG	$0.050
image/nano-banana-2-lite	текст→зображення	prompt *, aspect_ratio=auto|1:1|16:9|9:16|3:4|4:3, image=url, safety_filter=bool	PNG	$0.025
image/nano-banana-pro	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3|21:9|auto, resolution=1k|2k|4k, image=url, safety_filter=bool	PNG	$0.11
image/imagen4-fast	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool	PNG	$0.025
image/imagen4	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool	PNG	$0.050
image/imagen4-ultra	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool	PNG	$0.075
image/gpt-image-1.5	текст→зображення	prompt *, aspect_ratio=1:1|2:3|3:2, quality=medium|high, safety_filter=bool	PNG	$0.025
image/gpt-image-1.5-edit	редагування зображення	prompt *, image=url *, aspect_ratio=3:2|1:1|2:3, quality=medium|high, safety_filter=bool	PNG	$0.025
image/gpt-image-2	текст→зображення	prompt *, aspect_ratio=1:1|3:2|2:3|16:9|9:16|4:3|3:4, resolution=1k|2k|4k	PNG	$0.006
image/gpt-image-2-edit	редагування зображення	prompt *, image=url *, aspect_ratio=auto|1:1|3:2|2:3|16:9|9:16, resolution=1k|2k|4k, safety_filter=bool	PNG	$0.037
image/flux2-pro	текст→зображення	prompt *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|3:2|2:3, resolution=1k|2k, safety_filter=bool	PNG	$0.031
image/flux2-pro-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|3:2|2:3|auto, resolution=1k|2k, safety_filter=bool	PNG	$0.031
image/flux2-flex	текст→зображення	prompt *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|3:2|2:3, resolution=1k|2k, safety_filter=bool	PNG	$0.087
image/flux2-flex-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|3:2|2:3|auto, resolution=1k|2k, safety_filter=bool	PNG	$0.087
image/seedream-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1-hd|1:1|3:4|9:16|4:3|16:9, resolution=1k|2k|4k, safety_filter=bool	PNG	$0.037
image/seedream-4.5-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|2:3|3:2, quality=basic|high, safety_filter=bool	PNG	$0.044
image/seedream-5-lite-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|2:3|3:2, quality=basic|high, safety_filter=bool	PNG	$0.037
image/seedream-5.0-pro-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1|4:3|3:4|16:9|9:16|2:3|3:2|21:9, quality=basic|high, safety_filter=bool	PNG	$0.044
image/ideogram-v3	текст→зображення	prompt *, render_mode=fast|balanced|quality, aspect_ratio=1:1-hd|1:1|3:4|9:16|4:3|16:9, style=auto|general|realistic|design, safety_filter=bool	PNG	$0.044
image/ideogram-edit	редагування зображення	prompt *, image=url *, render_mode=fast|balanced|quality, aspect_ratio=1:1-hd|1:1|3:4|9:16|4:3|16:9, safety_filter=bool	PNG	$0.044
image/ideogram-character	редагування зображення	prompt *, image=url *, render_mode=fast|balanced|quality, style=auto|realistic|fiction, safety_filter=bool	PNG	$0.11
image/qwen	текст→зображення	prompt *, aspect_ratio=1:1-hd|1:1|3:4|9:16|4:3|16:9, safety_filter=bool	PNG	$0.031
image/qwen-edit	редагування зображення	prompt *, image=url *, aspect_ratio=1:1-hd|1:1|3:4|9:16|4:3|16:9, safety_filter=bool	PNG	$0.037
image/qwen-i2i	редагування зображення	prompt *, image=url *, safety_filter=bool	PNG	$0.031
image/qwen2-edit	редагування зображення	prompt *, image=url *, aspect_ratio=16:9|1:1|3:4|4:3|9:16|3:2|2:3, safety_filter=bool	PNG	$0.037
image/grok	текст→зображення	prompt *, aspect_ratio=1:1|2:3|3:2|16:9|9:16, pro=bool, safety_filter=bool	PNG	$0.025
image/grok-edit	редагування зображення	prompt *, image=url *, safety_filter=bool	PNG	$0.025
image/z-image	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool	PNG	$0.006
image/wan-2.7	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4|21:9, resolution=1k|2k|4k, image=url, safety_filter=bool	PNG	$0.031
image/wan-2.7-pro	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4|21:9, resolution=1k|2k|4k, image=url, safety_filter=bool	PNG	$0.075
image/seedream-5.0-pro	текст→зображення	prompt *	JPG	$0.013
image/gemini-3.1-flash	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4, resolution=1k|2k|4k	PNG	$0.013
image/gemini-3-pro	текст→зображення	prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4, resolution=1k|2k|4k	PNG	$0.031

🎬 Відео

model	Режим	Параметри input	Файл	Ціна
video/veo-3.1-fast	текст→відео	prompt *, aspect_ratio=16:9|9:16, image=url	MP4	$0.38
video/veo-3.1-quality	текст→відео	prompt *, aspect_ratio=16:9|9:16, image=url	MP4	$1.56
video/veo-3.1-lite	текст→відео	prompt *, aspect_ratio=16:9|9:16, image=url	MP4	$0.19
video/gemini-omni	текст→відео	prompt *, duration=4|6|8|10 *, aspect_ratio=16:9|9:16, resolution=720p|1080p|4k, image=url, safety_filter=bool	MP4	$0.66
video/gemini-omni-flash	текст→відео	prompt *, attachments=upload[]	MP4	$0.13
video/kling-3.0	текст→відео	prompt *, duration=3–15с, aspect_ratio=16:9|9:16|1:1, mode=standard|pro|4k, audio=bool, image=url, image2=url, safety_filter=bool	MP4	$0.11/сек
video/kling-t2v	текст→відео	prompt *, duration=3–15с, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool	MP4	$0.11/сек
video/kling-turbo-i2v	фото→відео	prompt *, image=url *, duration=3–15с, resolution=720p|1080p, safety_filter=bool	MP4	$0.11/сек
video/kling-2.6-t2v	текст→відео	prompt *, duration=5|10, aspect_ratio=16:9|9:16|1:1, audio=bool, safety_filter=bool	MP4	$0.34
video/kling-2.6-i2v	фото→відео	prompt *, image=url *, duration=5|10, audio=bool, safety_filter=bool	MP4	$0.34
video/kling-2.5-t2v	текст→відео	prompt *, duration=5|10, aspect_ratio=16:9|9:16|1:1, safety_filter=bool	MP4	$0.26
video/kling-2.5-i2v	фото→відео	prompt *, image=url *, image2=url, duration=5|10, safety_filter=bool	MP4	$0.26
video/kling-i2v	фото→відео	prompt *, image=url *, image2=url, duration=5|10, safety_filter=bool	MP4	$0.31
video/kling-2.1-standard	фото→відео	prompt *, image=url *, duration=5|10, safety_filter=bool	MP4	$0.16
video/kling-2.1-master-t2v	текст→відео	prompt *, duration=5|10, aspect_ratio=16:9|9:16|1:1, safety_filter=bool	MP4	$1.00
video/kling-2.1-master-i2v	фото→відео	prompt *, image=url *, duration=5|10, safety_filter=bool	MP4	$1.00
video/kling-motion	відео→відео	image=url *, video_url *, prompt, mode=standard|pro	MP4	$1.25
video/kling-avatar	аватар (фото+аудіо)	image=url *, audio_url *, prompt *	MP4	$0.75
video/kling-avatar-pro	аватар (фото+аудіо)	image=url *, audio_url *, prompt *	MP4	$1.50
video/wan-2.7-t2v	текст→відео	prompt *, duration=2–15с, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, audio_url, safety_filter=bool	MP4	$0.15/сек
video/wan-2.7-i2v	фото→відео	prompt *, image=url *, image2=url, duration=2–15с, resolution=720p|1080p, audio_url, safety_filter=bool	MP4	$0.15/сек
video/wan-2.7-r2v	фото→відео	prompt *, image=url *, duration=2–10с, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool	MP4	$0.15/сек
video/wan-2.7-edit	відео→відео	prompt *, video_url *, resolution=720p|1080p, audio_source=auto|original	MP4	$1.50
video/wan-t2v	текст→відео	prompt *, duration=5|10|15, resolution=720p|1080p, safety_filter=bool	MP4	$0.44
video/wan-i2v	фото→відео	prompt *, image=url *, duration=5|10|15, resolution=720p|1080p, safety_filter=bool	MP4	$0.44
video/wan-v2v	відео→відео	prompt *, video_url *, duration=5|10, resolution=720p|1080p	MP4	$0.44
video/wan-2.5-t2v	текст→відео	prompt *, duration=5|10 *, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool	MP4	$0.38
video/wan-2.5-i2v	фото→відео	prompt *, image=url *, duration=5|10 *, resolution=720p|1080p, safety_filter=bool	MP4	$0.38
video/wan-2.2-t2v	текст→відео	prompt *, aspect_ratio=16:9|9:16, resolution=480p|720p, safety_filter=bool	MP4	$0.50
video/wan-2.2-i2v	фото→відео	prompt *, image=url *, resolution=480p|720p, safety_filter=bool	MP4	$0.50
video/wan-s2v	аватар (фото+аудіо)	prompt *, image=url *, audio_url *, resolution=480p|580p|720p	MP4	$0.38
video/wan-animate-move	відео→відео	image=url *, video_url *, resolution=480p|580p|720p	MP4	$0.38
video/wan-animate-replace	відео→відео	image=url *, video_url *, resolution=480p|580p|720p	MP4	$0.38
video/seedance-2	текст→відео	prompt *, duration=4–15с, aspect_ratio=16:9|9:16|1:1|4:3|21:9, resolution=480p|720p|1080p|4k, audio=bool, image=url, image2=url, safety_filter=bool	MP4	$0.26/сек
video/seedance-2-fast	текст→відео	prompt *, duration=4–15с, aspect_ratio=16:9|9:16|1:1, resolution=480p|720p, audio=bool, image=url, image2=url, safety_filter=bool	MP4	$0.21/сек
video/seedance-2-mini	текст→відео	prompt *, duration=4–15с, aspect_ratio=16:9|9:16|1:1, resolution=480p|720p, audio=bool, image=url, image2=url, safety_filter=bool	MP4	$0.13/сек
video/seedance-1.5-pro	текст→відео	prompt *, duration=4–12с, aspect_ratio=16:9|9:16|1:1|4:3, resolution=480p|720p|1080p, audio=bool, image=url, safety_filter=bool	MP4	$0.025/сек
video/hailuo-02-t2v	текст→відео	prompt *, duration=6|10, safety_filter=bool	MP4	$0.19
video/hailuo-02-t2v-pro	текст→відео	prompt *, safety_filter=bool	MP4	$0.36
video/hailuo-02-i2v	фото→відео	prompt *, image=url *, image2=url, duration=6|10, resolution=768p|512p, safety_filter=bool	MP4	$0.19
video/hailuo-02-i2v-pro	фото→відео	prompt *, image=url *, image2=url, safety_filter=bool	MP4	$0.36
video/hailuo-2.3-i2v	фото→відео	prompt *, image=url *, duration=6|10, resolution=768p|1080p, safety_filter=bool	MP4	$0.19
video/hailuo-2.3-i2v-pro	фото→відео	prompt *, image=url *, duration=6|10, resolution=768p|1080p, safety_filter=bool	MP4	$0.28
video/happyhorse-1.1-t2v	текст→відео	prompt *, duration=3–15с, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, safety_filter=bool	MP4	$0.18/сек
video/happyhorse-1.1-i2v	фото→відео	prompt, image=url *, duration=3–15с, resolution=720p|1080p, safety_filter=bool	MP4	$0.18/сек
video/happyhorse-1.1-r2v	фото→відео	prompt *, image=url *, duration=3–15с, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool	MP4	$0.18/сек
video/happyhorse-t2v	текст→відео	prompt *, duration=3–15с, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, safety_filter=bool	MP4	$0.30/сек
video/happyhorse-i2v	фото→відео	prompt, image=url *, duration=3–15с, resolution=720p|1080p, safety_filter=bool	MP4	$0.30/сек
video/happyhorse-edit	відео→відео	prompt *, video_url *, resolution=720p|1080p, audio_source=auto|original	MP4	$1.50
video/grok-t2v	текст→відео	prompt *, duration=6–30с, aspect_ratio=16:9|9:16|1:1|3:2|2:3, resolution=480p|720p, mode=normal|fun|spicy, safety_filter=bool	MP4	$0.019/сек
video/grok-i2v	фото→відео	prompt *, image=url *, duration=6–30с, resolution=480p|720p, mode=normal|fun|spicy, safety_filter=bool	MP4	$0.019/сек
video/grok-1.5	текст→відео	prompt *, duration=1–15с, aspect_ratio=auto|16:9|9:16|1:1, resolution=480p|720p, image=url, safety_filter=bool	MP4	$0.019/сек
video/omnihuman	аватар (фото+аудіо)	image=url *, audio_url *, prompt, resolution=720p|1080p	MP4	$1.69
video/infinitalk	аватар (фото+аудіо)	prompt *, image=url *, audio_url *, resolution=480p|720p	MP4	$0.19
video/lipsync	відео→відео	video_url *, audio_url *, mode=lite|basic	MP4	$0.50
video/topaz-upscale	апскейл	video_url *, scale=2|4	MP4	$0.50

🎵 Музика

model	Режим	Параметри input	Файл	Ціна
music/suno-v5	музика	title *, style *, version=v6|v6-wild|v6-mini, instrumental=bool, prompt	MP3	$0.075
music/suno-cover	музика	prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, instrumental=bool, advanced=bool, title, style, duration=10–360с	MP3	$0.075
music/suno-extend-upload	музика	prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, continue_from=1–120, instrumental=bool	MP3	$0.075
music/suno-add-vocals	музика	prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, style, title, exclude_styles, vocal=female|male	MP3	$0.075
music/suno-add-instrumental	музика	prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, title, exclude_styles	MP3	$0.075
music/suno-mashup	музика	prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, instrumental=bool, advanced=bool, title, style, duration=10–360с	MP3	$0.075
music/suno-sounds	музика	prompt *, version=v6|v6-wild|v6-mini, loop=bool, bpm=auto|60|80|100|120|140|160, tonality=auto|C|Dm|Em|F|G|Am|D#m	MP3	$0.016

🎙 Аудіо

model	Режим	Параметри input	Файл	Ціна
audio/gemini-3.1-flash-tts	озвучення	text *, voice=Achernar|Achird|Algenib|Algieba|Alnilam|Aoede|Autonoe|Callirrhoe|Charon|Despina|Enceladus|Erinome|Fenrir|Gacrux|Iapetus|Kore|Laomedeia|Leda|Orus|Puck|Pulcherrima|Rasalgethi|Sadachbia|Sadaltager|Schedar|Sulafat|Umbriel|Vindemiatrix|Zephyr|Zubenelgenubi, style=vocal-smile|newscaster|whisper|empathetic|promo-hype|deadpan, pace=natural|fast|slow|staccato, accent=neutral|american|american-valley|american-south|british|british-brixton|transatlantic|australian, voice_description, scene, temperature=0–2	WAV	$0.006
audio/gemini-2.5-pro-tts	озвучення	text *, voice=Achernar|Achird|Algenib|Algieba|Alnilam|Aoede|Autonoe|Callirrhoe|Charon|Despina|Enceladus|Erinome|Fenrir|Gacrux|Iapetus|Kore|Laomedeia|Leda|Orus|Puck|Pulcherrima|Rasalgethi|Sadachbia|Sadaltager|Schedar|Sulafat|Umbriel|Vindemiatrix|Zephyr|Zubenelgenubi, style=vocal-smile|newscaster|whisper|empathetic|promo-hype|deadpan, pace=natural|fast|slow|staccato, accent=neutral|american|american-valley|american-south|british|british-brixton|transatlantic|australian, voice_description, scene, temperature=0–2	WAV	$0.006
audio/elevenlabs-tts	озвучення	text *, voice=james|addison|adeline|allison|ana-rita|anika|arabella|aria|bella|benjamin|bradford|brian|britney|brittney|brock|burt|callum|cassidy|ed|edward|emma|eve|felix|finn|hank|hope-poetic|hope-bubbly|horatius|jamahal|jean|jeff|jessica-eloquent|jessica-chatty|john-doe|john-morgan|johnny-dynamite|johnny-kid|kuon|laura|leon|liam|lucy|lutz|mark-casual|mark-natural|marshal|monika|nathan|nathaniel|phil|rachel|rex-thunder|sam|spuds|sven|taksh|theodore|tiffany|tom|viking-bjorn|viraj-smooth|viraj-rich|wyatt|xavier, voice_id, speed=0.8|1.0|1.2	MP3	$0.037
audio/elevenlabs-multilingual	озвучення	text *, voice=james|addison|adeline|allison|ana-rita|anika|arabella|aria|bella|benjamin|bradford|brian|britney|brittney|brock|burt|callum|cassidy|ed|edward|emma|eve|felix|finn|hank|hope-poetic|hope-bubbly|horatius|jamahal|jean|jeff|jessica-eloquent|jessica-chatty|john-doe|john-morgan|johnny-dynamite|johnny-kid|kuon|laura|leon|liam|lucy|lutz|mark-casual|mark-natural|marshal|monika|nathan|nathaniel|phil|rachel|rex-thunder|sam|spuds|sven|taksh|theodore|tiffany|tom|viking-bjorn|viraj-smooth|viraj-rich|wyatt|xavier, voice_id, speed=0.8|1.0|1.2	MP3	$0.075

🧊 3D-моделі

На виході — GLB (у частини моделей на вибір OBJ, FBX, STL, USDZ, USD, 3MF) плюс зображення для попереднього перегляду: у завданні надходить кілька файлів, кожен зі своїм розширенням. Список файлів — у полі results, кожен має ext.

Ціна відома лише після генерації

3D тарифікується за фактично витраченими ресурсами. Ми утримуємо верхню межу з таблиці, а коли стане відома справжня вартість — списуємо її та повертаємо різницю. Підсумок завжди в cost_usd.

model	Режим	Параметри input	Файл	Ціна
3d/tripo-text	текст→3D	prompt *, negative_prompt, texture_detail=standard|high, geometry_detail=standard|high, pbr=bool, quad_mesh=bool	GLB/FBX	$0.31–0.79
3d/tripo-image	фото→3D	image=url *, texture_detail=standard|high, geometry_detail=standard|high, pbr=bool, quad_mesh=bool	GLB/FBX	$0.31–0.79
3d/hunyuan-rapid-text	текст→3D	prompt *, file_format=glb|obj|fbx|stl|usdz, pbr=bool, extra_mesh=bool	GLB та ін.	$0.43–0.71
3d/hunyuan-rapid-image	фото→3D	image=url *, file_format=glb|obj|fbx|stl|usdz, pbr=bool, extra_mesh=bool	GLB та ін.	$0.43–0.71
3d/hunyuan-pro-text	текст→3D	prompt *, output=textured|mesh, polygons=auto|40000|100000|300000|800000|1500000, pbr=bool	GLB	$0.71–1.00
3d/hunyuan-pro-image	фото→3D	image=url *, output=textured|mesh, polygons=auto|40000|100000|300000|800000|1500000, pbr=bool	GLB	$0.71–1.00
3d/seed3d-image	фото→3D	image=url *, mesh_detail=low|medium|high, file_format=glb|obj|usd|usdz	GLB/OBJ/USD	$0.50
3d/meshy-text	текст→3D	prompt *, texture_size=2k|4k|8k, pose=none|a-pose|t-pose, ultra=bool, pbr=bool, texture_text, texture_photo=url	GLB	$0.94–1.26
3d/meshy-image	фото→3D	image=url *, texture_size=2k|4k|8k, ultra=bool, texture=bool, pbr=bool, texture_text, texture_photo=url	GLB	$0.94–1.26
3d/meshy-multi-image	ракурси→3D	images=[url] * (1–4), texture_size=2k|4k|8k, ultra=bool, texture=bool, pbr=bool, texture_text	GLB	$0.94–1.26

Фото як текстура. У 3d/meshy-* текстура задається окремо від геометрії: зображенням у texture_photo або словами в texture_text.

Довго. Генерація 3D триває від пів хвилини до кількох хвилин — довше за зображення та короткий кліп. Тримати з’єднання не потрібно: статус зберігається, є вебхуки.

🛠 Утиліти

model	Режим	Параметри input	Файл	Ціна
image/topaz-upscale	апскейл	image=url *, scale=2|4|8	PNG	$0.063
image/recraft-remove-bg	редагування	image=url *	PNG	$0.006
image/recraft-upscale	апскейл	image=url *	PNG	$0.006

Приклади за режимами

Зображення з тексту

{ "model": "image/flux2-pro", "input": { "prompt": "neon fox in snow", "aspect_ratio": "16:9", "resolution": "2k" } }

Редагування зображення

{ "model": "image/seedream-edit", "input": { "prompt": "прибрати фон, додати неон", "image": "https://…/photo.png" } }

Фото→відео (перший/останній кадр, тривалість, звук)

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "плавний наїзд камери", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

Музика

{ "model": "music/suno-v5", "input": { "title": "Northern Lights", "style": "epic orchestral", "instrumental": true, "version": "v6" } }

Озвучення

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "text": "Привіт, світе", "voice": "Zephyr", "style": "empathetic",
    "pace": "natural", "accent": "neutral" } }

Діалог двох голосів — замість поля text репліки в dialogue, голоси в voices (голос 1 — перший у списку):

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "Добрий вечір!" }, { "speaker": 2, "text": "Радий чути." } ] } }

Аватар (відео з мовленням із фото + аудіо)

{ "model": "video/omnihuman", "input": { "image": "https://…/face.png", "audio_url": "https://…/voice.mp3" } }

Статуси та помилки

GET /media/job/:id → поле status:

Статус	Значення
processing	У роботі — продовжуйте опитування
done	Готово — файл у result_url, списання в cost_usd
failed	Помилка — причина в error, кошти повернено

Коди відповіді POST /media/generate: 400 — невідома модель або бракує обов’язкового поля; 401 — ключ відсутній або некоректний; 402 — недостатньо коштів на балансі; 403 — модель недоступна для облікового запису.

Тіло помилки завжди одного вигляду — { "error": "текст для человека", "code": "машинный код" }. Коди: unknown_model, missing_param (+ поле param), invalid_input, invalid_attachment, prompt_too_long, input_too_long, no_auth, no_key, insufficient_balance, unpaid_shortfall, rate_limited, generation_failed, unavailable.

Попередня оцінка вартості

curl https://nordrouter.com/media/estimate \
  -H "Authorization: Bearer sk-nr-ВАШ-КЛЮЧ" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-3.0", "input": { "duration": 10, "mode": "pro", "audio": true } }'

{ "model": "video/kling-3.0", "usd": 1.6875 }

---

Параметри в таблицях звірено з каталогом сервісу 19.10.2026; повний актуальний список моделей, параметрів і цін — GET /media/models.