API multimediale — immagini, video, musica
Generate immagini, video e musica con la stessa chiave sk-nr-… e lo stesso saldo dei modelli di testo. Un unico conto, pagamento a consumo, senza abbonamenti né pacchetti.
- URL di base:
https://nordrouter.com(oppurehttps://global-api.nordrouter.comper le reti estere). - Autenticazione: header
Authorization: Bearer sk-nr-…(oppureX-API-Key: sk-nr-…). - Formato: JSON, generazione asincrona (creare un'attività → verificarne periodicamente lo stato → scaricare il file).
Endpoint
| Metodo | Funzione |
|---|---|
POST /media/generate | Creare un'attività di generazione |
GET /media/job/:id | Stato e risultato dell'attività |
POST /media/estimate | Conoscere in anticipo il prezzo della configurazione |
GET /media/models | Elenco di modelli e parametri in formato leggibile dalle macchine |
POST /media/upload | Caricare un file multimediale di origine |
GET /media/file/:id | File pronto (link da result_url) |
Ciclo di vita della richiesta
1. Creare un'attività
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": "avvicinamento fluido della telecamera", "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. Verificare periodicamente lo stato (ogni 3–5 secondi)
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. Scaricare il file — tramite result_url. Il link punta a nordrouter.com (il vostro brand); i file vengono conservati per 14 giorni, poi eliminati: scaricateli o trasferiteli nel vostro spazio di archiviazione in anticipo.
Caricamento dei file multimediali di origine
I campi image, image2, audio_url e video_url accettano un link pubblico diretto. I modelli con il campo attachments accettano un array di oggetti restituiti da POST /media/upload: inviate { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }, quindi passate l'intera risposta del caricamento in input.attachments. Per Suno potete invece passare un URL pubblico in input.source_url e, per il mashup, due URL in input.source_urls.
Fatturazione
Gli addebiti vengono effettuati sul vostro saldo in dollari (lo stesso dei modelli di testo), al completamento della generazione, per l'importo esatto indicato nelle tabelle seguenti.
- Riserva → importo effettivo. Alla creazione dell'attività viene riservato il costo stimato; al termine, l'importo viene ricalcolato in base al risultato effettivo e l'eccedenza viene restituita al saldo.
- Video — tariffazione al secondo. Il prezzo aumenta con la durata e la risoluzione; l'audio attivato comporta un costo maggiore. Le tabelle indicano il prezzo «a partire da» per le impostazioni predefinite; l'indicazione
/secrappresenta la tariffa al secondo. - Gli errori non vengono addebitati. Se l'attività termina con lo stato
failed, l'importo riservato viene restituito interamente: pagate solo le generazioni riuscite. - Prezzo esatto in anticipo —
POST /media/estimatecon gli stessimodel+inputrestituisce{ "usd": … }prima dell'avvio. - La ricarica del saldo avviene in rubli (≈ $1 = 89–96 ₽); tutti i calcoli successivi sono in USD.
Catalogo dei modelli
Prezzo: per i video, tariffa al secondo (/sec), totale = tariffa × durata (la risoluzione e l’audio possono modificarla); per tutto il resto, per una generazione con le impostazioni predefinite. Il costo esatto di qualsiasi configurazione è restituito da POST /media/estimate.
I campi in input possono essere più numerosi: l’elenco leggibile dalle macchine (tipi, opzioni, valori predefiniti, intervalli di secondi) è sempre restituito da GET /media/models. I campi obbligatori sono contrassegnati con *. Puoi inviare direttamente in input qualsiasi campo aggiuntivo del modello (negative_prompt, seed, cfg_scale…).
Nomi dei parametri precedenti
Il 19 ottobre 2026 i parametri hanno adottato nomi e valori uniformi: snake_case, valori in minuscolo (ad esempio, version: "v6-wild", resolution: "720p", audio: true). I nomi e i valori della versione precedente della documentazione sono ancora accettati: non è necessario modificare le integrazioni scritte in precedenza; attività, risultato e prezzo restano gli stessi. In GET /media/models, MCP e in questa documentazione sono riportati solo i nuovi nomi. Se la richiesta include sia il nome precedente sia quello nuovo dello stesso parametro, prevale quello nuovo.
🖼 Immagini
model | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
image/nano-banana | testo→immagine | 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 | testo→immagine | 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 | testo→immagine | 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 | testo→immagine | 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 | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool | PNG | $0.025 |
image/imagen4 | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool | PNG | $0.050 |
image/imagen4-ultra | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool | PNG | $0.075 |
image/gpt-image-1.5 | testo→immagine | prompt *, aspect_ratio=1:1|2:3|3:2, quality=medium|high, safety_filter=bool | PNG | $0.025 |
image/gpt-image-1.5-edit | modifica immagine | prompt *, image=url *, aspect_ratio=3:2|1:1|2:3, quality=medium|high, safety_filter=bool | PNG | $0.025 |
image/gpt-image-2 | testo→immagine | 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 | modifica immagine | 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 | testo→immagine | 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 | modifica immagine | 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 | testo→immagine | 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 | modifica immagine | 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 | modifica immagine | 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 | modifica immagine | 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 | modifica immagine | 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 | modifica immagine | 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 | testo→immagine | 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 | modifica immagine | 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 | modifica immagine | prompt *, image=url *, render_mode=fast|balanced|quality, style=auto|realistic|fiction, safety_filter=bool | PNG | $0.11 |
image/qwen | testo→immagine | 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 | modifica immagine | 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 | modifica immagine | prompt *, image=url *, safety_filter=bool | PNG | $0.031 |
image/qwen2-edit | modifica immagine | 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 | testo→immagine | prompt *, aspect_ratio=1:1|2:3|3:2|16:9|9:16, pro=bool, safety_filter=bool | PNG | $0.025 |
image/grok-edit | modifica immagine | prompt *, image=url *, safety_filter=bool | PNG | $0.025 |
image/z-image | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|3:4|4:3, safety_filter=bool | PNG | $0.006 |
image/wan-2.7 | testo→immagine | 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 | testo→immagine | 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 | testo→immagine | prompt * | JPG | $0.013 |
image/gemini-3.1-flash | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4, resolution=1k|2k|4k | PNG | $0.013 |
image/gemini-3-pro | testo→immagine | prompt *, aspect_ratio=1:1|16:9|9:16|4:3|3:4, resolution=1k|2k|4k | PNG | $0.031 |
🎬 Video
model | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
video/veo-3.1-fast | testo→video | prompt *, aspect_ratio=16:9|9:16, image=url | MP4 | $0.38 |
video/veo-3.1-quality | testo→video | prompt *, aspect_ratio=16:9|9:16, image=url | MP4 | $1.56 |
video/veo-3.1-lite | testo→video | prompt *, aspect_ratio=16:9|9:16, image=url | MP4 | $0.19 |
video/gemini-omni | testo→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 | testo→video | prompt *, attachments=upload[] | MP4 | $0.13 |
video/kling-3.0 | testo→video | prompt *, duration=3–15s, aspect_ratio=16:9|9:16|1:1, mode=standard|pro|4k, audio=bool, image=url, image2=url, safety_filter=bool | MP4 | $0.11/sec |
video/kling-t2v | testo→video | prompt *, duration=3–15s, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool | MP4 | $0.11/sec |
video/kling-turbo-i2v | foto→video | prompt *, image=url *, duration=3–15s, resolution=720p|1080p, safety_filter=bool | MP4 | $0.11/sec |
video/kling-2.6-t2v | testo→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 | testo→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 | testo→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 | testo→video | prompt *, duration=2–15s, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, audio_url, safety_filter=bool | MP4 | $0.15/sec |
video/wan-2.7-i2v | foto→video | prompt *, image=url *, image2=url, duration=2–15s, resolution=720p|1080p, audio_url, safety_filter=bool | MP4 | $0.15/sec |
video/wan-2.7-r2v | foto→video | prompt *, image=url *, duration=2–10s, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool | MP4 | $0.15/sec |
video/wan-2.7-edit | video→video | prompt *, video_url *, resolution=720p|1080p, audio_source=auto|original | MP4 | $1.50 |
video/wan-t2v | testo→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 | testo→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 | testo→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 | testo→video | prompt *, duration=4–15s, 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/sec |
video/seedance-2-fast | testo→video | prompt *, duration=4–15s, aspect_ratio=16:9|9:16|1:1, resolution=480p|720p, audio=bool, image=url, image2=url, safety_filter=bool | MP4 | $0.21/sec |
video/seedance-2-mini | testo→video | prompt *, duration=4–15s, aspect_ratio=16:9|9:16|1:1, resolution=480p|720p, audio=bool, image=url, image2=url, safety_filter=bool | MP4 | $0.13/sec |
video/seedance-1.5-pro | testo→video | prompt *, duration=4–12s, aspect_ratio=16:9|9:16|1:1|4:3, resolution=480p|720p|1080p, audio=bool, image=url, safety_filter=bool | MP4 | $0.025/sec |
video/hailuo-02-t2v | testo→video | prompt *, duration=6|10, safety_filter=bool | MP4 | $0.19 |
video/hailuo-02-t2v-pro | testo→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 | testo→video | prompt *, duration=3–15s, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, safety_filter=bool | MP4 | $0.18/sec |
video/happyhorse-1.1-i2v | foto→video | prompt, image=url *, duration=3–15s, resolution=720p|1080p, safety_filter=bool | MP4 | $0.18/sec |
video/happyhorse-1.1-r2v | foto→video | prompt *, image=url *, duration=3–15s, aspect_ratio=16:9|9:16|1:1, resolution=720p|1080p, safety_filter=bool | MP4 | $0.18/sec |
video/happyhorse-t2v | testo→video | prompt *, duration=3–15s, aspect_ratio=16:9|9:16|1:1|4:3|3:4, resolution=720p|1080p, safety_filter=bool | MP4 | $0.30/sec |
video/happyhorse-i2v | foto→video | prompt, image=url *, duration=3–15s, resolution=720p|1080p, safety_filter=bool | MP4 | $0.30/sec |
video/happyhorse-edit | video→video | prompt *, video_url *, resolution=720p|1080p, audio_source=auto|original | MP4 | $1.50 |
video/grok-t2v | testo→video | prompt *, duration=6–30s, 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/sec |
video/grok-i2v | foto→video | prompt *, image=url *, duration=6–30s, resolution=480p|720p, mode=normal|fun|spicy, safety_filter=bool | MP4 | $0.019/sec |
video/grok-1.5 | testo→video | prompt *, duration=1–15s, aspect_ratio=auto|16:9|9:16|1:1, resolution=480p|720p, image=url, safety_filter=bool | MP4 | $0.019/sec |
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 | upscaling | video_url *, scale=2|4 | MP4 | $0.50 |
🎵 Musica
model | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
music/suno-v5 | musica | title *, style *, version=v6|v6-wild|v6-mini, instrumental=bool, prompt | MP3 | $0.075 |
music/suno-cover | musica | prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, instrumental=bool, advanced=bool, title, style, duration=10–360s | MP3 | $0.075 |
music/suno-extend-upload | musica | prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, continue_from=1–120, instrumental=bool | MP3 | $0.075 |
music/suno-add-vocals | musica | prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, style, title, exclude_styles, vocal=female|male | MP3 | $0.075 |
music/suno-add-instrumental | musica | prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, title, exclude_styles | MP3 | $0.075 |
music/suno-mashup | musica | prompt *, attachments=upload[] *, version=v6|v6-wild|v6-mini, instrumental=bool, advanced=bool, title, style, duration=10–360s | MP3 | $0.075 |
music/suno-sounds | musica | 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 | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
audio/gemini-3.1-flash-tts | sintesi vocale | 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 | sintesi vocale | 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 | sintesi vocale | 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 | sintesi vocale | 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 |
🧊 Modelli 3D
L’output è GLB (per alcuni modelli è possibile scegliere anche OBJ, FBX, STL, USDZ, USD, 3MF) più un’immagine di anteprima: il task restituisce più file, ciascuno con la propria estensione. L’elenco dei file si trova nel campo results; ogni elemento ha un campo ext.
Il prezzo è noto solo dopo la generazione
La tariffazione 3D si basa sulle risorse effettivamente utilizzate. Tratteniamo l’importo massimo indicato in tabella; quando viene determinato il costo effettivo, addebitiamo tale importo e restituiamo la differenza. Il totale è sempre indicato in cost_usd.
model | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
3d/tripo-text | testo→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 | testo→3D | prompt *, file_format=glb|obj|fbx|stl|usdz, pbr=bool, extra_mesh=bool | GLB e altri | $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 e altri | $0.43–0.71 |
3d/hunyuan-pro-text | testo→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 | testo→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 | viste→3D | images=[url] * (1–4), texture_size=2k|4k|8k, ultra=bool, texture=bool, pbr=bool, texture_text | GLB | $0.94–1.26 |
Foto come texture. Nei modelli 3d/meshy-*, la texture è definita separatamente dalla geometria: con un’immagine in texture_photo o con una descrizione testuale in texture_text.
Elaborazione lunga. La generazione 3D richiede da mezzo minuto a diversi minuti, più di un’immagine o di un breve clip. Non è necessario mantenere la connessione: lo stato viene salvato e sono disponibili i webhook.
🛠 Strumenti
model | Modalità | Parametri input | File | Prezzo |
|---|---|---|---|---|
image/topaz-upscale | upscaling | image=url *, scale=2|4|8 | PNG | $0.063 |
image/recraft-remove-bg | modifica | image=url * | PNG | $0.006 |
image/recraft-upscale | upscaling | image=url * | PNG | $0.006 |
Esempi per modalità
Immagine da testo
json
{ "model": "image/flux2-pro", "input": { "prompt": "neon fox in snow", "aspect_ratio": "16:9", "resolution": "2k" } }Modifica di un’immagine
json
{ "model": "image/seedream-edit", "input": { "prompt": "rimuovi lo sfondo, aggiungi neon", "image": "https://…/photo.png" } }Foto→video (fotogramma iniziale/finale, durata, audio)
json
{ "model": "video/wan-2.7-i2v", "input": {
"prompt": "avvicinamento fluido della telecamera", "image": "https://…/first.png",
"image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }Musica
json
{ "model": "music/suno-v5", "input": { "title": "Northern Lights", "style": "epic orchestral", "instrumental": true, "version": "v6" } }Sintesi vocale
json
{ "model": "audio/gemini-3.1-flash-tts", "input": {
"text": "Ciao, mondo", "voice": "Zephyr", "style": "empathetic",
"pace": "natural", "accent": "neutral" } }Dialogo a due voci — al posto del campo text, inserire le battute in dialogue e le voci in voices (la voce 1 è la prima nell’elenco):
json
{ "model": "audio/gemini-3.1-flash-tts", "input": {
"voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
"dialogue": [ { "speaker": 1, "text": "Buonasera!" }, { "speaker": 2, "text": "Piacere di sentirti." } ] } }Avatar (video parlato da foto + audio)
json
{ "model": "video/omnihuman", "input": { "image": "https://…/face.png", "audio_url": "https://…/voice.mp3" } }Stati ed errori
GET /media/job/:id → campo status:
| Stato | Significato |
|---|---|
processing | In corso: continuare a interrogare |
done | Completato: file in result_url, addebito in cost_usd |
failed | Errore: motivo in error, importo rimborsato |
Codici di risposta di POST /media/generate: 400 — modello sconosciuto o campo obbligatorio mancante; 401 — chiave assente/non valida; 402 — saldo insufficiente; 403 — modello non disponibile per l’account.
Il corpo dell’errore ha sempre lo stesso formato: { "error": "testo per l’utente", "code": "codice macchina" }. Codici: unknown_model, missing_param (+ campo param), invalid_input, invalid_attachment, prompt_too_long, input_too_long, no_auth, no_key, insufficient_balance, unpaid_shortfall, rate_limited, generation_failed, unavailable.
Stima anticipata del costo
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 }Le tabelle dei parametri sono state verificate rispetto al catalogo del servizio il 19.10.2026; l’elenco completo e aggiornato di modelli, parametri e prezzi è disponibile con GET /media/models.