Come usare Seedance 2.5 | Campi, limiti e fatturazione
Come usare Seedance 2.5 via API ospitata: ogni campo della richiesta e i limiti, le regole sui riferimenti, il polling, i secondi fatturati e l'errore 80006.
Sapere come usare Seedance 2.5 è soprattutto conoscere la forma della sua richiesta. Una sola chiamata porta un prompt, quattro impostazioni di output e fino a tre tipi di materiale di riferimento; la piattaforma restituisce un id del task; il video finito si raccoglie con il polling. Le meccaniche che differiscono dalla versione precedente sono il tetto di 30 secondi, la dimensione del budget di riferimenti e una regola di fatturazione che rende il video di riferimento più caro di quanto suggerisca la tabella delle tariffe.
Prima di ogni altra cosa, conferma di essere su 2.5
Diverse piattaforme hanno tenuto Seedance 2.0 come default quando hanno aggiunto 2.5 accanto, quindi è la stringa del modello a decidere cosa ottieni. La build 2.5 rilasciata è servita sotto un identificatore che termina in -face. I vecchi esempi di codice citano un identificatore senza quel suffisso, che non risolve più.
Una seconda verifica non richiede nessuna revisione del codice. Invia una richiesta per una generazione da 20 secondi. Su 2.0 viene rifiutata sul campo della durata, prima che il task esista, quindi non viene addebitato nulla.
Come usare Seedance 2.5 tramite l'API ospitata
Una richiesta di generazione accetta questi campi.
| Campo | Intervallo | Default |
|---|---|---|
prompt | fino a 20,000 caratteri | nessuno |
duration | da 4 a 30 secondi, oppure -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true o false | true |
content_filter | true o false | true |
Il prompt è obbligatorio per il text-to-video e facoltativo quando è presente materiale di riferimento. Le battute fra virgolette al suo interno vengono generate come parlato, nella stessa passata dell'immagine, come traccia mono che copre dialogo, effetti e musica.
Impostare duration a -1 affida al modello la decisione sulla durata. La riserva viene presa al tetto di 30 secondi, quindi metti a budget una clip di lunghezza piena quando lo usi.
Oltre a questi, la richiesta espone output_format per mp4 o mov, insieme a bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type e un array tools. return_last_frame è il campo che conta per il concatenamento, perché l'ultimo fotogramma di una generazione è ciò che innesca la successiva.
Regole sul materiale di riferimento che fanno rifiutare una richiesta
La validazione sul materiale di riferimento è rigida e scatta prima che venga creato un task, il che rende un rifiuto gratuito ma anche facile da incontrare ripetutamente.
- Immagini: fino a 30 per richiesta, jpeg, png, webp, bmp, tiff, gif, heic o heif, sotto i 30 MB ciascuna.
- Video: fino a 10 clip, mp4 o mov, 200 MB o meno ciascuna, da 2 a 30 secondi ciascuna, 30 secondi complessivi.
- Audio: fino a 10 tracce, wav o mp3, 15 MB o meno ciascuna, da 2 a 30 secondi ciascuna, 30 secondi complessivi.
Ognuno di questi è un URL HTTP(S) pubblico. I data URI vengono rifiutati su tutta la piattaforma, quindi ospita prima il file.
Le immagini e l'audio di riferimento non aggiungono nulla al conto. Il video di riferimento sì, in due modi, ed è la sezione successiva.
Calcolare il conto prima di inviare
La fatturazione è al secondo di video finito a una tariffa stabilita dalla risoluzione e dal fatto che sia stato allegato un video 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 |
I secondi fatturati sono il maggiore fra due valori: la durata del video di riferimento arrotondata per eccesso più la durata dell'output, oppure cinque terzi della durata dell'output arrotondati per eccesso.
Due esempi svolti mostrano perché conta.
Una generazione da dieci secondi a 1080p senza clip di riferimento fattura dieci secondi a $0.461856, cioè circa $4.62.
Lo stesso output da dieci secondi a 1080p con una clip di riferimento da sei secondi fattura il maggiore fra 16 secondi e 17 secondi, quindi 17 secondi a $0.275904, cioè circa $4.69. La tariffa più bassa viene compensata dalla soglia.
Un job più piccolo mostra l'effetto in modo più netto. Un output da cinque secondi a 720p con una clip di riferimento da tre secondi fattura nove secondi invece di otto, arrivando a circa $1.44, mentre gli stessi cinque secondi generati da zero costano poco più di $1.33.
Polling, tempi e rimborsi
Il job è asincrono. L'invio restituisce un id del task, e il video si recupera interrogando quel task finché non riporta il completamento.
La generazione richiede in media da due a cinque minuti. Il polling è gratis, quindi un intervallo fisso di quindici-venti secondi è ragionevole e non c'è alcun vantaggio a diradare le richieste in modo aggressivo.
I job falliti vengono rimborsati per intero. Le cifre di utilizzo di un task fallito mostrano se l'importo riservato è rientrato, cosa che vale la pena controllare quando un lotto si è comportato male.
Leggere un rifiuto
I rifiuti per sicurezza restituiscono l'errore 80006. L'errore non identifica quale fase è scattata, quindi la causa può essere il prompt, un file di riferimento o l'output generato.
Comincia dal prompt. Le celebrità reali nominate, la proprietà intellettuale di terzi e i contenuti illegali sono bloccati dentro il modello, e nessuna impostazione dell'host li rimuove. Poi controlla le immagini di riferimento, perché un volto o un logo in una fotografia che hai fornito può innescare lo stesso risultato di un nome scritto.
content_filter è true di default. Impostarlo a false instrada la richiesta attraverso un canale meno restrittivo e non disattiva la moderazione. È un controllo di instradamento e non un interruttore, e il vecchio alias nsfw_checker passa ancora la validazione.
Domande frequenti
Quale stringa di modello devo chiamare per Seedance 2.5?
La build rilasciata porta un identificatore che termina in -face. Gli identificatori senza quel suffisso vengono da esempi pre-lancio e non risolvono più.
Come genero una clip più lunga di 30 secondi?
Concatenando le generazioni. Trenta secondi è il tetto per richiesta, quindi i pezzi più lunghi sono job separati uniti in un editor, con return_last_frame che ti dà un punto di passaggio pulito.
Perché un video di riferimento è costato più di quanto suggerisse la tabella delle tariffe? La clip di riferimento viene fatturata per la propria durata in aggiunta all'output, e la richiesta non viene mai fatturata per meno di cinque terzi della durata dell'output, arrotondati per eccesso. Il valore maggiore fra i due diventa il totale dei secondi fatturati.
Disattivare il filtro dei contenuti lascia passare qualsiasi cosa?
No. Impostare content_filter a false seleziona un canale meno restrittivo e la moderazione continua ad applicarsi. I blocchi a livello di modello su celebrità reali, proprietà intellettuale di terzi e contenuti illegali restano al loro posto comunque.
In breve
Come usare Seedance 2.5, in ordine: verifica la stringa di modello -face, imposta la durata fra 4 e 30 secondi, scegli una risoluzione e un rapporto d'aspetto, lascia l'audio attivo a meno che tu non voglia il silenzio, allega liberamente le immagini di riferimento perché sono gratuite, invia, poi fai polling ogni quindici secondi per due-cinque minuti. Calcola il prezzo del job sui secondi fatturati e non sui secondi di output ogni volta che c'è di mezzo un video di riferimento, e tratta l'errore 80006 come un rimborso più una riscrittura.
