API multimediów — obrazy, wideo, muzyka

Generuj obrazy, wideo i muzykę tym samym kluczem sk-nr-… i z tego samego salda co modele tekstowe. Jedno saldo, płatność za faktyczne użycie, bez subskrypcji i pakietów.

Adres bazowy: https://nordrouter.com (lub https://global-api.nordrouter.com w przypadku sieci zagranicznych).
Uwierzytelnianie: nagłówek Authorization: Bearer sk-nr-… (lub X-API-Key: sk-nr-…).
Format: JSON, generowanie asynchroniczne (utwórz zadanie → odpytuj → pobierz plik).

Endpointy

Metoda	Przeznaczenie
`POST /media/generate`	Utworzenie zadania generowania
`GET /media/job/:id`	Status i wynik zadania
`POST /media/estimate`	Wcześniejsze sprawdzenie ceny konfiguracji
`GET /media/models`	Lista modeli i parametrów w formacie do odczytu maszynowego
`POST /media/upload`	Przesłanie źródłowego pliku multimedialnego
`GET /media/file/:id`	Gotowy plik (link z `result_url`)

Cykl życia żądania

1. Utwórz zadanie

bash

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

json

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

2. Odpytuj status (co 3–5 sek.)

bash

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

json

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

3. Pobierz plik — za pomocą result_url. Link prowadzi do nordrouter.com (Twojej marki); pliki są przechowywane przez 14 dni, a następnie usuwane — pobierz je lub wcześniej przenieś do siebie.

Przesyłanie źródłowych plików multimedialnych

Pola image, image2, audio_url i video_url przyjmują bezpośredni publiczny link. Modele z polem attachments przyjmują tablicę obiektów zwróconych przez POST /media/upload: wyślij { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }, a następnie przekaż całą odpowiedź z endpointu przesyłania w input.attachments. W przypadku Suno można zamiast tego przekazać publiczny URL w input.source_url, a w przypadku mashup — dwa URL-e w input.source_urls.

Rozliczenia

Opłaty są pobierane z Twojego salda w dolarach (tego samego co w przypadku modeli tekstowych) po faktycznym wykonaniu generowania, dokładnie w wysokości podanej w poniższych tabelach.

Rezerwacja → rozliczenie faktyczne. Przy tworzeniu zadania rezerwowana jest szacunkowa kwota; po zakończeniu koszt jest przeliczany na podstawie faktycznego wyniku, a nadwyżka wraca na saldo.
Wideo — rozliczenie za sekundę. Cena rośnie wraz z czasem trwania i rozdzielczością; włączony dźwięk podnosi cenę. Tabele podają cenę „od” dla ustawień domyślnych, oznaczenie /sek to stawka za sekundę.
Błędy nie są naliczane. Jeśli zadanie zakończy się ze statusem failed, cała rezerwa zostanie zwrócona — płacisz tylko za udane generowania.
Dokładną cenę można sprawdzić wcześniej — POST /media/estimate z tymi samymi model + input zwróci { "usd": … } przed uruchomieniem.
Doładowanie salda odbywa się w rublach (≈ $1 = 89–96 ₽); dalsze rozliczenia są prowadzone w USD.

Katalog modeli

Cena: dla wideo — stawka za sekundę (/s), koszt końcowy = stawka × czas trwania (rozdzielczość i dźwięk mogą zmieniać stawkę); dla pozostałych — za jedną generację przy ustawieniach domyślnych. Dokładny koszt dowolnej konfiguracji zwraca POST /media/estimate.

Pól w input może być więcej — listę w formacie do odczytu maszynowego (typy, opcje, wartości domyślne, zakresy czasu w sekundach) zawsze zwraca GET /media/models. Wymagane pola oznaczono *. Wszelkie dodatkowe pola modelu (negative_prompt, seed, cfg_scale…) można przesyłać bezpośrednio w input.

Poprzednie nazwy parametrów

19 października 2026 parametry otrzymały ujednolicone nazwy i wartości: snake_case, wartości małymi literami (np. version: "v6-wild", resolution: "720p", audio: true). Nazwy i wartości z poprzedniej wersji dokumentacji są nadal akceptowane — wcześniejszych integracji nie trzeba zmieniać: zadanie, wynik i cena pozostają takie same. W GET /media/models, MCP i tej dokumentacji są tylko nowe. Jeśli żądanie zawiera poprzednią i nową nazwę tego samego parametru — obowiązuje nowa.

🖼 Obrazy

`model`	Tryb	Parametry `input`	Plik	Cena
`image/nano-banana`	tekst→obraz	`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`	tekst→obraz	`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`	tekst→obraz	`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`	tekst→obraz	`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`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.025
`image/imagen4`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.050
`image/imagen4-ultra`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.075
`image/gpt-image-1.5`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-1.5-edit`	edycja obrazu	`prompt` , `image`=url , `aspect_ratio`=3:2\|1:1\|2:3, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-2`	tekst→obraz	`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`	edycja obrazu	`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`	tekst→obraz	`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`	edycja obrazu	`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`	tekst→obraz	`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`	edycja obrazu	`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`	edycja obrazu	`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`	edycja obrazu	`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`	edycja obrazu	`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`	edycja obrazu	`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`	tekst→obraz	`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`	edycja obrazu	`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`	edycja obrazu	`prompt` , `image`=url , `render_mode`=fast\|balanced\|quality, `style`=auto\|realistic\|fiction, `safety_filter`=bool	PNG	$0.11
`image/qwen`	tekst→obraz	`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`	edycja obrazu	`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`	edycja obrazu	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.031
`image/qwen2-edit`	edycja obrazu	`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`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2\|16:9\|9:16, `pro`=bool, `safety_filter`=bool	PNG	$0.025
`image/grok-edit`	edycja obrazu	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.025
`image/z-image`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.006
`image/wan-2.7`	tekst→obraz	`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`	tekst→obraz	`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`	tekst→obraz	`prompt` *	JPG	$0.013
`image/gemini-3.1-flash`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.013
`image/gemini-3-pro`	tekst→obraz	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.031

🎬 Wideo

`model`	Tryb	Parametry `input`	Plik	Cena
`video/veo-3.1-fast`	tekst→wideo	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.38
`video/veo-3.1-quality`	tekst→wideo	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$1.56
`video/veo-3.1-lite`	tekst→wideo	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.19
`video/gemini-omni`	tekst→wideo	`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`	tekst→wideo	`prompt` *, `attachments`=upload[]	MP4	$0.13
`video/kling-3.0`	tekst→wideo	`prompt` *, `duration`=3–15 s, `aspect_ratio`=16:9\|9:16\|1:1, `mode`=standard\|pro\|4k, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.11/s
`video/kling-t2v`	tekst→wideo	`prompt` *, `duration`=3–15 s, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/s
`video/kling-turbo-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=3–15 s, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/s
`video/kling-2.6-t2v`	tekst→wideo	`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`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=5\|10, `audio`=bool, `safety_filter`=bool	MP4	$0.34
`video/kling-2.5-t2v`	tekst→wideo	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$0.26
`video/kling-2.5-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.26
`video/kling-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.31
`video/kling-2.1-standard`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$0.16
`video/kling-2.1-master-t2v`	tekst→wideo	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$1.00
`video/kling-2.1-master-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$1.00
`video/kling-motion`	wideo→wideo	`image`=url , `video_url` , `prompt`, `mode`=standard\|pro	MP4	$1.25
`video/kling-avatar`	awatar (zdjęcie+audio)	`image`=url , `audio_url` , `prompt` *	MP4	$0.75
`video/kling-avatar-pro`	awatar (zdjęcie+audio)	`image`=url , `audio_url` , `prompt` *	MP4	$1.50
`video/wan-2.7-t2v`	tekst→wideo	`prompt` *, `duration`=2–15 s, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/s
`video/wan-2.7-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `image2`=url, `duration`=2–15 s, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/s
`video/wan-2.7-r2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=2–10 s, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.15/s
`video/wan-2.7-edit`	wideo→wideo	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/wan-t2v`	tekst→wideo	`prompt` *, `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-v2v`	wideo→wideo	`prompt` , `video_url` , `duration`=5\|10, `resolution`=720p\|1080p	MP4	$0.44
`video/wan-2.5-t2v`	tekst→wideo	`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`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=5\|10 *, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.38
`video/wan-2.2-t2v`	tekst→wideo	`prompt` *, `aspect_ratio`=16:9\|9:16, `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-2.2-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-s2v`	awatar (zdjęcie+audio)	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-move`	wideo→wideo	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-replace`	wideo→wideo	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/seedance-2`	tekst→wideo	`prompt` *, `duration`=4–15 s, `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/s
`video/seedance-2-fast`	tekst→wideo	`prompt` *, `duration`=4–15 s, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.21/s
`video/seedance-2-mini`	tekst→wideo	`prompt` *, `duration`=4–15 s, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.13/s
`video/seedance-1.5-pro`	tekst→wideo	`prompt` *, `duration`=4–12 s, `aspect_ratio`=16:9\|9:16\|1:1\|4:3, `resolution`=480p\|720p\|1080p, `audio`=bool, `image`=url, `safety_filter`=bool	MP4	$0.025/s
`video/hailuo-02-t2v`	tekst→wideo	`prompt` *, `duration`=6\|10, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-t2v-pro`	tekst→wideo	`prompt` *, `safety_filter`=bool	MP4	$0.36
`video/hailuo-02-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `image2`=url, `duration`=6\|10, `resolution`=768p\|512p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-i2v-pro`	zdjęcie→wideo	`prompt` , `image`=url , `image2`=url, `safety_filter`=bool	MP4	$0.36
`video/hailuo-2.3-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-2.3-i2v-pro`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.28
`video/happyhorse-1.1-t2v`	tekst→wideo	`prompt` *, `duration`=3–15 s, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/s
`video/happyhorse-1.1-i2v`	zdjęcie→wideo	`prompt`, `image`=url *, `duration`=3–15 s, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/s
`video/happyhorse-1.1-r2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=3–15 s, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/s
`video/happyhorse-t2v`	tekst→wideo	`prompt` *, `duration`=3–15 s, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/s
`video/happyhorse-i2v`	zdjęcie→wideo	`prompt`, `image`=url *, `duration`=3–15 s, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/s
`video/happyhorse-edit`	wideo→wideo	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/grok-t2v`	tekst→wideo	`prompt` *, `duration`=6–30 s, `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/s
`video/grok-i2v`	zdjęcie→wideo	`prompt` , `image`=url , `duration`=6–30 s, `resolution`=480p\|720p, `mode`=normal\|fun\|spicy, `safety_filter`=bool	MP4	$0.019/s
`video/grok-1.5`	tekst→wideo	`prompt` *, `duration`=1–15 s, `aspect_ratio`=auto\|16:9\|9:16\|1:1, `resolution`=480p\|720p, `image`=url, `safety_filter`=bool	MP4	$0.019/s
`video/omnihuman`	awatar (zdjęcie+audio)	`image`=url , `audio_url` , `prompt`, `resolution`=720p\|1080p	MP4	$1.69
`video/infinitalk`	awatar (zdjęcie+audio)	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|720p	MP4	$0.19
`video/lipsync`	wideo→wideo	`video_url` , `audio_url` , `mode`=lite\|basic	MP4	$0.50
`video/topaz-upscale`	zwiększanie rozdzielczości	`video_url` *, `scale`=2\|4	MP4	$0.50

🎵 Muzyka

`model`	Tryb	Parametry `input`	Plik	Cena
`music/suno-v5`	muzyka	`title` , `style` , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `prompt`	MP3	$0.075
`music/suno-cover`	muzyka	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360 s	MP3	$0.075
`music/suno-extend-upload`	muzyka	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `continue_from`=1–120, `instrumental`=bool	MP3	$0.075
`music/suno-add-vocals`	muzyka	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `style`, `title`, `exclude_styles`, `vocal`=female\|male	MP3	$0.075
`music/suno-add-instrumental`	muzyka	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `title`, `exclude_styles`	MP3	$0.075
`music/suno-mashup`	muzyka	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360 s	MP3	$0.075
`music/suno-sounds`	muzyka	`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

🎙 Audio

`model`	Tryb	Parametry `input`	Plik	Cena
`audio/gemini-3.1-flash-tts`	synteza mowy	`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`	synteza mowy	`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`	synteza mowy	`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`	synteza mowy	`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

🧊 Modele 3D

Wynik — GLB (w części modeli do wyboru OBJ, FBX, STL, USDZ, USD, 3MF) oraz obraz podglądu: zadanie zwraca kilka plików, każdy z własnym rozszerzeniem. Lista plików znajduje się w polu results, każdy ma ext.

Cena jest znana dopiero po wygenerowaniu

3D jest rozliczane według faktycznie zużytych zasobów. Blokujemy kwotę odpowiadającą górnej granicy z tabeli, a gdy poznamy rzeczywisty koszt — pobieramy go i zwracamy różnicę. Końcowy koszt jest zawsze w cost_usd.

`model`	Tryb	Parametry `input`	Plik	Cena
`3d/tripo-text`	tekst→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`	zdjęcie→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`	tekst→3D	`prompt` *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB i inne	$0.43–0.71
`3d/hunyuan-rapid-image`	zdjęcie→3D	`image`=url *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB i inne	$0.43–0.71
`3d/hunyuan-pro-text`	tekst→3D	`prompt` *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/hunyuan-pro-image`	zdjęcie→3D	`image`=url *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/seed3d-image`	zdjęcie→3D	`image`=url *, `mesh_detail`=low\|medium\|high, `file_format`=glb\|obj\|usd\|usdz	GLB/OBJ/USD	$0.50
`3d/meshy-text`	tekst→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`	zdjęcie→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`	ujęcia→3D	`images`=[url] * (1–4), `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`	GLB	$0.94–1.26

Zdjęcie jako tekstura. W 3d/meshy-* teksturę określa się niezależnie od geometrii: obrazem w texture_photo lub słowami w texture_text.

Długi czas generowania. Generowanie 3D trwa od pół minuty do kilku minut — dłużej niż obrazu i krótkiego klipu. Nie trzeba utrzymywać połączenia: status jest zapisywany, dostępne są webhooki.

🛠 Narzędzia

`model`	Tryb	Parametry `input`	Plik	Cena
`image/topaz-upscale`	zwiększanie rozdzielczości	`image`=url *, `scale`=2\|4\|8	PNG	$0.063
`image/recraft-remove-bg`	edycja	`image`=url *	PNG	$0.006
`image/recraft-upscale`	zwiększanie rozdzielczości	`image`=url *	PNG	$0.006

Przykłady według trybów

Obraz z tekstu

json

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

Edycja obrazu

json

{ "model": "image/seedream-edit", "input": { "prompt": "usuń tło, dodaj neon", "image": "https://…/photo.png" } }

Zdjęcie→wideo (pierwsza/ostatnia klatka, czas trwania, dźwięk)

json

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "płynny najazd kamery", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

Muzyka

json

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

Synteza mowy

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "text": "Witaj, świecie", "voice": "Zephyr", "style": "empathetic",
    "pace": "natural", "accent": "neutral" } }

Dialog dwóch głosów — zamiast pola text wypowiedzi w dialogue, głosy w voices (głos 1 — pierwszy na liście):

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "Dobry wieczór!" }, { "speaker": 2, "text": "Miło słyszeć." } ] } }

Awatar (wideo z mówiącą postacią ze zdjęcia + audio)

json

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

Statusy i błędy

GET /media/job/:id → pole status:

Status	Znaczenie
`processing`	W trakcie — kontynuuj odpytywanie
`done`	Gotowe — plik w `result_url`, pobrana kwota w `cost_usd`
`failed`	Błąd — przyczyna w `error`, środki zwrócone

Kody odpowiedzi POST /media/generate: 400 — nieznany model lub brak wymaganego pola; 401 — brak klucza lub nieprawidłowy klucz; 402 — niewystarczające saldo; 403 — model niedostępny na koncie.

Treść błędu ma zawsze tę samą postać — { "error": "текст для человека", "code": "машинный код" }. Kody: unknown_model, missing_param (+ pole param), invalid_input, invalid_attachment, prompt_too_long, input_too_long, no_auth, no_key, insufficient_balance, unpaid_shortfall, rate_limited, generation_failed, unavailable.

Wstępne oszacowanie kosztu

bash

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

json

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

Parametry w tabelach zweryfikowano z katalogiem serwisu 19.10.2026; pełna aktualna lista modeli, parametrów i cen — GET /media/models.

API multimediów — obrazy, wideo, muzyka ​

Endpointy ​

Cykl życia żądania ​

Rozliczenia ​

Katalog modeli ​

Poprzednie nazwy parametrów ​

🖼 Obrazy ​

🎬 Wideo ​

🎵 Muzyka ​

🎙 Audio ​

🧊 Modele 3D ​

🛠 Narzędzia ​

Przykłady według trybów ​

Statusy i błędy ​

Wstępne oszacowanie kosztu ​

API multimediów — obrazy, wideo, muzyka

Endpointy

Cykl życia żądania

Rozliczenia

Katalog modeli

Poprzednie nazwy parametrów

🖼 Obrazy

🎬 Wideo

🎵 Muzyka

🎙 Audio

🧊 Modele 3D

🛠 Narzędzia

Przykłady według trybów

Statusy i błędy

Wstępne oszacowanie kosztu