ByteDance

Seedance 2.5

seedance-2.5/text-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

seedance-2.5/image-to-video seedance-2.5/reference-to-video seedance-2.5/text-to-video

Prova seedance-2.5/text-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

seedance-2.5/text-to-video per second

Specifiche	Prezzo unitario
720P	$0.204
1080P	$0.516

Panoramica della posizione

Seedance 2.5 è un modello di generazione congiunta audio-video sviluppato dal team Seed di ByteDance; questa linea si occupa della generazione di video a partire da solo testo: lo sviluppatore scrive un prompt e ottiene un filmato completo con voce sincronizzata, effetti sonori e suoni ambientali. Supporta durate da 4 a 30 secondi, risoluzioni 720p e 1080p, sette formati di immagine e output mp4/mov, e consente di attivare la ricerca web per integrare informazioni aggiornate nei prompt. È adatta a team di sviluppo che necessitano di produrre rapidamente spot pubblicitari con audio, previsualizzazioni di storyboard e video brevi per i social media, integrandoli in batch tramite l'interfaccia unificata di HiAPI.ai.

Punti chiave

La generazione da testo include già l'audio sincronizzato——la generazione audio è attiva per impostazione predefinita: immagini, voce, effetti sonori e sottofondo vengono prodotti in un'unica soluzione, eliminando le fasi di doppiaggio e sincronizzazione in post-produzione.
Durata e formato specificabili per inquadratura——durata impostabile liberamente da 4 a 30 secondi interi; i formati supportano sette opzioni dal 16:9 al 21:9, mentre adaptive può essere deciso dal prompt stesso.
Il prompt può attivare la ricerca web——attivando web_search, il modello può cercare informazioni aggiornate menzionate nel prompt, utile per contenuti che richiedono fatti recenti.
Formati di output pensati per il flusso di post-produzione——mp4 per impostazione predefinita per la distribuzione diretta, mov per il montaggio professionale e la post-produzione.

Descrizione delle capacità

Generazione audio-video in un'unica soluzione: una singola generazione produce contemporaneamente immagini e audio sincronizzato, inclusi dialoghi, effetti sonori e suoni di sottofondo; l'output è un file video pronto all'uso, riducendo i costi di compositing in post-produzione.

Durata e risoluzione controllabili: fatturazione a tempo, con durata specificabile da 4 a 30 secondi interi e risoluzione 720p o 1080p, per controllare le specifiche del filmato in base ai requisiti del canale.

Adattamento multi-formato: offre formati 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 e adaptive; lo stesso prompt può coprire posizionamenti orizzontali, verticali e quadrati.

Prompt multilingua: supporta prompt in cinese, inglese, giapponese, coreano, spagnolo, portoghese, indonesiano, malese, thailandese, arabo e vietnamita.

Retrieval augmentation e opzioni di confezionamento: è possibile attivare la ricerca web per introdurre informazioni aggiornate e scegliere se aggiungere la filigrana di generazione AI e output in mp4 o mov.

Casi d'uso

Team pubblicitari e di branding: descrizione del punto di vendita in una frase——genera brevi video di prodotto da 10 a 30 secondi con voce fuori campo e musica, utilizzabili direttamente per campagne in-feed o teaser sui social.
Creator di video brevi: script narrativo in verticale——genera segmenti narrativi completi in formato 9:16, producendo materiale video pronto per il caricamento.
Team di pre-produzione cinematografica: descrizione testuale dello storyboard——converte lo storyboard testuale in previsualizzazioni dinamiche con audio, per confermare ritmo delle inquadrature e durata prima delle riprese.
Sviluppatori di piattaforme: produzione in batch basata su template——tramite l'interfaccia unificata, genera in batch versioni con formati e durate diverse dallo stesso template di prompt, integrandole nella propria pipeline di produzione di contenuti.

Limiti e suggerimenti per la scelta

Questa linea genera video solo da testo e non accetta input di immagini o materiali di riferimento; qualora si debbano fissare personaggi, l'aspetto del prodotto o apportare modifiche a livello di timestamp, occorre passare alle linee della stessa famiglia per la generazione con riferimento o image-to-video. La durata massima di una singola clip è di 30 secondi e non esistono parametri di continuazione: per narrazioni più lunghe è necessario generare per inquadrature e poi montare. La plausibilità fisica di azioni complesse e la stabilità delle interazioni tra più soggetti possono risultare ancora insufficienti. Per esigenze leggere e di breve durata si possono considerare modelli più semplici per contenere i costi.

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

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: seedance-2.5/text-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per seedance-2.5/text-to-video e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1

Prompt testuale che descrive il contenuto video desiderato; supporta cinese, inglese, spagnolo, indonesiano, portoghese, giapponese, malese, thai, arabo, vietnamita o coreano. Per ottenere i risultati migliori, si consiglia di non superare 500 caratteri per i prompt in cinese e 1000 parole per i prompt in inglese.

durationintegerOpzionalePredefinito: 5min 4max 30

Durata del video di output in secondi, numero intero da 4 a 30, valore predefinito 5 secondi; HiAPI fattura in base alla durata richiesta.

watermarkbooleanOpzionalePredefinito: false

Indica se aggiungere la filigrana di generazione AI nell'angolo inferiore destro del video; valore predefinito false.

resolutionstringOpzionalePredefinito: "720p"

Risoluzione del video di output; Seedance 2.5 supporta 720p e 1080p, valore predefinito 720p.

Opzioni:720p1080p

web_searchbooleanOpzionalePredefinito: false

Indica se consentire al modello di cercare online le informazioni più recenti menzionate nel prompt; valore predefinito false.

aspect_ratiostringOpzionalePredefinito: "adaptive"

Proporzioni del video di output; valore predefinito adaptive, ovvero il modello sceglie automaticamente il rapporto in base al prompt.

Opzioni:16:94:31:13:49:1621:9adaptive

output_formatstringOpzionalePredefinito: "mp4"

Formato file del video di output; valore predefinito mp4 (priorità alla compatibilità), mov adatto alla post-produzione professionale.

Opzioni:mp4mov

generate_audiobooleanOpzionalePredefinito: true

Indica se generare dialoghi, effetti sonori e audio di sottofondo sincronizzati con le immagini; valore predefinito true.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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/text-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/text-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/text-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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}