Pembuatan media (video, gambar, musik)

NordRouter dapat menghasilkan gambar, video, dan musik - dengan kunci yang sama sk-nr-… dan dari keseimbangan yang sama dengan model teks. Pembayaran sebenarnya, tidak ada token atau paket.

Bagaimana cara kerjanya

Pembuatannya tidak sinkron (video dan musik memerlukan waktu beberapa detik hingga beberapa menit):

1. Buat tugas - POST /media/generate dengan model dan parameter.
2. Tunggu hasilnya - polling GET /media/job/:id hingga status menjadi done.
3. Ambil file - melalui result_url (tautan ke nordrouter.com).

1. Buat tugas

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" }
  }'

Jawaban:

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

2. Tunggu hasilnya

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 (atau failed). File yang sudah selesai tersedia di result_url.

🎵 Suno menghasilkan dua trek per tugas: yang pertama di result_url, yang kedua di result_url_2 (format tautan yang sama). Harga untuk keseluruhan tugas, kedua track sudah termasuk.

Webhook (bukan polling)

Jika Anda tidak ingin melakukan polling, teruskan kolom callback_url ke POST /media/generate, dan kami akan mengirimkan hasilnya melalui permintaan POST ketika tugas selesai:

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": "ваш-секрет"
  }'

Ketika tugas masuk ke done/failed, POST akan dikirim ke callback_url dengan isi yang sama dengan yang dikirimkan GET /media/job/:id, ditambah bidang 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 atau media.failed.

Verifikasi tanda tangan. Jika Anda menyetel callback_secret, header X-NR-Signature akan berisi sha256=<hmac> - HMAC-SHA256 dari isi permintaan pada rahasia Anda. Periksa untuk memastikan permintaan tersebut dari kami:

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

Persyaratan dan keandalan:

• callback_url - hanya https:// dan hanya alamat publik (IP internal/pribadi ditolak dengan kesalahan 400).
• Hingga 4 upaya pengiriman dengan peningkatan jeda; jawab 2xx, jika tidak kami akan mengulanginya.
• Webhook tidak membatalkan polling - Anda dapat menggabungkannya atau menggunakan GET /media/job/:id sebagai opsi cadangan.

Lebih detailnya

Siklus hidup tugas, verifikasi tanda tangan dengan contoh dan keandalan pengiriman - di halaman Tugas dan webhook.

3. Daftar model dan harga

GET /media/models mengembalikan model yang tersedia, parameternya, dan perkiraan biaya:

{ "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 }

Panduan lengkap

Semua model dengan parameter input dan harga ada di halaman Media: semua model dan penagihan.

Model

95 model tersedia - daftar lengkap terkini dengan parameter dan harga selalu ada di GET /media/models. Keluarga utama:

Ketik	Keluarga	Mode	≈ harga
🖼 Gambar	Nano Banana / 2 / Pro (image/nano-banana*)	teks→gambar, pengeditan, hingga 4K	dari $0,025
🖼	Gambar 4 Cepat / Ultra (image/imagen4*)	teks → gambar	mulai $0,025
🖼	Gambar GPT 1.5/2 (image/gpt-image-*)	teks → gambar, edit, hingga 4K	mulai dari $0,025
🖼	Flux 2 Pro / Flex (image/flux2-*)	teks → gambar, edit	mulai $0,03
🖼	Seedream v4 / 4.5 / 5 Lite (image/seedream-*)	teks→gambar, edit	dari $0,04
🖼	Ideogram v3 / Karakter (image/ideogram-*)	teks, remix, karakter	mulai $0,02
🖼	Qwen / Wan Image / Grok / Z-Image	teks → gambar, edit	dari $0,01
🛠 Utilitas	Topaz / Recraft (image/*upscale*, image/recraft-remove-bg)	tingkatkan ke 8K, penghapusan latar belakang	dari $0,01
🎬 Video	Veo 3.1 Lite / Fast / Quality (video/veo-3.1-*)	teks/foto→video	mulai dari $0,19
🎬	Kling 2.1 → 3.0 (video/kling-*)	teks/foto→video, gerakan, avatar, hingga 4K dan 15 detik	mulai $0,16
🎬	Wan 2.2 → 2.7 (video/wan-*)	teks/foto/video →video, pidato-ke-video	mulai $0,25
🎬	Seedance 1.5 / 2 / Fast / Mini (video/seedance-*)	teks/foto →video, hingga 4K, suara	mulai $0,06
🎬	Hailuo 02 / 2.3 (video/hailuo-*)	teks/foto →video	mulai $0,08
🎬	HappyHorse 1.0 / 1.1 (video/happyhorse-*)	teks/foto/referensi →video, edit video	mulai $0,70
🎬	Grok Video / 1.5 (video/grok-*)	teks/foto→video, hingga 30 detik	dari $0,06
🎬	Gemini Omni (video/gemini-omni)	video dengan suara, hingga 4K	mulai $0,39
🗣 Avatar	Kling Avatar, OmniHuman, InfiniteTalk, Lip Sync	foto+audio → video berbicara	mulai $0,19
🎵 Musik	Suno V4–V5.5 (music/suno-v5)	teks/gaya→2 lagu	~$0.08
🎙 Akting suara	ElevenLabs Turbo / Multilingual (audio/elevenlabs-*)	teks → ucapan, isolasi suara	mulai $0,04 / 1000 digit.

Pilihan

Parameternya bergantung pada model - daftar persisnya ada di /media/models (bidang fields: nama, jenis, opsi, default). Umum:

• prompt - deskripsi (untuk semua model generatif).
• resolution - 1K/2K/4K (gambar) atau 480p/720p/1080p/4k (video). Harganya tergantung resolusi.
• aspect_ratio - 1:1, 16:9, 9:16, dll.
• duration — durasi video dalam hitungan detik (untuk sebagian besar 5/10, untuk Kling 3.0 dan Wan 2.7 hingga 15, untuk Grok hingga 30). Video dikenakan biaya per detik.
• sound / generate_audio - trek audio (Kling, Seedance). Suara lebih mahal - peringkat di /media/estimate memperhitungkan hal ini.
• mode / quality / rendering_speed - tingkat kualitas (Kling 3.0 std/pro/4K, Gambar GPT medium/high, Ideogram TURBO/BALANCED/QUALITY).
• image - masukan gambar (edit, foto →video; kirim tautan langsung atau unduh melalui /media/upload).
• video_url / audio_url - masukan video/audio (edit video, lipsync, avatar).
• Untuk musik: title, style, instrumental, version (V4…V5_5).

Harga pasti konfigurasi tertentu sebelum peluncuran ditunjukkan oleh POST /media/estimate dengan model + input yang sama.

Biaya dan penyimpanan

• Didebit dari saldo USD Anda dengan biaya pembuatan sebenarnya - jumlah pastinya dapat dilihat di cost_usd setelah selesai.
• Pembuatan yang gagal (kesalahan penyedia) tidak dikenakan biaya - cadangan dikembalikan secara otomatis.
• File disimpan di server kami untuk waktu terbatas (lihat retention_days di /media/models) - unduh untuk menyimpan.