Come accedere a Seedance 2.0 | Dal nulla alla prima clip
Come accedere a Seedance 2.0 passo passo: scegliere la superficie, ottenere una chiave, i campi della prima richiesta, quanto costa e perché fallisce.
Non esiste un'app consumer pubblicata da ByteDance che ti consegni Seedance 2.0 direttamente. Nella pratica, accedere a Seedance 2.0 significa scegliere una delle superfici che rivendono il modello, ottenere una credenziale e inviare una richiesta della forma giusta. Questa pagina percorre quella strada da un capo all'altro, con il costo della prima clip e le quattro ragioni per cui una prima chiamata di solito fallisce.
Niente di tutto questo richiede molto tempo. La maggior parte della difficoltà sta in ciò che ogni superficie decide silenziosamente al posto tuo.
Le superfici che portano il modello
L'accesso arriva in tre forme, e quella che scegli determina cosa puoi controllare.
Un'app video consumer ti dà una casella di testo, qualche preset e un saldo di crediti. Nessuna chiave, nessun codice. È la strada più veloce verso la prima clip ed è quella che nasconde di più: i tetti di durata, i declassamenti di risoluzione e i watermark sono applicati dall'app e non dal modello, e spesso non riesci a capire quale versione ti stanno servendo.
Un'API ospitata ti dà una chiave e la richiesta grezza. Ogni parametro che il modello espone è raggiungibile, la fatturazione è al secondo di video finito invece che a credito, e quando qualcosa fallisce puoi leggere l'errore vero. In cambio devi inviare HTTP.
Un'integrazione inclusa mette il modello dentro uno strumento di editing o di design che già paghi. Comoda se vivi dentro quello strumento, e il set di parametri è di solito il più stretto dei tre.
Per qualsiasi cosa che vada oltre una prima occhiata, la strada dell'API è quella che ti dice la verità su cosa stai ottenendo.
Cosa ti serve prima della prima richiesta
Tre cose.
Un account sulla piattaforma che hai scelto, con un metodo di pagamento collegato. Una chiave API, emessa dalla dashboard della piattaforma e inviata come header Authorization: Bearer. E, se pensi di condizionare la generazione con un'immagine, un URL pubblicamente raggiungibile per quell'immagine. Gli input multimediali devono essere link HTTP o HTTPS pubblici. I data URI vengono rifiutati su tutta la piattaforma, quindi un file sul tuo portatile va prima caricato da qualche parte.
Le chiavi sono credenziali bearer. Chiunque ne possieda una può spendere il tuo saldo, quindi tienile lato server e fuori dal bundle del browser.
Come accedere a Seedance 2.0 tramite l'API ospitata
La chiamata è una POST all'endpoint di generazione video della piattaforma con un body JSON, e restituisce un id del task invece di un video. Quattro campi reggono l'intera richiesta:
- l'identificatore del modello, copiato esattamente dalla documentazione ufficiale della versione che vuoi
- il prompt, una descrizione dell'inquadratura e non una mood board a parole
- la durata in secondi, che su 2.0 non può superare i 15
- la risoluzione, una fra 480p, 720p o 1080p
Non esiste un'impostazione 4K. Quel tetto è lo stesso su ogni host, e una pagina che pubblicizza il 4K per questo modello sta ripetendo un'affermazione pre-lancio.
Copia la stringa del modello invece di scriverla a memoria. Gli identificatori di questa famiglia sono versionati con precisione, e i vecchi esempi di codice che girano online citano stringhe che non risolvono più. Un identificatore sbagliato fallisce la validazione prima che venga creato un task, quindi non costa nulla, ma produce un errore che sembra un problema di accesso invece di un errore di battitura.
Il polling e l'attesa
La generazione è asincrona. La chiamata di creazione ritorna subito con un id del task, e tu interroghi un endpoint di task finché lo stato non diventa terminale. Il polling è gratis, il che significa che non c'è motivo di diradare le richieste in modo aggressivo.
Aspettati da due a cinque minuti. Un job ancora incompleto a venti minuti è andato storto, e il percorso di rimborso è lo stesso di qualsiasi altro fallimento.
Quando il task riesce, la risposta porta un URL per il file finito. Scaricalo. Gli URL dei risultati ospitati non sono un archivio permanente.
Quanto costa la prima clip
La fatturazione è al secondo di video finito, con prezzo per risoluzione. Qui sotto ci sono le tariffe pubblicate per Seedance 2.5, che fanno da limite superiore per 2.0, il cui prezzo al secondo è più basso:
| Risoluzione | 2.5 solo generazione | 2.5 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 su 2.5 costa all'incirca $0.59, e su 2.0 costa meno. È quello che dovrebbe costarti un primo render. Parti da lì invece che da 1080p, verifica che la pipeline funzioni da un capo all'altro, poi alza la risoluzione una volta che sai che il prompt fa centro.
I job falliti vengono rimborsati per intero, compresi i rifiuti della moderazione dei contenuti, quindi un esperimento che va male non è un addebito.
Perché una prima chiamata fallisce
Quattro cause spiegano la maggior parte dei casi.
Durata superiore a 15 secondi. Un tetto rigido su 2.0, rifiutato in validazione. Se ti serve di più, l'obiettivo è Seedance 2.5, che arriva a 30.
Un URL multimediale locale o data:. Rifiutato su tutta la piattaforma. Carica il file e passa un link pubblico.
Una stringa di modello ritirata. Errore di validazione, nessun task creato, nessun addebito.
Un rifiuto per sicurezza, restituito come errore 80006. Non dice quale fase è scattata, quindi il prompt, un'immagine di riferimento e l'output generato sono tutti candidati. Il parametro content_filter è true di default e impostarlo a false instrada verso un canale meno restrittivo senza disattivare la moderazione. Sotto a quello, il modello blocca le celebrità reali nominate, la proprietà intellettuale di terzi e i contenuti illegali, e nessuna impostazione dell'host cambia questo.
Domande frequenti
Posso accedere a Seedance 2.0 senza scrivere codice? Sì, tramite un'app consumer o un'integrazione inclusa in uno strumento di editing. Scambi il controllo dei parametri e il prezzo al secondo con un saldo di crediti e i preset di qualcun altro.
Mi serve una chiave separata per 2.0 e 2.5? No. Le piattaforme che servono entrambi li espongono come identificatori di modello diversi sotto lo stesso account e la stessa chiave. Cambiare versione di solito è la modifica di una sola stringa.
Quanto passa prima che il primo video esista? Da due a cinque minuti dopo che la richiesta è stata accettata. La chiamata di creazione in sé ritorna in meno di un secondo con un id del task, ed è questo che confonde chi si aspetta un video nella risposta.
Una generazione fallita viene addebitata? No. I fallimenti vengono rimborsati per intero, rifiuti compresi. Controlla la cifra dei crediti sul task concluso per confermare che la riserva sia rientrata.
In breve
Accedere a Seedance 2.0 sono tre decisioni e una richiesta. Scegli una superficie, sapendo che un'app consumer nasconde la versione e i tetti mentre una chiave API espone entrambi. Prendi la chiave, tienila lato server e ospita ogni immagine di riferimento su un URL pubblico. Invia una POST con la stringa del modello, un prompt, una durata pari o inferiore a 15 secondi e una risoluzione, poi fai polling per due-cinque minuti. Fai la prima a 480p e cinque secondi. Costa centesimi, e se fallisce ti viene rimborsata.
