ByteDance
Seedance 2.5
seedance-2.5/image-to-video
Modello di generazione congiunta audio-video di ByteDance Seed, supporta clip continue fino a 30 secondi e fino a 4K, con controllo preciso delle immagini basato su riferimenti multimodali e editing a livello di timestamp
Prova seedance-2.5/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
seedance-2.5/image-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 720P | $0.204 |
| 1080P | $0.516 |
Panoramica della posizione
La linea Seedance 2.5 per video da immagine è pensata per gli sviluppatori che necessitano di un controllo preciso dell'immagine: partendo da un'immagine del primo fotogramma, con la possibilità di vincolare il punto di arrivo tramite un fotogramma finale, si descrivono movimento, inquadratura e scena con un prompt, ottenendo in output un video coerente da 4 a 30 secondi. Il modello genera le immagini e contemporaneamente produce dialoghi, effetti sonori e suoni ambientali sincronizzati, supportando output a 720p e 1080p e due formati contenitore, mp4 e mov. È adatto a chi dispone già di materiali a immagine fissa e deve estenderli in brevi video: presentazioni di prodotto, previsualizzazione di spot pubblicitari e produzione di contenuti in serie.
Punti di forza principali
- Inquadratura vincolata da primo e ultimo fotogramma — si fornisce il primo fotogramma e, facoltativamente, si specifica quello finale, facendo sì che sia il punto di partenza sia quello di arrivo del video generato ricadano su materiali esistenti, riducendo le rigenerazioni ripetute.
- Immagine e audio generati in un'unica passata — per impostazione predefinita vengono prodotti in sincrono dialoghi, effetti sonori e audio di sottofondo, senza necessità di un doppiaggio separato da allineare.
- Prompt supportati in undici lingue — le istruzioni su movimento, inquadratura, scena e audio possono essere scritte in più lingue, facilitando la collaborazione di team multilingue.
- Risoluzione e formato contenitore selezionabili — supporta 720p e 1080p, mp4 e mov; il mov agevola l'inserimento nei flussi di post-produzione professionali.
Descrizione delle capacità
Generazione video guidata dal primo fotogramma: genera un video a partire da un'immagine del primo fotogramma in formati come jpeg, png e webp; le proporzioni dell'immagine si adattano a quelle del primo fotogramma, ideale per la creazione in continuità con immagini fisse già definitive.
Controllo del punto di arrivo tramite fotogramma finale: è possibile aggiungere un'immagine del fotogramma finale per vincolare l'immagine di chiusura del video; in caso di proporzioni non coincidenti, viene ritagliata centralmente per adattarsi al primo fotogramma, utile per inquadrature con chiusura su un punto preciso.
Generazione audio sincronizzata: per impostazione predefinita genera dialoghi, effetti sonori e audio di sottofondo sincronizzati con l'immagine; è possibile disattivarla per ottenere materiale solo visivo da affidare alla post-produzione.
Parametri di durata e qualità: la durata si imposta in numeri interi da 4 a 30 secondi e la fatturazione avviene in base alla durata richiesta; la risoluzione si sceglie tra 720p e 1080p e l'output è in mp4 o mov.
Integrazione di informazioni da rete: è possibile attivare la ricerca su internet, così che le informazioni soggette a scadenza menzionate nel prompt vengano considerate durante la generazione.
Scenari applicativi
- Team e-commerce e di prodotto: immagini di prodotto definitive — generare un breve video dimostrativo a partire da un'immagine fissa del prodotto come primo fotogramma; immagini e audio vengono prodotti in sincrono e sono utilizzabili direttamente per pagine di dettaglio o materiali pubblicitari.
- Team creativi pubblicitari: fotogrammi chiave dello storyboard — estendere i fotogrammi chiave di uno storyboard in clip con movimento di camera ed effetti sonori, per presentazioni di proposta e previsualizzazioni prima delle riprese.
- Gestione contenuti di marca: immagini definitive di personaggi e scene — estendere immagini già definitive di personaggi o scene in brevi video in serie, mantenendo la coerenza estetica e producendo contenuti social in batch.
- Post-produzione: completamento di inquadrature tramite primo e ultimo fotogramma — generare il processo intermedio date le immagini di inizio e fine, per raccordare materiali o completare inquadrature di transizione.
Limiti e consigli di selezione
La durata massima di un singolo frammento generato è di 30 secondi; contenuti più lunghi devono essere suddivisi in più segmenti generati separatamente. La plausibilità fisica dei movimenti complessi e la stabilità delle interazioni tra più soggetti restano punti deboli noti; per inquadrature con ampi movimenti o con molti personaggi si consiglia di validare prima con un campione ridotto. Quando si forniscono contemporaneamente primo e ultimo fotogramma non è possibile aggiungere immagini o audio di riferimento; per vincoli con più riferimenti occorre passare alla linea di generazione video da riferimento. Per esigenze leggere, con inquadratura singola e con requisiti di controllabilità non elevati, è possibile scegliere una linea più semplificata di testo in video.
Domande frequenti
Vedi tutte le domande →-
Con Seedance 2.5 image-to-video è necessario caricare sia il primo che l'ultimo frame?
No. In modalità primo frame/primo e ultimo frame, caricando solo first_frame_url il modello estende naturalmente le immagini successive a partire dal primo frame; se serve controllare lo stato finale dell'inquadratura, fornisci anche last_frame_url. L'ultimo frame non può essere usato da solo. In alternativa puoi usare reference_image_urls o reference_audio_urls come modalità di riferimento, senza passare i frame di estremità.
-
È possibile combinare primo frame, primo/ultimo frame e più materiali di riferimento in un'unica richiesta?
Attualmente HiAPI Playground li gestisce come due modalità di input: modalità primo frame/primo e ultimo frame, oppure modalità di riferimento reference_image_urls, reference_audio_urls. Per evitare conflitti tra i segnali di controllo, mantieni una sola modalità per volta; se hai bisogno di un video di riferimento per guidare movimenti o inquadrature, utilizza il separato seedance-2.5/reference-to-video.
-
Quali durate e risoluzioni supporta Seedance 2.5 per la generazione di video da immagine?
Il contratto di richiesta attuale supporta durate intere da 4 a 30 secondi, nonché 720p e 1080p. L'aspect_ratio di output è fisso su adaptive e segue il formato del primo fotogramma. I quattro esempi della pagina sono tutti in 720p, di cui tre da 4 secondi e uno da 5 secondi; i 30 secondi rientrano nell'intervallo supportato dall'API, ma al momento non ci sono esempi corrispondenti nella pagina.
-
Come viene fatturato Seedance 2.5 per la generazione video da immagine?
La fatturazione si basa sulla durata dell'output e sulla risoluzione; 720p e 1080p utilizzano tariffe al secondo diverse; gli importi esatti sono determinati dal prezzo in tempo reale nella pagina del modello e dal registro delle attività.
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/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per seedance-2.5/image-to-video e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 10000Fornisci istruzioni di generazione relative ad azioni, inquadratura, scena e audio; supporta più lingue per i prompt.
durationintegerOpzionalePredefinito: 5min 4max 30Durata del video di output, in secondi; inserisci un numero intero da 4 a 30, predefinito 5. HiAPI fattura in base alla durata richiesta.
watermarkbooleanOpzionalePredefinito: falseSe aggiungere la filigrana di generazione AI nell'angolo in basso a destra dell'immagine; predefinito false.
resolutionstringOpzionalePredefinito: "720p"Risoluzione del video di output; supporta 720p e 1080p, predefinito 720p.
720p1080pweb_searchbooleanOpzionalePredefinito: falseSe consentire al modello di recuperare online informazioni in tempo reale menzionate nel prompt; predefinito false.
aspect_ratiostringOpzionalePredefinito: "adaptive"Proporzioni dell'immagine di output; per la generazione video da immagine si usa adaptive, così il video segue il primo fotogramma; predefinito adaptive.
adaptiveoutput_formatstringOpzionalePredefinito: "mp4"Formato file del video di output; mp4 è il valore predefinito con migliore compatibilità, mov è destinato alla post-produzione professionale; predefinito mp4.
mp4movgenerate_audiobooleanOpzionalePredefinito: trueSe generare dialoghi, effetti sonori e audio di sottofondo sincronizzati; predefinito true.
last_frame_urlstringOpzionaleOpzionale, specifica l'immagine dell'ultimo fotogramma; puoi passare un URL immagine, un data URL o un ID materiale; i vincoli del file sono gli stessi del primo fotogramma; se le proporzioni differiscono da quelle del primo fotogramma, viene ritagliata al centro per allinearsi al primo fotogramma.
first_frame_urlstringOpzionaleImmagine del primo fotogramma; puoi passare un URL immagine, un data URL o un ID materiale; supporta vari formati immagine comuni, dimensione non superiore a 30 MB, 300–6000 pixel per lato, proporzioni 0.4–2.5. Obbligatorio quando viene fornito last_frame_url.
reference_audio_urlsarrayOpzionalemaxItems 10Array di URL di audio di riferimento, massimo 10 voci; supporta wav e mp3, ogni voce non superiore a 15 MB e con durata 2–30 secondi, durata totale non superiore a 30 secondi.
Array [ string ]
reference_image_urlsarrayOpzionalemaxItems 30Array di URL di immagini di riferimento, massimo 30 voci; supporta vari formati immagine comuni, ogni immagine non superiore a 30 MB, 300–6000 pixel per lato, proporzioni 0.4–2.5.
Array [ string ]
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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "720p",
"web_search": false,
"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/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "720p",
"web_search": false,
"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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"watermark": False,
"resolution": "720p",
"web_search": False,
"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 →-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Wan 2.7 Video Alibaba $0.100 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
Gemini Omni Google -- -
Veo 3.1 Google $0.290 /secondo -
Veo 3.1 Fast Google $0.170 /secondo -
Kling 2.5 Kuaishou $0.060 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
Vidu Q3 Vidu $0.149 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Hailuo 2.3 MiniMax $0.270 /video

