Come accedere a Seedance 2.5 | Chiave, richiesta, render
Come accedere a Seedance 2.5: verificare di avere la versione vera, ottenere una chiave, i campi della prima richiesta, i default che costano e il conto.
ByteDance ha annunciato Seedance 2.5 il 31 luglio 2026, e le piattaforme lo hanno adottato in momenti diversi. È questa adozione scaglionata a rendere «come accedere a Seedance 2.5» una domanda più difficile di quanto sembri: molte superfici lo pubblicizzano mentre sotto servono ancora il modello vecchio. Arrivare a un primo render significa confermare la versione, avere una chiave e inviare una richiesta di cui hai davvero letto i valori di default.
Prima di tutto, conferma che la versione sia quella vera
Due verifiche risolvono la questione, e nessuna delle due costa niente.
Chiedi 20 secondi. Seedance 2.5 va da 4 a 30 secondi in una sola generazione. Seedance 2.0 si ferma a 15. Una richiesta da 20 secondi rifiutata sul campo della durata significa che sei su 2.0. Un rifiuto in validazione avviene prima che venga creato un task, quindi non viene addebitato nulla.
Leggi l'identificatore del modello. La build 2.5 rilasciata è servita sotto una stringa che termina in -face, scritta per intero come doubao-seedance-2.5-face. Gli esempi di codice pubblicati prima del rilascio citano un identificatore senza quel suffisso, e non risolve più. Se la documentazione di una piattaforma mostra ancora la vecchia stringa, la sua integrazione è precedente al rilascio.
Una terza verifica, non conclusiva ma indicativa: se l'interfaccia offre una fascia 4K, sta descrivendo marketing pre-lancio. Il modello si ferma a 1080p, con 720p e 480p sotto, su ogni host.
Prendi una chiave e un posto dove mettere i file
Una chiave API dalla dashboard della piattaforma, inviata come header Authorization: Bearer, è tutta l'autenticazione che serve. Trattala come una credenziale di spesa e tienila su un server.
Se hai intenzione di usare materiale di riferimento, ti serve anche un posto dove ospitarlo. Gli input multimediali sono solo URL HTTP o HTTPS pubblici. I data URI vengono rifiutati su tutta la piattaforma, quindi i file locali vanno caricati prima di poter essere referenziati.
Come accedere a Seedance 2.5 con una prima richiesta
La chiamata è una POST all'endpoint di generazione video della piattaforma. Restituisce un id del task, non un video. Poi interroghi un endpoint di task finché lo stato non è terminale. Il polling è gratis.
Il body minimo utile è una stringa di modello, un prompt e una durata. I default sottostanti contano più di quanto quasi tutti si aspettino:
| Campo | Default | Da sapere |
|---|---|---|
| Durata | 5 secondi | L'intervallo va da 4 a 30. Impostare -1 lascia scegliere al modello e riserva al tetto di 30 secondi |
| Risoluzione | 720p | 480p e 1080p sono le altre due opzioni |
| Rapporto d'aspetto | adaptive | I rapporti fissi sono disponibili se l'output ha un formato di destinazione |
| Audio | attivo | Parlato, effetti e musica vengono generati insieme all'immagine |
Il default di 5 secondi per la durata è un primo render sensato. Il valore -1 è quello da evitare all'inizio, perché la riserva viene presa al tetto massimo e non su quello che il modello finirà per produrre.
I prompt arrivano a 20000 caratteri. Un prompt è obbligatorio per il text to video e diventa facoltativo quando alleghi materiale di riferimento.
La porta del materiale di riferimento
È questa la capacità che separa 2.5 dalla versione precedente, ed è raggiungibile già alla prima richiesta. Un singolo job accetta fino a 30 immagini di riferimento, 10 clip video di riferimento e 10 tracce audio.
L'asimmetria dei prezzi è la cosa da interiorizzare. Le immagini di riferimento e l'audio di riferimento non aggiungono nulla al conto. Il video di riferimento sì, e lo fa due volte. Una clip sorgente viene addebitata per la propria durata in aggiunta all'output, e qualsiasi richiesta che contiene video porta con sé una soglia minima di fatturazione pari a cinque terzi della durata dell'output. Una sorgente da due secondi con un output da cinque secondi fattura nove secondi invece di sette. Ogni clip di riferimento dura da 2 a 30 secondi e il video di riferimento complessivo non può superare i 30 secondi.
Quindi un primo render condizionato da immagini fisse è quasi privo di sorprese. Un primo render condizionato da filmati non lo è, e dovrebbe essere piccolo.
Quanto costa la prima clip
Le tariffe sono al secondo di video finito, stabilite dalla risoluzione e dal fatto che la richiesta portasse o meno una clip di riferimento:
| Risoluzione | Solo generazione | Con un video di riferimento |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Una clip da cinque secondi a 480p costa circa $0.59. Una clip da dieci secondi a 1080p costa circa $4.62. La distanza fra questi due numeri è l'argomento per fare il primo tentativo corto e piccolo, verificare che il prompt faccia quello che intendevi, e solo dopo alzare risoluzione e durata.
La generazione richiede da due a cinque minuti. I job falliti vengono rimborsati per intero, rifiuti compresi.
Quando la prima chiamata fallisce
Un rifiuto per sicurezza restituisce l'errore 80006. Non dice quale fase è scattata, quindi il prompt, qualsiasi immagine di riferimento e l'output generato sono tutti candidati, e la diagnosi è manuale: riduci il prompt a qualcosa di neutro, verifica che passi, poi rimetti gli elementi uno alla volta.
Il parametro content_filter è true di default. Impostarlo a false instrada la richiesta verso un canale meno restrittivo e non disattiva la moderazione. Sotto ci sono i blocchi a livello di modello su celebrità reali nominate, proprietà intellettuale di terzi e contenuti illegali, che nessuna impostazione dell'host rimuove.
Tutto il resto nell'elenco dei fallimenti della prima chiamata è validazione: una durata fuori dall'intervallo da 4 a 30, una stringa di modello ritirata, un URL data:, una clip di riferimento oltre il limite di durata. Nessuno di questi crea un task, quindi nessuno costa nulla.
Domande frequenti
Mi serve un account diverso per accedere a Seedance 2.5 invece che a 2.0? No. Le piattaforme che servono entrambi li espongono come identificatori di modello separati su un solo account e una sola chiave. Passare da una versione all'altra di solito è la modifica di una singola stringa.
Come faccio a sapere se una piattaforma sta davvero facendo girare 2.5?
Chiedi 20 secondi. Se funziona è 2.5, se viene rifiutata sul campo della durata è 2.0. Poi controlla che l'identificatore del modello termini in -face.
Posso accedere a Seedance 2.5 senza una chiave API? Le app consumer e le integrazioni incluse negli editor raggiungono il modello senza chiave, al costo dell'accesso ai parametri e della fatturazione al secondo. In cambio ottieni preset e un saldo di crediti.
Il 4K è disponibile su qualche piano? No. Il modello rilasciato si ferma a 1080p. Il dato sul 4K viene da articoli pre-lancio su qualcosa che non è mai stato consegnato.
In breve
Accedere a Seedance 2.5 sono quattro passi. Verifica la versione con una richiesta da 20 secondi e con l'identificatore -face. Prendi una chiave e tienila lato server. Invia un primo job breve, cinque secondi a 480p, lasciando stare i default tranne durata e risoluzione. Fai polling per due-cinque minuti e scarica il risultato. Immagini e audio di riferimento si allegano gratis, il video di riferimento viene fatturato per la propria durata con una soglia di cinque terzi, e tutto ciò che fallisce viene rimborsato.
