ByteDance
Seedance 2.5 Flash
seedance-2.5-flash/image-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/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
seedance-2.5-flash/image-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 480P | $0.0679 |
| 720P | $0.1525 |
Panoramica
Questo modello genera un video continuo a partire da un'immagine del primo fotogramma, mantenendo la composizione e l'aspetto del soggetto del primo fotogramma; è adatto a sviluppatori che necessitano di estendere una scena dinamica da un'immagine statica. Gli input includono un prompt e l'immagine del primo fotogramma, con un'immagine del fotogramma finale opzionale per vincolare la scena conclusiva; la risoluzione di output è 480p o 720p, la durata va da 4 a 30 secondi, il formato è mp4 o mov e le proporzioni si adattano automaticamente a quelle del primo fotogramma. Gli utenti target sono creatori di video brevi, team di produzione pubblicitaria e contenuti e-commerce, che lo utilizzano per trasformare immagini di prodotto o storyboard in clip video pubblicabili.
Punti di forza
- Continuazione della scena guidata dal primo fotogramma—l'immagine del primo fotogramma funge da punto di partenza visivo; il video di output ne mantiene composizione e proporzioni, ideale per estendere una scena già esistente.
- Chiusura vincolata al fotogramma finale opzionale—se viene fornita un'immagine del fotogramma finale, la scena conclusiva si allinea a essa; in caso di proporzioni diverse viene ritagliata al centro per adattarsi al primo fotogramma.
- Durata e risoluzione selezionabili—la durata di output è selezionabile da 4 a 30 secondi, la risoluzione è 480p o 720p, con tariffazione in base alla durata richiesta.
- Generazione audio sincronizzata—per impostazione predefinita vengono generati dialoghi, effetti sonori e audio di sottofondo sincronizzati, senza necessità di aggiungere audio in post-produzione.
Descrizione delle capacità
Generazione video da immagine del primo fotogramma: carica l'immagine del primo fotogramma e inserisci il prompt; il modello genera un video continuo che segue la composizione e il soggetto del primo fotogramma, con proporzioni adattate automaticamente.
Controllo della chiusura con fotogramma finale: è possibile passare opzionalmente un'immagine del fotogramma finale per far transitare la fine del video verso tale immagine; se le proporzioni differiscono, il fotogramma finale viene ritagliato al centro per adattarsi al primo fotogramma e deve essere fornito insieme al primo fotogramma.
Impostazione di durata e risoluzione: una singola richiesta può specificare un output da 4 a 30 secondi con risoluzione 480p o 720p, con tariffazione in base alla durata scelta, adatta a esigenze di inquadrature di diversa lunghezza.
Generazione audio sincronizzata: per impostazione predefinita vengono generati dialoghi, effetti sonori e audio di sottofondo sincronizzati con le immagini; disattivando l'opzione, il video di output è privo di traccia audio.
Scelta del formato di output: il formato di output è selezionabile tra mp4 o mov; mp4 è il formato predefinito per la compatibilità, mov è orientato ai flussi di post-produzione professionali.
Casi d'uso
- Estensione del primo fotogramma per spot pubblicitari e brand—genera inquadrature dinamiche da un'immagine chiave di prodotto o dal primo fotogramma di uno storyboard, ottenendo video da 4 a 30 secondi per sigle pubblicitarie o materiali per social media.
- Dinamizzazione dei display di prodotti e-commerce—genera video dimostrativi o di scenario d'uso da immagini di prodotto, mantenendo l'aspetto del prodotto e producendo mp4 per pagine di dettaglio prodotto e piattaforme di video brevi.
- Video brevi verticali per social media—carica un primo fotogramma verticale e descrivi azioni e movimenti di camera; le proporzioni si adattano automaticamente e generi video brevi con audio da pubblicare sui social.
- Previsualizzazione di storyboard e visualizzazione di concept—usa un'immagine concept come primo fotogramma e controlla il finale con un fotogramma finale, producendo rapidamente video a bassa risoluzione per revisioni interne e previsualizzazione delle inquadrature.
Limiti e suggerimenti di selezione
La durata di output è limitata a 4–30 secondi; contenuti continui più lunghi richiedono generazione in segmenti. Le uniche risoluzioni supportate sono 480p e 720p. Le proporzioni non sono specificabili manualmente e seguono sempre quelle del primo fotogramma; un fotogramma finale con proporzioni diverse viene ritagliato al centro. L'immagine del primo fotogramma deve essere inferiore a 30MB, con lati da 300 a 6000 pixel e rapporto d'aspetto da 0.4 a 2.5; supporta jpeg, png, webp, bmp, tiff, gif, heic e heif. Disattivando la generazione audio, l'output è privo di traccia audio. Il prompt può contenere al massimo 5000 caratteri. I risultati generati non garantiscono una coerenza assoluta dei personaggi o una riproduzione esatta della scena.
Modello image-to-video di ByteDance
Generazione video continua guidata dal primo fotogramma
Genera video da 4 a 30 secondi partendo da un'immagine del primo fotogramma, mantenendo composizione e proporzioni, con chiusura opzionalmente vincolata a un fotogramma finale, risoluzione 480p o 720p e generazione audio sincronizzata per impostazione predefinita.
- Tipo di outputVideo
- Modalità di inputImmagine del primo fotogramma + prompt, immagine del fotogramma finale opzionale
- Risoluzione480p / 720p
- Durata4–30 secondi
Il prompt può contenere al massimo 5000 caratteri e può descrivere movimento, inquadratura e scena; un fotogramma finale con proporzioni diverse viene ritagliato al centro.
Film di prodotto ravvicinato di una teiera in ceramica bianca opaca per pour-over su un piano di lavoro in pietra chiara. La camera parte stretta sul beccuccio e compie lentamente un arco attorno alla teiera mentre questa si inclina in avanti, rilasciando un sottile e costante getto d'acqua calda in una caraffa di vetro sottostante; il vapore sale in volute nella bassa luce mattutina che filtra di lato, rivelando la fine texture granulosa dello smalto, la curva morbida del manico e un riflesso freddo sull'anello del filtro metallico. La profondità di campo ridotta mantiene il getto nitido mentre la cucina sullo sfondo sfuma dolcemente; luce calda e delicata, ritmo calmo e preciso, suono naturale e sincronizzato dell'acqua che scorre, un leggero tintinnio della ceramica e il quieto ambiente sonoro mattutino.
01
Capacità
Come si comporta: quattro capacità verificabili
Le capacità seguenti ruotano tutte attorno all'immagine del primo fotogramma; verificando i materiali di input e le combinazioni di parametri si individua la modalità d'uso adatta.
Generazione guidata dal primo fotogramma
Carica l'immagine del primo fotogramma e inserisci il prompt; il modello genera un video continuo che segue la composizione e il soggetto del primo fotogramma, con proporzioni adattate automaticamente. Ideale per estendere in inquadrature dinamiche asset visivi già esistenti.
La mano di un barista tiene una macinacaffè a collo d'oca e versa un sottile getto d'acqua calda in lente spirali su un filtro di carta colmo di fondi di caffè, che si gonfiano e si sollevano in una morbida cupola di schiuma. La camera parte vicina al cono del filtro da un'angolazione leggermente alta e laterale, poi scivola lentamente in un delicato arco attorno alla teiera, mantenendo a fuoco il beccuccio e il getto d'acqua. Il vapore vaga verso l'alto nella calda luce mattutina obliqua proveniente da una finestra; piano di lavoro in legno, scaldino in ceramica, chicchi di caffè sparsi e un panno di lino sullo sfondo morbido. Ricca texture naturale, profondità di campo ridotta, color grading caldo, ritmo senza fretta con suoni sincronizzati di versamento e acqua che gocciola.
Vincolo di chiusura con fotogramma finale
È possibile passare opzionalmente un'immagine del fotogramma finale per far transitare la fine del video verso tale immagine. Se le proporzioni del fotogramma finale differiscono da quelle del primo, viene ritagliato al centro per adattarsi; il fotogramma finale dipende dalla contemporanea presenza del primo fotogramma. Serve a controllare la scena conclusiva.
L'inquadratura si avvicina lentamente alla visuale chiave del prodotto dal primo fotogramma; la luce passa gradualmente da una morbida luce laterale a un'illuminazione stabile della scena conclusiva, e il finale si posa naturalmente sulla composizione del fotogramma finale.
Controllo di durata e risoluzione
Una singola richiesta può specificare un output da 4 a 30 secondi con risoluzione 480p o 720p. La tariffazione dipende dalla durata scelta: per inquadrature brevi si può optare per una risoluzione bassa e una verifica rapida, mentre le inquadrature lunghe possono arrivare a 30 secondi.
Un tranquillo lago alpino all'alba, ripreso da un punto di vista fisso e basso vicino alla riva: strati di nebbia pallida si spostano lentamente sull'acqua immobile, diradandosi mentre la calda luce dell'alba spinge da dietro la cresta lontana; il riflesso delle cime innevate e della scura foresta di pini diventa gradualmente nitido; una sottile increspatura si propaga dal guizzo di un pesce, piegando il riflesso, e un singolo uccello acquatico sfiora l'acqua in volo radente, con le ali quasi a contatto; lento e sottile push-in sulla nebbia, ritmo calmo, suono naturale mattutino della brezza tra i pini, richiami lontani di uccelli e il morbido sciacquio dell'acqua.
Audio sincronizzato e formato di output
Per impostazione predefinita vengono generati dialoghi, effetti sonori e audio di sottofondo sincronizzati con le immagini; è possibile disattivarli. Il formato di output è selezionabile tra mp4 o mov; mp4 è il formato predefinito per la compatibilità, mov è orientato ai flussi di post-produzione professionali.
L'immagine del primo fotogramma determina il punto di partenza visivo, il prompt controlla movimento e inquadratura, durata e risoluzione si scelgono in base alle esigenze, il fotogramma finale può vincolare la chiusura e l'audio è attivo per impostazione predefinita.
02
Per iniziare
Dal primo fotogramma alla clip video
Prova ora →Dalla preparazione dell'immagine del primo fotogramma alla verifica dell'output, ogni passo modifica un solo tipo di input, così è più facile individuare le variazioni di effetto.
- Formato immaginejpeg/png/webp/bmp/tiff/gif/heic/heif
- Dimensione e pixelinferiore a 30MB, lati da 300 a 6000 pixel
- Rapporto d'aspetto0.4–2.5
Ottieni un'immagine del primo fotogramma utilizzabile
01
Prepara l'immagine del primo fotogramma
Scegli un'immagine con composizione nitida come primo fotogramma e verifica che formato, dimensione, pixel e rapporto d'aspetto siano conformi; le proporzioni seguiranno automaticamente questa immagine.
- Promptdescrivi movimento, inquadratura e scena
- Limite caratteri5000 caratteri
Ottieni istruzioni di generazione chiare
02
Scrivi il prompt di movimento
Usa il prompt per descrivere il movimento, l'inquadratura, la scena e i suoni desiderati, con un massimo di 5000 caratteri, concentrandoti sui cambiamenti dell'immagine anziché ripetere l'aspetto statico.
- Durata4–30 secondi
- Risoluzione480p o 720p
- Fotogramma finaleopzionale, se le proporzioni differiscono viene ritagliato al centro
Ottieni una clip video utilizzabile
03
Imposta i parametri e verifica l'output
Scegli una durata da 4 a 30 secondi e una risoluzione 480p o 720p, fornisci opzionalmente il fotogramma finale o disattiva l'audio, quindi dopo la generazione verifica che composizione, durata e traccia audio corrispondano alle aspettative.
03
Scenari
Dove usarlo: tre tipologie tipiche di video brevi
Dinamizzazione di sigle pubblicitarie
Usa la visuale chiave del prodotto come primo fotogramma e descrivi nel prompt movimenti di camera e variazioni di luce, generando video da 4 a 30 secondi per sigle pubblicitarie o pubblicazioni sui social. Verifica che l'aspetto del soggetto sia mantenuto e che il movimento di camera sia naturale.
Partendo dalla visuale chiave del prodotto del primo fotogramma, la camera si sposta lentamente in orizzontale compiendo un leggero arco; i riflessi sulla superficie del prodotto scorrono con la luce, le fasce luminose dello sfondo cambiano lentamente e l'aspetto del soggetto resta stabile, adatto come sigla pubblicitaria.
Video di scenario per prodotti e-commerce
Inserisci un'immagine del prodotto come primo fotogramma e descrivi scenario d'uso e azioni; l'output è un video dimostrativo con audio per pagine di dettaglio prodotto e piattaforme di video brevi. Verifica che dettagli e proporzioni del prodotto coincidano con il primo fotogramma.
Il prodotto parte dalla disposizione frontale del primo fotogramma; la scena passa naturalmente da un piano di lavoro interno all'ambiente d'uso, con leggeri movimenti delle mani e dimostrazione dell'effetto d'uso, mantenendo coerenti dettagli e proporzioni del prodotto, mentre la camera avanza con fluidità.
Verifica a bassa risoluzione per previsualizzazione di storyboard
Usa un'immagine concept come primo fotogramma, scegli 480p per generare rapidamente un video breve e controlla il finale con un fotogramma finale, per revisioni interne di ritmo delle inquadrature e composizione. Dopo la conferma, puoi rigenerare a 720p.
Storia cinematografica di un angolo di strada in una notte piovosa. Una giovane donna con un ombrello trasparente si allontana dalla camera lungo un marciapiede bagnato, poi rallenta, si volta e si accovaccia accanto a una scatola di cartone inzuppata dove è rannicchiato un piccolo cane tremante. Inclina l'ombrello per riparare la scatola, la mano protesa esitante, il cane che solleva la testa. La camera parte dietro di lei all'altezza delle spalle, segue i suoi passi, poi compie un arco e si abbassa fino a una vista ravvicinata e bassa del suo volto e del cane, mentre le insegne al neon si sciolgono nelle pozzanghere. La pioggia segna i bordi dell'obiettivo, la calda luce dei negozi si mescola al freddo lampione blu, i riflessi tremolano sull'asfalto. Audio naturale sincronizzato: pioggia su tessuto e asfalto, traffico lontano, passi leggeri, un piccolo guaito, respiro quieto.
04
Integrazione
Integrazione: chiama 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
Scegli uno di quelli a destra e copialo
- Strumenti di programmazione AI consigliato
Claude Code, Cursor, Codex e altri strumenti via comando con MCP
- API diretta
Il tuo prodotto, servizi backend, flussi automatizzati
- Non sai quale scegliere
Copia un testo all'AI e lascia che scelga e ti fornisca 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"Dopo il collegamento, indica direttamente all'AI il tuo obiettivo e lascia che chiami seedance-2.5-flash, verifichi l'avanzamento dell'attività e ottenga i risultati. I passaggi di configurazione per Cursor, Codex e altri strumenti sono nella guida qui sotto.
Visualizza la guida all'integrazione degli Agent →Integra nella tua��prodotto tramite API
Usa la API Key per inviare l'attività del modello corrente e verifica lo stato tramite l'ID attività restituito. I parametri della richiesta utilizzano gli stessi dati di percorso della documentazione dell'interfaccia di questa pagina; sostituisci i contenuti di input degli esempi con i tuoi materiali effettivi.
# 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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}'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 API diretta; se necessario, fammi prima una domanda chiave, poi fornisci i passaggi minimi di integrazione e la configurazione da inserire.
Copia questo testo nello strumento AI che usi e aggiungi linguaggio del progetto, materiali di input e risultati attesi. Potrà così indicarti il metodo di integrazione e i passaggi successivi.
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
Domande frequenti
Vedi tutte le domande →-
Quanti secondi può durare al massimo un video generato da un'immagine?
La durata massima per una singola generazione è di 30 secondi, la minima di 4 secondi, con un valore predefinito di 5 secondi. Il campo duration determina direttamente la durata ed è anche la base per la fatturazione in base alla durata richiesta; per ottenere video più lunghi è necessario generare più segmenti e poi concatenarli.
-
Quali sono i requisiti di formato e dimensione per l'immagine del primo fotogramma?
Sono supportati i formati jpeg, png, webp, bmp, tiff, gif, heic e heif, con una dimensione massima di 30 MB per immagine, lati da 300 a 6000 pixel e un rapporto d'aspetto compreso tra 0,4 e 2,5. Le immagini fuori da questi intervalli non vengono elaborate e l'operazione fallisce direttamente; si consiglia di ridimensionarle e convertirle prima di caricarle.
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/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per seedance-2.5-flash/image-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 5000Descrivi l'azione, la camera, la scena e l'audio desiderati; il video partirà dall'immagine del primo fotogramma e genererà il contenuto in base a questo testo.
durationintegerOpzionalePredefinito: 5min 4max 30Durata del video di output, in secondi, con valori da 4 a 30; predefinito 5 secondi, con fatturazione basata sulla durata richiesta.
resolutionstringOpzionalePredefinito: "480p"Risoluzione di output; Seedance 2.5 Flash supporta 480p e 720p; predefinito 480p.
480p720paspect_ratiostringOpzionalePredefinito: "adaptive"Proporzioni dell'immagine di output; per la generazione video da immagine è fissato ad adaptive, e le proporzioni di output seguono l'immagine del primo fotogramma; predefinito adaptive.
adaptiveoutput_formatstringOpzionalePredefinito: "mp4"Formato contenitore del video di output; mp4 è il valore predefinito con migliore compatibilità, mov è destinato alla post-produzione professionale; predefinito mp4.
mp4movgenerate_audiobooleanOpzionalePredefinito: trueIndica se generare dialoghi, effetti sonori e audio di sottofondo sincronizzati con le immagini; predefinito true.
last_frame_urlstringOpzionaleURL opzionale dell'immagine dell'ultimo fotogramma, con gli stessi vincoli del primo fotogramma; se le proporzioni differiscono da quelle del primo fotogramma, viene ritagliata centralmente per adattarsi.
first_frame_urlstringObbligatorioURL dell'immagine del primo fotogramma, obbligatorio. Supporta i formati jpeg, png, webp, bmp, tiff, gif, heic, heif, con dimensione non superiore a 30 MB, da 300 a 6000 pixel per lato e proporzioni tra 0,4 e 2,5.
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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}' 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/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"first_frame_url": "…"
}
}),
});
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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True,
"first_frame_url": "…"
}
},
)
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 video da materiali di riferimento: immagini di riferimento, audio di riferimento e regole di fatturazione
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Gemini Omni 1.2 Google $0.023 /secondo -
LTX 2.5 Fast Lightricks $0.086 /secondo -
Creatify Boreal Creatify $0.015 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Muse Video 1.0 Meta $0.034 /video -
Veo 3.1 Fast Google $0.170 /secondo -
Kling 4.0 Kuaishou $0.204 /secondo -
MiniMax H3 Max Turbo MiniMax $0.025 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
Kling 4.0 Flash Kuaishou $0.122 /secondo -
Kandinsky 6.0 Pro $1.93 /video -
Seedance 2.0 ByteDance $0.017 /secondo



