
La Seedance 2.5 API su PoYo ha due ID modello: seedance-2.5-flash per la Seedance 2.5 Flash API, rilasciata da ByteDance il 12 novembre 2026, e seedance-2.5 per il modello standard. Condividono un endpoint e un formato di richiesta, quindi la scelta è una decisione di instradamento per singola richiesta: risoluzione, numero di riferimenti, costo e rapidità con cui serve il risultato. Questo confronto è stato verificato su entrambe le pagine della documentazione il 16 novembre 2026.
Stessa richiesta Seedance 2.5 API, due ID modello
Entrambi i modelli vengono inviati a POST https://api.poyo.ai/api/generate/submit e letti da GET /api/generate/status/{task_id} o tramite un callback_url. I campi di input hanno gli stessi nomi e significati:
| Campo | seedance-2.5-flash | seedance-2.5 |
|---|---|---|
prompt | Obbligatorio | Obbligatorio |
duration | Obbligatorio, intero 4–30 | Obbligatorio, intero 4–30 |
resolution | Facoltativo: 480p, 720p (predefinito 720p) | Obbligatorio: 480p, 720p, 1080p |
aspect_ratio | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Stessi sette valori |
generate_audio | Booleano, predefinito true | Booleano |
image_urls | Primo fotogramma + ultimo fotogramma facoltativo; aspect_ratio auto | Uguale |
reference_image_urls | Fino a 10 | Fino a 30 |
reference_video_urls | Fino a 5 | Fino a 10 |
reference_audio_urls | Fino a 5, richiede un'immagine o un video di riferimento | Fino a 10, richiede un'immagine o un video di riferimento |
Su entrambi, image_urls non può essere combinato con i campi di riferimento, i riferimenti si richiamano nel prompt come @Image1, @Video1, @Audio1, e tutti gli URL dei media devono essere pubblici e scaricabili direttamente. L'unica trappola dello schema: resolution è facoltativo su Flash ma obbligatorio su seedance-2.5. Se il tuo client si affida al valore predefinito di 720p di Flash, aggiungi resolution esplicitamente prima di instradare una richiesta verso il modello standard.
I limiti che cambiano
| Limite | Flash | Standard |
|---|---|---|
| Risoluzione di output | 480p, 720p | 480p, 720p, 1080p |
| Durata per generazione | 4–30 s | 4–30 s |
| Immagini / video / audio di riferimento | 10 / 5 / 5 | 30 / 10 / 10 (massimo 50 file) |
| Velocità di generazione | Quasi il doppio, secondo ByteDance | Riferimento |
La documentazione di Flash pubblica anche regole per singolo file: immagini JPEG, PNG o WebP fino a 30 MB; video di riferimento MP4 o MOV, 2–30 s e fino a 200 MB ciascuno, al massimo 30 s complessivi; audio di riferimento MP3 o WAV, 2–30 s e fino a 15 MB ciascuno, al massimo 30 s complessivi. La pagina della documentazione di Seedance 2.5 non indica dimensioni per singolo file, quindi non dare per scontato un limite più ampio sul modello standard.
Prezzo per richiesta identica
Stesso body, cambia solo l'ID modello. 1 credito = $0.005; l'audio generato è gratuito su entrambi.
| Richiesta | seedance-2.5-flash | seedance-2.5 | Risparmio con Flash |
|---|---|---|---|
| 5 s, 480p | 92.5 crediti ($0.4625) | 140 crediti ($0.70) | 33.9% |
| 10 s, 480p | 185 crediti ($0.925) | 280 crediti ($1.40) | 33.9% |
| 10 s, 720p | 410 crediti ($2.05) | 630 crediti ($3.15) | 34.9% |
| 30 s, 720p | 1,230 crediti ($6.15) | 1,890 crediti ($9.45) | 34.9% |
| 30 s, 1080p | Non supportato | 3,420 crediti ($17.10) | — |
| 10 s, 720p + un video di riferimento da 10 s | 510 crediti ($2.55) | 760 crediti ($3.80) | 32.9% |
Con un video di riferimento, entrambi i modelli fatturano i secondi di output più la durata di ciascun video di riferimento arrotondata per difetto, alla tariffa ridotta con video (Flash 11,5 / 25,5 crediti; standard 17 / 38 / 68,5 crediti a 480p / 720p / 1080p). L'articolo sui prezzi della Seedance 2.5 API contiene la tabella completa, le tariffe pubblicate da fal e flussi di lavoro calcolati.
Velocità: la dichiarazione di ByteDance e i tempi misurati da PoYo
ByteDance descrive Seedance 2.5 Flash come capace di offrire risultati vicini al modello di punta Seedance 2.5 a una velocità di generazione quasi doppia. È una dichiarazione del fornitore; ByteDance non ha pubblicato la configurazione di test alla base su una pagina che abbiamo potuto consultare.
Ecco cosa ha misurato PoYo il 16 novembre 2026, end to end tramite l'API, su seedance-2.5-flash:
| Richiesta | Tempo fino a finished |
|---|---|
| 4 s, 480p | Circa 2 minuti |
| 30 s, 720p | Meno di 3 minuti |
Non abbiamo eseguito un test di tempistica equivalente su seedance-2.5, quindi questo articolo non riporta un'accelerazione misurata. I tempi variano con il carico. In ogni caso, progetta in modo asincrono: la documentazione sullo stato indica per la generazione video tempi tipici di 90–300 secondi, troppo lunghi per tenere aperta una richiesta HTTP sincrona.
Quale ID modello chiamare, per caso d'uso
| Caso d'uso | ID modello | Motivo |
|---|---|---|
| Test dei prompt, varianti A/B | seedance-2.5-flash a 480p | 18,5 crediti al secondo, la tariffa Seedance 2.5 più bassa |
| Clip social ad alto volume a 720p | seedance-2.5-flash | 41 contro 63 crediti al secondo |
| Generazione rivolta agli utenti in cui conta l'attesa | seedance-2.5-flash | La dichiarazione di velocità di ByteDance; i tempi PoYo sopra |
| Consegna a 1080p | seedance-2.5 | Flash non ha il 1080p |
| Più di 10 immagini, 5 video o 5 audio di riferimento | seedance-2.5 | Limiti di riferimento più alti |
| Render finale di una bozza Flash approvata | seedance-2.5 | Modello di punta, stesso body di richiesta |
| Storyboard e animatic | Flash, poi seedance-2.5 per le inquadrature principali | Itera a basso costo, finalizza sul modello di punta |
Instradare tra i due ID modello nel codice
Questo router mantiene un unico costruttore di richieste per entrambi. Invia una richiesta al modello standard solo quando Flash non può gestirla o quando la tua policy la contrassegna come render finale:
FLASH_LIMITS = {
"reference_image_urls": 10,
"reference_video_urls": 5,
"reference_audio_urls": 5,
}
def pick_model_id(input_body, final_render=False):
if input_body.get("resolution") == "1080p":
return "seedance-2.5"
for field, limit in FLASH_LIMITS.items():
if len(input_body.get(field) or []) > limit:
return "seedance-2.5"
if final_render:
return "seedance-2.5"
return "seedance-2.5-flash"
def build_request(input_body, final_render=False, callback_url=None):
body = dict(input_body)
body.setdefault("resolution", "720p") # required on seedance-2.5
request = {"model": pick_model_id(body, final_render), "input": body}
if callback_url:
request["callback_url"] = callback_url
return request
Invia il dict restituito a /api/generate/submit come nella guida alla Seedance 2.5 Flash API, che copre anche polling, callback ed errori.
Diff di migrazione: promuovere una bozza Flash a 1080p
Spostare una bozza approvata sul modello standard cambia due righe:
{
- "model": "seedance-2.5-flash",
+ "model": "seedance-2.5",
"input": {
"prompt": "A paper boat drifts under a stone bridge at sunrise. Slow tracking shot.",
"duration": 10,
- "resolution": "480p",
+ "resolution": "1080p",
"aspect_ratio": "16:9"
}
}
Mantieni invariati prompt, durata, rapporto d'aspetto e URL dei media, così il render finale segue lo stesso brief. Il costo di quel render passa da 185 crediti ($0.925) con Flash a 480p a 1.140 crediti ($5.70) con lo standard a 1080p. Una nuova generazione non è un upscale fotogramma per fotogramma della bozza, quindi aspettati differenze. Per il confronto di Seedance 2.5 con le API video di altri fornitori, vedi Kling 4.0 vs Seedance 2.5 e MiniMax H3 vs Seedance 2.5, e la pagina del modello Seedance 2.5 per il relativo playground.
Domande frequenti
Qual è la differenza tra la Seedance 2.5 Flash API e la Seedance 2.5 API? Stessi campi e stesso endpoint. Flash produce output a 480p o 720p con fino a 10 / 5 / 5 riferimenti di immagini, video e audio, e costa circa un terzo in meno al secondo. Lo standard aggiunge il 1080p e fino a 30 / 10 / 10 riferimenti.
Posso passare da Seedance 2.5 Flash a Seedance 2.5 cambiando solo l'ID modello? Sì, purché la richiesta includa resolution, obbligatorio su seedance-2.5, e rientri nei suoi limiti.
La Seedance 2.5 Flash API è più veloce di Seedance 2.5? ByteDance afferma che genera a una velocità quasi doppia. PoYo ha misurato su Flash circa 2 minuti per 4 s a 480p e meno di 3 minuti per 30 s a 720p; non abbiamo tempi equivalenti per il modello standard.
Quale modello della Seedance 2.5 API supporta il 1080p? Solo seedance-2.5, a 114 crediti ($0.57) al secondo.
Quanti file di riferimento accetta la Seedance 2.5 Flash API? Fino a 10 immagini, 5 video e 5 clip audio per richiesta, con video di riferimento e audio di riferimento ciascuno al massimo di 30 secondi complessivi.