API Media — gambar, video, musik

Buat gambar, video, dan musik dengan kunci sk-nr-… dan saldo yang sama dengan model teks. Satu tagihan, bayar sesuai penggunaan, tanpa langganan atau paket.

URL dasar: https://nordrouter.com (atau https://global-api.nordrouter.com untuk jaringan luar negeri).
Autentikasi: header Authorization: Bearer sk-nr-… (atau X-API-Key: sk-nr-…).
Format: JSON, generasi asinkron (buat tugas → periksa status secara berkala → ambil file).

Endpoint

Metode	Fungsi
`POST /media/generate`	Membuat tugas generasi
`GET /media/job/:id`	Status dan hasil tugas
`POST /media/estimate`	Mengetahui harga konfigurasi sebelum memulai
`GET /media/models`	Daftar model dan parameter yang dapat dibaca mesin
`POST /media/upload`	Mengunggah file media sumber
`GET /media/file/:id`	File hasil (tautan dari `result_url`)

Siklus hidup permintaan

1. Buat tugas

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": "kamera bergerak mendekat dengan mulus", "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. Periksa status secara berkala (setiap 3–5 detik)

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. Ambil file — melalui result_url. Tautan berada di nordrouter.com (merek Anda); file disimpan selama 14 hari, lalu dihapus — unduh atau pindahkan ke penyimpanan Anda sebelum masa tersebut berakhir.

Mengunggah file media sumber

Kolom image, image2, audio_url, dan video_url menerima tautan publik langsung. Model dengan kolom attachments menerima array objek yang dikembalikan oleh POST /media/upload: kirim { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }, lalu teruskan seluruh respons unggahan ke input.attachments. Untuk Suno, Anda dapat menggunakan URL publik di input.source_url sebagai gantinya, dan untuk mashup — dua URL di input.source_urls.

Penagihan

Biaya dipotong dari saldo dolar Anda (sama dengan saldo untuk model teks) — setelah generasi selesai, sesuai jumlah yang tercantum dalam tabel di bawah.

Reservasi → biaya aktual. Saat tugas dibuat, estimasi biaya dicadangkan; setelah selesai, jumlahnya dihitung ulang berdasarkan hasil aktual, dan kelebihannya dikembalikan ke saldo.
Video — per detik. Harga meningkat sesuai durasi dan resolusi; mengaktifkan suara menambah biaya. Tabel mencantumkan harga “mulai dari” untuk pengaturan default, tanda /detik menunjukkan tarif per detik.
Kegagalan tidak dikenai biaya. Jika tugas berakhir dengan status failed, seluruh dana yang dicadangkan dikembalikan — Anda hanya membayar generasi yang berhasil.
Harga pasti sebelum memulai — POST /media/estimate dengan model + input yang sama akan mengembalikan { "usd": … } sebelum generasi dimulai.
Pengisian saldo dilakukan dalam rubel (≈ $1 = 89–96 ₽); selanjutnya semua perhitungan menggunakan USD.

Katalog model

Harga: untuk video, tarif per detik (/detik), total = tarif × durasi (dan resolusi/audio dapat mengubahnya); untuk yang lain, harga untuk satu generasi dengan pengaturan default. Biaya pasti untuk konfigurasi apa pun dapat diketahui melalui POST /media/estimate.

input dapat memuat lebih banyak field — daftar yang dapat dibaca mesin (tipe, opsi, nilai default, rentang detik) selalu disediakan oleh GET /media/models. Field wajib ditandai dengan *. Field tambahan apa pun untuk model (negative_prompt, seed, cfg_scale…) dapat dikirim langsung di input.

Nama parameter sebelumnya

Pada 19 Oktober 2026, parameter diseragamkan: snake_case, nilai huruf kecil (misalnya, version: "v6-wild", resolution: "720p", audio: true). Nama dan nilai dari versi dokumentasi sebelumnya tetap diterima — integrasi yang dibuat sebelumnya tidak perlu diubah: tugas, hasil, dan harganya tetap sama. GET /media/models, MCP, dan dokumentasi ini hanya menggunakan nama baru. Jika permintaan menyertakan nama lama dan baru untuk parameter yang sama, nama baru yang berlaku.

🖼 Gambar

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

🎬 Video

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

🎵 Musik

`model`	Mode	Parameter `input`	File	Harga
`music/suno-v5`	musik	`title` , `style` , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `prompt`	MP3	$0.075
`music/suno-cover`	musik	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360d	MP3	$0.075
`music/suno-extend-upload`	musik	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `continue_from`=1–120, `instrumental`=bool	MP3	$0.075
`music/suno-add-vocals`	musik	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `style`, `title`, `exclude_styles`, `vocal`=female\|male	MP3	$0.075
`music/suno-add-instrumental`	musik	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `title`, `exclude_styles`	MP3	$0.075
`music/suno-mashup`	musik	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360d	MP3	$0.075
`music/suno-sounds`	musik	`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`	Mode	Parameter `input`	File	Harga
`audio/gemini-3.1-flash-tts`	sulih suara	`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`	sulih suara	`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`	sulih suara	`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`	sulih suara	`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

🧊 Model 3D

Output berupa GLB (sebagian model juga menyediakan pilihan OBJ, FBX, STL, USDZ, USD, 3MF) beserta gambar pratinjau: tugas menghasilkan beberapa file, masing-masing dengan ekstensi sendiri. Daftar file ada di field results; setiap file memiliki ext.

Harga baru diketahui setelah generasi

Biaya 3D dihitung berdasarkan sumber daya yang benar-benar digunakan. Kami menahan batas atas dari tabel, lalu setelah biaya sebenarnya diketahui, kami menagihnya dan mengembalikan selisihnya. Total selalu tercantum di cost_usd.

`model`	Mode	Parameter `input`	File	Harga
`3d/tripo-text`	teks→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`	foto→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`	teks→3D	`prompt` *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB dan lainnya	$0.43–0.71
`3d/hunyuan-rapid-image`	foto→3D	`image`=url *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB dan lainnya	$0.43–0.71
`3d/hunyuan-pro-text`	teks→3D	`prompt` *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/hunyuan-pro-image`	foto→3D	`image`=url *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/seed3d-image`	foto→3D	`image`=url *, `mesh_detail`=low\|medium\|high, `file_format`=glb\|obj\|usd\|usdz	GLB/OBJ/USD	$0.50
`3d/meshy-text`	teks→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`	foto→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`	berbagai sudut→3D	`images`=[url] * (1–4), `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`	GLB	$0.94–1.26

Foto sebagai tekstur. Pada 3d/meshy-*, tekstur ditentukan terpisah dari geometri: dengan gambar di texture_photo atau deskripsi teks di texture_text.

Proses lama. Generasi 3D memerlukan waktu mulai dari setengah menit hingga beberapa menit, lebih lama daripada gambar dan klip pendek. Koneksi tidak perlu tetap terbuka: status disimpan dan webhook tersedia.

🛠 Utilitas

`model`	Mode	Parameter `input`	File	Harga
`image/topaz-upscale`	upscale	`image`=url *, `scale`=2\|4\|8	PNG	$0.063
`image/recraft-remove-bg`	edit	`image`=url *	PNG	$0.006
`image/recraft-upscale`	upscale	`image`=url *	PNG	$0.006

Contoh berdasarkan mode

Gambar dari teks

json

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

Pengeditan gambar

json

{ "model": "image/seedream-edit", "input": { "prompt": "hapus latar belakang, tambahkan neon", "image": "https://…/photo.png" } }

Foto→video (bingkai pertama/terakhir, durasi, suara)

json

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "kamera bergerak mendekat dengan mulus", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

Musik

json

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

Sulih suara

json

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

Dialog dua suara — gunakan dialogue sebagai pengganti bidang text, dan voices untuk suara (suara 1 adalah suara pertama dalam daftar):

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "Selamat malam!" }, { "speaker": 2, "text": "Senang mendengarnya." } ] } }

Avatar (video berbicara dari foto + audio)

json

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

Status dan kesalahan

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

Status	Arti
`processing`	Sedang diproses — lanjutkan polling
`done`	Selesai — file ada di `result_url`, biaya tercatat di `cost_usd`
`failed`	Kesalahan — alasannya ada di `error`, dana dikembalikan

Kode respons POST /media/generate: 400 — model tidak dikenal atau bidang wajib tidak ada; 401 — kunci tidak ada atau rusak; 402 — saldo tidak mencukupi; 403 — model tidak tersedia di akun.

Isi kesalahan selalu memiliki format yang sama — { "error": "teks untuk pengguna", "code": "kode mesin" }. Kode: unknown_model, missing_param (+ bidang param), invalid_input, invalid_attachment, prompt_too_long, input_too_long, no_auth, no_key, insufficient_balance, unpaid_shortfall, rate_limited, generation_failed, unavailable.

Perkiraan biaya sebelumnya

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 }

Parameter dalam tabel telah dicocokkan dengan katalog layanan pada 19.10.2026; daftar lengkap model, parameter, dan harga terbaru — GET /media/models.

API Media — gambar, video, musik ​

Endpoint ​

Siklus hidup permintaan ​

Penagihan ​

Katalog model ​

Nama parameter sebelumnya ​

🖼 Gambar ​

🎬 Video ​

🎵 Musik ​

🎙 Audio ​

🧊 Model 3D ​

🛠 Utilitas ​

Contoh berdasarkan mode ​

Status dan kesalahan ​

Perkiraan biaya sebelumnya ​

API Media — gambar, video, musik

Endpoint

Siklus hidup permintaan

Penagihan

Katalog model

Nama parameter sebelumnya

🖼 Gambar

🎬 Video

🎵 Musik

🎙 Audio

🧊 Model 3D

🛠 Utilitas

Contoh berdasarkan mode

Status dan kesalahan

Perkiraan biaya sebelumnya