Seedance 2.5 API: endpoint, parametri e fatturazione reale
L'API Seedance 2.5 è asincrona, si paga al secondo e ha tre regole di fatturazione che colgono di sorpresa. Tutto quello che ti serve prima di scrivere la prima chiamata.
Da $0.07 al secondo, 480p con clip di riferimento
Cosa ti dà l'API Seedance 2.5
Un POST crea la richiesta, un GET ne fa il polling, e il polling è gratuito. L'API Seedance 2.5 decide la modalità in base a quali campi media valorizzi, non da un parametro separato.
Il solo prompt è text-to-video. Aggiungi immagini e l'API Seedance 2.5 passa a image-to-video. Aggiungi primo e ultimo fotogramma e anima una transizione. Aggiungi una clip sorgente e la modifica o la estende.
Il POST restituisce subito un id del task e la generazione richiede dai due ai cinque minuti. Un'integrazione con l'API Seedance 2.5 ha bisogno di un ciclo di polling o di una coda, non di una richiesta sincrona.
La piattaforma lo serve come doubao-seedance-2.5-face. Sbagliare la stringa del modello dell'API Seedance 2.5 è l'errore più comune alla prima chiamata, e restituisce un errore sincrono invece di un addebito.
Un solo header, con ambito workspace, nessun id di progetto. Una chiave dell'API Seedance 2.5 porta con sé l'ambito di fatturazione del workspace che l'ha emessa.
Ogni richiesta fallita restituisce i crediti per intero, compresi i rifiuti della moderazione. L'API Seedance 2.5 non addebita mai una generazione che non hai ricevuto.
Qui non c'è nessun generatore. Le chiamate all'API Seedance 2.5 girano sull'API della piattaforma, e ogni parametro e ogni tariffa qui sotto sono presi dalla sua documentazione pubblicata.
I parametri dell'API Seedance 2.5 che contano di più
Quattro campi che decidono costo e risultato.
duration
Da quattro a trenta secondi, valore predefinito cinque. Passare -1 lascia scegliere al modello, ma l'API Seedance 2.5 blocca i crediti sul tetto dei 30 secondi e rimborsa la differenza, cosa che con un saldo risicato può far scattare un 402.
resolution
480p, 720p o 1080p, valore predefinito 720p. Sull'API Seedance 2.5 non esiste il 4K, e chiederlo restituisce un errore invece di una clip a risoluzione ridotta.
content_filter
Booleano, true per impostazione predefinita. Con false la richiesta all'API Seedance 2.5 viene instradata su un canale meno restrittivo e il prompt diventa obbligatorio. La piattaforma lo documenta come instradamento, non come interruttore di spegnimento.
omni_reference_task_type
Dichiara edit o extend e l'API Seedance 2.5 valida le regole al momento dell'invio invece di fallire qualche minuto dopo. Vale la pena impostarlo su ogni richiesta guidata da riferimenti.
Quattro passaggi per una chiamata funzionante all'API Seedance 2.5
- 1
Crea una chiave
Generane una nella dashboard della piattaforma e inviala come bearer token. L'API Seedance 2.5 rifiuta qualsiasi altra cosa nell'header di autorizzazione.
- 2
Fai il POST della richiesta
Invia model, prompt e gli eventuali URL dei media all'endpoint delle generazioni video. Ogni campo media dell'API Seedance 2.5 accetta URL pubblici HTTP o HTTPS; base64 è rifiutato su tutta la piattaforma.
- 3
Fai polling sul task
Fai GET sull'id del task finché lo stato non è completed o failed. Il polling dell'API Seedance 2.5 non costa nulla, quindi un intervallo di due secondi va benissimo.
- 4
Leggi l'output
Un task completato dell'API Seedance 2.5 riporta gli URL del video, più l'URL dell'ultimo fotogramma se lo hai richiesto. Riospita su un tuo storage tutto ciò che vuoi conservare, perché gli URL consegnati non sono permanenti.
API Seedance 2.5: le risposte
Al secondo di video fatturabile, da $0.071153 a $0.461856 a seconda della risoluzione e del fatto che la richiesta contenga una clip di riferimento. Una generazione 1080p da dieci secondi costa circa $4.62. Immagini e audio di riferimento non incidono sul conto.
La durata dell'output, più l'intera lunghezza di ogni video di riferimento, con un minimo pari a cinque terzi della durata dell'output su qualsiasi richiesta che contenga video. Una sorgente da due secondi con un output da cinque secondi fattura nove secondi invece di sette, e questo sorprende quasi tutte le prime integrazioni.
doubao-seedance-2.5-face sull'API della piattaforma. Le guide più vecchie citano doubao-seedance-2.5 senza suffisso, una stringa precedente al lancio che non risolve. Controlla la pagina del modello invece di fidarti di un esempio di codice.
Il polling è la strada documentata ed è gratuito, quindi un ciclo a intervalli brevi è l'integrazione più semplice dell'API Seedance 2.5. Dato che la generazione richiede dai due ai cinque minuti, un polling ogni due o cinque secondi non aggiunge carico significativo e non richiede alcuna infrastruttura di callback.
È la validazione dello schema, e non è stato addebitato nulla. Le cause comuni sono una risoluzione non valida, un valore di size combinato con il primo o l'ultimo fotogramma, o un prompt mancante in una richiesta text-to-video. L'errore indica il campo che ha causato il problema.
O una regola sul tipo di task o la moderazione. L'errore 80006 è un rifiuto per motivi di sicurezza e non indica la fase. Un parametro incoerente su una richiesta di edit produce un errore diverso, e dichiarare omni_reference_task_type lo trasforma, la volta successiva, in un 400 immediato.
Fino a 30 immagini, 10 clip video per un totale di 30 secondi e 10 tracce audio. Gli array di immagini semplici e quelli con ruolo sono mutuamente esclusivi, quindi scegline uno per ogni richiesta all'API Seedance 2.5.
Sì, sullo stesso endpoint con un model id diverso. Seedance 2.0 si ferma a 15 secondi dove la 2.5 arriva a 30, e la forma della richiesta è abbastanza simile da rendere il cambio di versione quasi solo una stringa da sostituire.
Una chiave porta con sé l'ambito di fatturazione del workspace che l'ha emessa, e non esiste un header separato per il progetto. I team che hanno bisogno di contabilità separate creano workspace separati invece di più chiavi dentro lo stesso, perché il consumo viene aggregato a livello di workspace.
Parti dalla documentazione dell'API Seedance 2.5
Parametri pubblicati, tariffe al secondo aggiornate, polling gratuito e rimborsi automatici in caso di errore.
Correlati: Seedance 2.5 API