ByteDance
Seedance 2.5 Flash
seedance-2.5-flash/text-to-video
La serie di modelli video Seedance 2.5 di ByteDance supporta la generazione di video da testo, la generazione a partire dal primo fotogramma e la generazione con riferimenti multimodali, con output singolo da 4 a 30 secondi, opzioni 480p o 720p e generazione di audio sincronizzato, ideale per la produzione rapida di spot pubblicitari e video di prodotti per l'e-commerce
Prova seedance-2.5-flash/text-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
seedance-2.5-flash/text-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 480P | $0.0679 |
| 720P | $0.1525 |
Panoramica
Questo è un modello di generazione video da testo: basta inserire un prompt testuale per generare una clip video continua con traccia audio. La durata disponibile va da 4 a 30 secondi, la risoluzione è 480p o 720p, e il formato può essere scelto tra 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 e adattivo; l'output è in MP4 o MOV. Per impostazione predefinita vengono generati dialoghi sincronizzati, effetti sonori e suoni di sottofondo. È pensato per i creatori di pubblicità, e-commerce, social media e cortometraggi narrativi, per trasformare rapidamente testi creativi in asset video pronti alla pubblicazione.
Punti di forza principali
- Video con traccia audio direttamente dal prompt — genera di default dialoghi sincronizzati, effetti sonori e audio di sottofondo, riducendo le fasi di aggiunta audio in post-produzione.
- Durata singola da 4 a 30 secondi — il parametro di durata può essere impostato tra 4 e 30 secondi, adatto a un breve video completo o a una scena pubblicitaria.
- Sette formati con opzione adattiva — supporta 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 e adattivo, coprendo orizzontale, quadrato e verticale.
- Doppia risoluzione 480p e 720p — la risoluzione di output è selezionabile tra 480p e 720p, per bilanciare anteprima rapida e output più definito.
Descrizione delle capacità
Generazione video da prompt testuale: inserisci un prompt fino a 5000 caratteri che descriva scena, soggetto, movimento di camera e azione per generare la clip corrispondente; il prompt deve essere specifico per aumentare la prevedibilità.
Controllo di durata e risoluzione: ogni richiesta può impostare una durata da 4 a 30 secondi e scegliere la risoluzione tra 480p e 720p; la fatturazione avviene in base alla durata richiesta.
Formati multipli e adattivo: il formato può essere 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive; con adaptive il modello sceglie il rapporto adatto in base al prompt.
Generazione audio sincronizzata: la generazione audio è attiva per impostazione predefinita e produce dialoghi sincronizzati, effetti sonori e audio di sottofondo insieme alle immagini; è anche possibile disattivarla per ottenere solo il video.
Output MP4 e MOV: il formato di output è selezionabile tra MP4 e MOV; MP4 è il default per compatibilità, MOV è pensato per flussi di post-produzione professionale.
Casi d'uso
- Team pubblicitari che generano short brand da copy — inserisci un prompt con apertura, movimento di camera, azione e chiusura per generare un video con traccia audio da 4 a 30 secondi, da usare per campagne o anteprime di proposta.
- Operatori e-commerce che generano scene di presentazione prodotto — descrivi con testo l'aspetto del prodotto e lo scenario d'uso, scegli un formato quadrato o verticale e produci materiale video breve per la pagina prodotto o i feed.
- Creator social che producono contenuti verticali in serie — con formato 9:16 o 1:1 e durata entro 30 secondi, trasforma testi creativi in brevi video con effetti sonori per gli aggiornamenti quotidiani della piattaforma.
- Autori di cortometraggi narrativi che generano inquadrature continue — con prompt dettagliati che descrivono più personaggi e azioni di scena, genera una clip continua fino a 30 secondi per segmenti narrativi di contenuti brevi.
Limiti e consigli di scelta
La durata massima per singola generazione è di 30 secondi; contenuti più lunghi richiedono generazioni segmentate e successivo montaggio. La risoluzione di output è solo 480p o 720p, senza opzioni di definizione superiore. Il formato è uno tra sette possibilità e non è possibile ottenere più rapporti nella stessa richiesta. Il prompt è limitato a 5000 caratteri; oltre tale limite è necessario sintetizzare. Disattivando la generazione audio, il video di output non ha traccia audio; con l'audio attivo per impostazione predefinita vengono generati dialoghi sincronizzati, effetti sonori e audio di sottofondo insieme alle immagini.
Generazione video da testo · fino a 30 secondi · 480p/720p
seedance-2.5-flash generazione video da testo
Inserisci un prompt testuale e genera una clip video continua con traccia audio. Durata, risoluzione, formato e formato di output sono impostabili in base alle esigenze, adatto alla produzione rapida per pubblicità, e-commerce, social media e cortometraggi narrativi.
- Modalità di inputPrompt testuale
- Intervallo di durata4–30 secondi
- Risoluzione480p / 720p
- Formato di outputMP4 / MOV
Più il prompt descrive in modo specifico scena, soggetto, movimento di camera e azione, più il risultato sarà prevedibile.
Un tranquillo vecchio porto di pescatori all'alba avvolto da una sottile nebbia marina. La camera parte in basso vicino a gradini di pietra bagnata, dove l'acqua di mare sale e si ritira in lente e ritmiche coltri, con la schiuma che si insinua tra le crepe; poi avanza e sale leggermente lungo la banchina, oltre corde arrotolate e anelli di ormeggio arrugginiti, verso piccole barche di legno che ondeggiano dolcemente contro i loro cavi. Un pescatore con una cerata sbiadita si china a tirare una corda, il respiro visibile. In lontananza la luce di un faro pulsa dolcemente tra la nebbia e i gabbiani sfiorano l'acqua bassa. La luce grigio-blu si riscalda gradualmente verso un oro pallido mentre la nebbia si dirada, rivelando superfici bagnate che luccicano di riflessi. Movimento fluttuante e stabile, ritmo senza fretta, profondità ridotta in primo piano, diffusione morbida della nebbia e atmosfera sonora naturale del mare.
01
Capacità
Come si comporta: quattro capacità verificabili
Le seguenti capacità hanno tutte come input un prompt testuale; il punto principale è verificare che durata, risoluzione, formato e attivazione audio corrispondano all'obiettivo.
Generazione video da prompt testuale
Descrivi con un testo scena, soggetto, movimento di camera e azione; il modello genera la clip video di conseguenza. Il prompt è limitato a 5000 caratteri; si consiglia di scrivere chiaramente gli elementi visivi chiave per poter verificare che l'immagine corrisponda alla descrizione.
Un alpinista solitario su ghiaccio, con giacca a guscio rossa, sale una cascata ghiacciata blu con due piccozze, il respiro visibile nell'aria fredda. La camera segue da vicino lungo la parete di ghiaccio, leggermente sopra di lui, catturando schegge di ghiaccio che ruotano via a ogni colpo d'ascia. Un basso rombo attraversa la cresta e una colonna di polvere di neve si riversa oltre la cima della scogliera, crescendo rapidamente. L'alpinista alza lo sguardo, poi si sposta lateralmente con colpi rapidi e decisi, attraversando fuori dalla traiettoria della neve che cade mentre l'ondata bianca spazza via il ghiaccio dietro di lui. Luce diurna fredda, ombre blu profonde dentro il ghiaccio, particelle di neve sospinte dal vento e granulose, urgenza costante a mano che si placa in una rivelazione più ampia della parete montuosa alla fine.
Impostazione di durata e risoluzione
La durata per singola richiesta è impostabile tra 4 e 30 secondi e la risoluzione è selezionabile tra 480p e 720p. La fatturazione avviene in base alla durata richiesta; prima di generare, verifica la durata e la definizione necessarie all'uso previsto del filmato.
Formati multipli e rapporto adattivo
Il formato supporta 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 e adaptive. Con adaptive il modello sceglie il rapporto in base al prompt, adatto alla fase esplorativa in cui il formato di distribuzione non è ancora definito.
Generazione audio e scelta del formato
Per impostazione predefinita vengono generati dialoghi sincronizzati, effetti sonori e audio di sottofondo insieme alle immagini; è possibile disattivarli. Il formato di output è selezionabile tra MP4 e MOV: il primo è compatibile con riproduzione e condivisione comuni, il secondo è pensato per flussi di post-produzione professionale.
Con una descrizione testuale chiara e parametri espliciti di durata, formato e risoluzione è possibile ottenere una clip video con traccia audio; dopo la generazione, verifica soprattutto l'aderenza delle immagini al prompt e lo stato di attivazione dell'audio.
02
Avvio
Dalla descrizione testuale al video finito
Vai alla prova →Dall'obiettivo chiaro alla validazione dell'output, imposta input e parametri passo per passo, modificando un tipo di contenuto alla volta.
- PromptAd esempio: tramonto sul mare, una persona cammina sulla spiaggia, camera che segue lentamente
Una descrizione testuale completa
01
Scrivere un prompt specifico
Nel prompt indica chiaramente scena, soggetto, movimento di camera e azione, entro 5000 caratteri. Più la descrizione è specifica, più il risultato sarà prevedibile.
✓Verifica
→
02
Impostare durata e formato
Scegli la durata da 4 a 30 secondi in base all'uso e specifica la risoluzione 480p o 720p; scegli il formato orizzontale, verticale, quadrato o adattivo in base alla piattaforma di distribuzione.
✓Verifica
→
03
Scegliere audio e formato di output
Verifica se generare l'audio; il formato di output è selezionabile tra MP4 e MOV. Dopo la generazione, controlla l'aderenza delle immagini al prompt e la presenza della traccia audio.
03
Scenari
Dove si usa: tre tipi di video brevi
Short brand e anteprime pubblicitarie
I team pubblicitari usano prompt testuali che includono apertura, movimento di camera, azione e chiusura per generare un video breve con traccia audio, da usare per anteprime o proposte prima della pubblicazione. Verifica soprattutto che il ritmo delle immagini e l'audio siano sincronizzati.
Scene di presentazione prodotto per l'e-commerce
Gli operatori e-commerce descrivono con testo l'aspetto del prodotto e lo scenario d'uso, scelgono un formato quadrato o verticale per generare un video breve da usare per la pagina prodotto o per i materiali dei feed, verificando che l'aspetto del prodotto corrisponda alla descrizione.
Video brevi verticali per i social media
I creator generano video brevi con effetti sonori in formato 9:16 o 1:1, entro 30 secondi, per gli aggiornamenti quotidiani della piattaforma; dopo la generazione verificano che il formato corrisponda ai requisiti della piattaforma e che l'attivazione audio sia conforme alle esigenze.
04
Integrazione
Integrazione: richiama seedance-2.5-flash nel tuo prodotto o nei tuoi strumenti AI
Basta una HiAPI API Key: tutti i metodi condividono lo stesso account e la stessa fatturazione.
- Crea una API Key
- Scegli un metodo di integrazione
A destra scegline uno, copia e vai
- Strumenti di programmazione AI consigliato
Claude Code, Cursor, Codex e altri con accesso MCP via comando
- API diretta
Il tuo prodotto, servizi backend, flussi automatizzati
- Non sai quale scegliere
Copia un messaggio all'AI e lascia che scelga e ti dia i passaggi
Agent Skills · SDK · llms.txt · Tutti i metodi di integrazione →
Terminale · Claude Code
claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Una volta configurato, indica direttamente all'AI il tuo obiettivo e lascia che richiami seedance-2.5-flash, controlli l'avanzamento del task e ottenga il risultato. Per i passaggi di configurazione di Cursor, Codex e altri strumenti, consulta il tutorial qui sotto.
Vedi il tutorial di integrazione Agent →Integra nella tua applicazione tramite API
Usa la API Key per inviare il task del modello corrente e query dello stato tramite l'ID task restituito. I parametri di richiesta usano gli stessi dati di percorso della documentazione API di questa pagina; sostituisci i contenuti di esempio con i tuoi materiali reali.
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}'Lascia che l'AI ti aiuti a scegliere il metodo di integrazione
Leggi l'indice della documentazione HiAPI https://hiapi.ai/llms.txt. Voglio usare seedance-2.5-flash nel mio progetto. In base al mio scenario d'uso, valuta se è più adatto Remote MCP, Agent Skills o l'API diretta; se necessario, fai prima una domanda chiave, poi fornisci i passaggi minimi di integrazione e la configurazione da inserire.
Copia questo messaggio nello strumento AI che utilizzi e aggiungi il linguaggio del progetto, i materiali di input e il risultato atteso. In base a ciò potrà indicare il metodo di integrazione e le operazioni successive.
Novità
Vedi il changelog →- Nuovo modello Rilascio di seedance-2.5-flash/reference-to-video
- Nuovo modello seedance-2.5-flash/image-to-video ora disponibile
- Nuovo modello Lancio di seedance-2.5-flash/text-to-video
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: seedance-2.5-flash/text-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per seedance-2.5-flash/text-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 5000Prompt testuale che descrive il video da generare; più la descrizione di scena, soggetto, movimento di camera e azioni è specifica, più il risultato sarà prevedibile.
durationintegerOpzionalePredefinito: 5min 4max 30Durata del video in uscita, in secondi, con valori da 4 a 30, predefinita 5; la fatturazione si basa sulla durata richiesta.
resolutionstringOpzionalePredefinito: "480p"Risoluzione in uscita; Seedance 2.5 Flash supporta 480p e 720p, con valore predefinito 480p.
480p720paspect_ratiostringOpzionalePredefinito: "adaptive"Proporzioni dell'immagine in uscita, predefinito adaptive, ovvero il modello sceglie automaticamente il rapporto più adatto in base al prompt.
16:94:31:13:49:1621:9adaptiveoutput_formatstringOpzionalePredefinito: "mp4"Formato del file in uscita, predefinito mp4 (scelta generica con migliore compatibilità); mov è adatto alla post-produzione professionale.
mp4movgenerate_audiobooleanOpzionalePredefinito: trueIndica se generare l'audio, inclusi dialoghi sincronizzati con l'immagine, effetti sonori e sottofondo, predefinito true.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.5-flash/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Guida all'uso
Guida all'integrazione di Seedance 2.5 Flash text-to-video: parametri, tariffazione al secondo e pratica ingegneristica
Da una richiesta alla messa in produzione stabile: come impostare i parametri e come calcolare i costi
-
Guida all'uso
Guida all'integrazione di Seedance 2.5 Flash per la generazione di video da immagini: primo frame, ultimo frame e fatturazione al secondo
Far muovere un'immagine: parametri, prezzi e cause comuni di errore
-
Guida all'uso
Guida all'integrazione di Seedance 2.5 Flash per la generazione video da materiali di riferimento: immagini di riferimento, audio di riferimento e regole di fatturazione
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Gemini Omni 1.2 Google $0.023 /secondo -
Creatify Boreal Creatify $0.015 /secondo -
Kling 3.0 Turbo Kuaishou $0.144 /secondo -
OmniHuman 2.0 ByteDance $0.100 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
Grok Imagine 1.5 xAI $0.011 /secondo -
Veo 3.1 Lite Google $0.060 /secondo -
PixVerse V6 Max PixVerse $0.030 /secondo -
Wan 2.7 Video Alibaba $0.100 /secondo -
Kling 4.0 Kuaishou $0.204 /secondo -
HappyHorse 1.0 Alibaba $0.168 /secondo -
Kling 4.0 Flash Kuaishou $0.122 /secondo