Vai alla documentazione
In questa pagina

Seedance 2.5 Flash

Genera video con Seedance 2.5 Flash partendo da testo, dal primo e dall'ultimo fotogramma o usando riferimenti multimodali. Questa pagina descrive l'intero flusso di lavoro, dalla richiesta al risultato finale.

ID del modello API: seedance-2-5-flash

La generazione è asincrona. Salva il taskId restituito alla creazione del task, quindi interroga lo stato o ricevi un webhook.

Funzionalità

Seedance 2.5 Flash supporta 480p e 720p, con 720p come valore predefinito. Non supporta il 1080p, il 4k, le anteprime Draft o la finalizzazione di Draft.
FunzionalitàValori supportati
Risoluzione video480p · 720p
Durata video4–30 secondi
Proporzioni16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Immagini di riferimentoFino a 30 immagini
Video di riferimentoFino a 10 video
File audio di riferimentoFino a 10 file audio
Tutti i riferimenti combinatiFino a 50 file di riferimento in totale
Durata totale per gruppo video/audio30 secondi
seed-1 a 2147483647
Accetta anche duration=-1 nella modalità da riferimento a video; vedi la sezione dedicata alla modifica video e ai prezzi qui sotto. image-to-video supporta solo adaptive; ometti questo campo o impostalo su adaptive.

Prezzi e crediti

La generazione di video viene tariffata in crediti in base alla durata fatturabile in secondi. Senza un video di input, la durata fatturabile corrisponde alla durata del video generato; in presenza di un video di input, include anche la durata del video di riferimento.

La tabella seguente mostra i crediti addebitati al secondo e non il costo totale di un'operazione. La tariffa varia a seconda del modello, della risoluzione finale e dell'eventuale inserimento di video di riferimento nella modalità reference-to-video. Per il calcolo del costo totale, consulta le formule e gli esempi riportati sotto la tabella.

Risoluzione videoSenza video in inputCon video in input
480p7 crediti al secondo5 crediti al secondo
720p10 crediti al secondo7 crediti al secondo
  • Senza video in input: secondi generati × tariffa senza video.
  • Con video in input: (secondi generati + secondi effettivi del video di riferimento) × tariffa con video. Il server calcola la durata totale del video di riferimento arrotondandola al secondo superiore prima dell'addebito.
  • I soli riferimenti di immagini o audio utilizzano la tariffa senza video. La tariffa con video si applica esclusivamente nella modalità da riferimento a video quando vengono forniti video come input.

Esempi di calcolo dei costi

Video da testo a video da 5 secondi a 720p: 5 × 10 = 50 crediti.

Video generato da 5 secondi a 720p con video di riferimento da 5 secondi: (5 + 5) × 7 = 70 crediti.

Questi crediti vengono detratti in anticipo al momento della creazione del task. Se il task va a buon fine, questo importo costituisce l'addebito finale, che non subirà aumenti o rimborsi parziali in base alla durata effettiva dell'output. In caso di task falliti o scaduti, si avvierà la procedura di rimborso.

I crediti vengono prenotati all'invio e addebitati solo a completamento avvenuto. I task falliti o andati in timeout avviano la procedura di rimborso. Lo stato di fatturazione refund_failed indica che il rimborso non è andato a buon fine; verifica i log delle API o contatta l'assistenza.

Come vengono addebitati i crediti quando duration=-1

Quando la durata è impostata su -1, la durata finale dell'output non è fissa, ma viene stabilita dal modello.

Nella maggior parte dei casi, è consigliabile impostare la durata sull'effettiva lunghezza del video desiderata anziché su -1. Raccomandiamo di utilizzare il valore -1 solo per l'editing video e non per altri scenari di generazione video.

Input di riferimentoCome viene calcolato l'addebitoEsempio
Con video di riferimentoSomma la durata di tutti i video di riferimento e arrotonda il totale al secondo intero successivo, definendolo T. L'addebito è pari a (T + T) × la tariffa con video: un T rappresenta la durata stimata del file di output e l'altro rappresenta la durata del video di input.720p con un video di riferimento di 5 secondi: (5 + 5) × 7 = 70 crediti.
Senza video di riferimento (solo immagini o audio)Vengono utilizzati 30 secondi come durata stimata dell'output. L'addebito è pari a 30 × la tariffa senza video.720p senza video di riferimento: 30 × 10 = 300 crediti.

Autenticazione

Crea una chiave API nella dashboard. La chiave completa viene mostrata una sola volta. Conservala sul tuo server e inviala come token Bearer in ogni richiesta.

URL di base

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Imposta la variabile d'ambiente SEEVIO_API_KEY prima di eseguire questi esempi. Gli esempi in JavaScript vengono eseguiti sul server con Node.js; gli esempi in Python utilizzano la libreria requests.

Avvio rapido

Invia questa richiesta minima, salva il taskId restituito e usa l'esempio di query del task riportato di seguito. Il valore dei crediti nella risposta di creazione corrisponde all'importo prenotato.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Esempio di risposta alla creazione del task

Una volta accettata la richiesta precedente, l'API restituisce questa risposta JSON. taskId è l'identificativo del task da utilizzare per le successive verifiche sullo stato; credits indica il numero di crediti riservati a questo task. Questa risposta conferma la corretta creazione del task, non che il video sia pronto. Sarà necessario monitorare periodicamente lo stato del task o utilizzare un Webhook per ricevere il video finale.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Crea un task

POST https://api.seevio.ai/v1/videos/generations

Invia un oggetto JSON contenente model e input, oltre a un callback_url opzionale. Specifica sempre l'ID del modello mostrato in questa pagina; se omesso, verrà selezionato automaticamente seedance-2-0.

Corpo della richiesta

CampoTipoObbligatorioDescrizione e vincoli
model
stringSì

ID modello. Per utilizzare Seedance 2.5 Flash, imposta questo campo su seedance-2-5-flash.

callback_url
stringNo

Endpoint HTTPS pubblico per le chiamate POST di callback in caso di completamento o errore. Non sono consentiti host locali o reti private.

Esempio: https://example.com/webhooks/seevio
input
objectSì

Impostazioni di generazione. Deve contenere un prompt non vuoto.

Parametri di input

image_urls è obbligatorio in image-to-video. reference-to-video richiede almeno un riferimento a scelta tra image_urls, video_urls e audio_urls.

Fornisci image_urls, video_urls e audio_urls sotto forma di array di stringhe URL (string[]). Ogni URL fornito deve essere accessibile pubblicamente tramite HTTPS, inclusi i contenuti multimediali ignorati dalla modalità selezionata.

CampoTipoObbligatorioPredefinitoDescrizione e vincoli
input.prompt
stringSì—

È necessario inserire un prompt in qualsiasi modalità. Può contenere al massimo 10.000 caratteri (spazi esclusi) e non può essere composto unicamente da spazi vuoti.

Esempio: A cat surfing at sunset
input.generation_type
stringNotext-to-video
Valori supportati
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video o reference-to-video. Se omesso, l'impostazione predefinita è text-to-video e viene utilizzato solo il prompt. image-to-video utilizza 1 o 2 immagini fotogramma ordinate. reference-to-video utilizza immagini, video e/o audio; i riferimenti solo audio sono supportati con un prompt obbligatorio.

input.image_urls
string[]Condizionale[]

Fornisci gli URL delle immagini per definire l'aspetto visivo. In image-to-video, fornisci 1 immagine per il primo fotogramma o 2 nell'ordine primo-ultimo fotogramma. In reference-to-video, fornisci al massimo 30 immagini. Ciascuna immagine deve essere inferiore a 30 MB; consulta i requisiti dei file multimediali riportati di seguito per formati e dimensioni. Tutti i tipi di riferimento combinati consentono al massimo 50 file. Se omesso, il valore predefinito è []; ignorato in text-to-video.

Esempio: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]Condizionale[]

Fornisci gli URL dei video di riferimento per guidare il movimento o modificare/estendere un video, solo in modalità reference-to-video. Massimo 10 file, ciascuno fino a 100 MB e con una durata di 2-30 secondi; la loro durata complessiva non deve superare 30 secondi. Tutti i tipi di riferimento combinati consentono al massimo 50 file. Il server misura la durata del video ai fini della fatturazione. Se omesso, il valore predefinito è []; ignorato nelle altre modalità.

Esempio: ["https://example.com/source.mp4"]
input.audio_urls
string[]Condizionale[]

Fornisci gli URL dei file audio di riferimento per guidare il suono, solo in modalità reference-to-video. Massimo 10 file MP3/WAV, ciascuno fino a 15 MB e con una durata di 2-30 secondi; la loro durata complessiva non deve superare 30 secondi. Tutti i tipi di riferimento combinati consentono al massimo 50 file. L'audio può essere l'unico tipo di riferimento; il prompt rimane obbligatorio. Se omesso, il valore predefinito è []; ignorato nelle altre modalità.

Esempio: ["https://example.com/music.mp3"]
input.duration
integerNo5
Valori supportati
-1 | 4–30

Durata intera del video generato da 4 a 30 secondi. Accetta anche -1 solo in reference-to-video. Utilizzalo con un video sorgente per la modifica; la fatturazione segue la regola speciale descritta sopra.

Esempio: 5
input.aspect_ratio
stringNoadaptive
Valori supportati
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive. Se omesso, l'impostazione predefinita è adaptive, che consente al modello di determinare le proporzioni di output. Per la modifica o l'estensione di video, usa adaptive. image-to-video supporta solo adaptive; ometti questo campo o impostalo su adaptive.

Esempio: adaptive
input.resolution
stringNo720p
Valori supportati
480p | 720p

480p o 720p. Se omesso, il valore predefinito è 720p in ogni modalità di generazione supportata. Risoluzioni superiori verranno rifiutate.

Esempio: 720p
input.generate_audio
booleanNotrue
Valori supportati
true | false

Il valore true richiede la generazione di audio sincronizzato; false disattiva la generazione dell'audio. Se omesso, il valore predefinito è true. Si applica a tutte le modalità di generazione supportate.

Esempio: true
input.watermark
booleanNofalse
Valori supportati
true | false

Il valore true richiede una filigrana IA sull'output; false richiede un output privo di filigrana. Se omesso, il valore predefinito è false. Si applica a tutte le modalità di generazione supportate.

Esempio: false
input.web_search
booleanNofalse
Valori supportati
true | false

Il valore true consente la ricerca sul Web se disponibile per il modello; false la disabilita. Se omesso, il valore predefinito è false. L'abilitazione non garantisce che venga effettivamente eseguita una ricerca.

Esempio: false
input.return_last_frame
booleanNofalse
Valori supportati
true | false

Il valore true richiede il fotogramma finale del video generato; false non lo richiede. Se omesso, il valore predefinito è false. Si applica a tutte le modalità di generazione supportate. Se richiesto e disponibile, l'URL viene restituito come data.last_frame_url; altrimenti è null.

Esempio: true
input.seed
integerNo—
Valori supportati
-1 a 2147483647

Valore intero compreso tra -1 e 2147483647. Il valore -1 seleziona un seed casuale.

Esempio: 42
input.output_format
stringNomp4
Valori supportati
mp4 | mov

mp4 o mov. Se omesso, il valore predefinito è mp4. Seleziona il formato del contenitore di output in tutte le modalità di generazione supportate.

I campi booleani devono essere impostati su true o false in formato JSON, non come stringhe o numeri.

Risposta di creazione

La risposta HTTP 200 restituisce taskId (stringa) e credits (numero). Questo conferma la creazione del task, non il suo completamento. L'importo indicato sotto corrisponde all'avvio rapido a 720p di 5 secondi.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Modalità di generazione ed esempi

Sostituisci gli URL di esempio con i tuoi file HTTPS accessibili pubblicamente. Gli URL di esempio servono solo a illustrare la struttura della richiesta e non sono risorse scaricabili.

Da testo a video

Genera a partire da un prompt testuale. Gli URL dei file multimediali non vengono considerati in questa modalità.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Primo fotogramma

Fornisci un'immagine come primo fotogramma e descrivi il movimento nel prompt.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Primo e ultimo fotogramma

Fornisci due URL di immagini in ordine: primo fotogramma, poi ultimo fotogramma. Questo esempio richiede anche il fotogramma finale del video generato.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Riferimento multimodale

Combina riferimenti immagine, video e audio. Il prompt rimane obbligatorio. L'inserimento di un video di riferimento modifica la formula di fatturazione.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Riferimento audio

Usa un file audio come unico riferimento, accompagnato da un prompt testuale obbligatorio che descrive il video desiderato.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Modifica video

Per il montaggio video con Seedance 2.5 Flash, è necessario impostare la durata su -1 e l'aspetto (aspect_ratio) su adaptive. Entrambe le impostazioni sono obbligatorie, altrimenti la generazione non andrà a buon fine.

Descrivi le modifiche e fornisci il video sorgente. Imposta duration=-1 e usa proporzioni adaptive. Per questo flusso di lavoro, usa una clip sorgente di almeno 4 secondi. La regola di fatturazione per duration=-1 è indicata sopra.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Estensione video

Per l'estensione video Seedance 2.5 Flash, il parametro aspect_ratio deve essere impostato su adaptive; in caso contrario, la generazione potrebbe non riuscire. Imposta normalmente la durata sul valore desiderato per il video finale entro l'intervallo supportato; non è necessario utilizzare -1.

Descrivi come deve proseguire il video sorgente. Usa proporzioni adaptive e imposta una durata standard entro i limiti del modello.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Interroga un task

GET https://api.seevio.ai/v1/tasks/{taskId}

Sostituisci l'ID di esempio con il taskId restituito alla creazione. Le query restituiscono solo i task associati all'utente della chiave API; ID non accessibili o inesistenti restituiscono HTTP 404.

Come punto di partenza, effettua un polling ogni 10–20 secondi, rallenta le richieste in caso di HTTP 429 e interrompi quando lo stato diventa completed o failed. Per gli ambienti di produzione, consigliamo l'uso dei webhook. Ogni esempio di codice seguente esegue una singola query.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
StatoDescrizione e vincoli
queuedAccettato e in attesa di elaborazione.
generatingGenerazione in corso.
completedCompletato con successo. Scarica il file da data.results prima della scadenza.
failedErrore definitivo. Verifica failed_reason e billing_status.
CampoTipoDescrizione e vincoli
idstring
Identificatore del task. Corrisponde al taskId della risposta di creazione.
created_atnumber
Data e ora di creazione del task in formato Unix timestamp (secondi).
modelstring
L'ID pubblico del modello utilizzato per questo task.
billing_statusstring
Stato di fatturazione: reserved, charged, refunded o refund_failed.
creditsnumber
Crediti prenotati per questo task. Questo valore viene conservato anche dopo un rimborso; verifica billing_status per determinare l'esito finanziario.
failed_reasonstring | null
Causa del problema per i task falliti; null in caso contrario. Le query fallite omettono la sezione data.
dataobject
Presente nelle query dei task non falliti. Contiene i dettagli di output ed elaborazione.
data.resultsstring[]
Array di URL dei video. Vuoto fino al completamento o dopo la scadenza del video.
data.video_expires_atstring | null
Scadenza del video in formato ISO 8601, oppure null prima che sia disponibile. Salva il file prima di questa data.
data.last_frame_urlstring | null
URL dell'ultimo fotogramma quando richiesto e disponibile, altrimenti null.
data.processing_timenumber | null
Durata di elaborazione del task in secondi, se disponibile; altrimenti null.

Task completato: risposta alla query con i risultati video

Quando la query restituisce status=completed, la generazione del video è terminata. Puoi trovare gli URL del video in data.results; assicurati di scaricarli prima della data indicata in data.video_expires_at. Lo stato billing_status=charged indica che i crediti prenotati sono stati effettivamente addebitati.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Task fallito: risposta alla query con dettagli sul fallimento e sulla fatturazione

Se la query restituisce status=failed, significa che la generazione non è andata a buon fine. Consulta failed_reason per conoscerne il motivo e billing_status per l'esito del rimborso. In questo esempio, lo stato refunded indica che i crediti sono stati riaccreditati. La voce credits mostra la quota inizialmente prenotata e la risposta non include la chiave data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

Webhook

Imposta callback_url nella richiesta di creazione per ricevere una richiesta POST JSON al completamento o al fallimento del task. Restituisci una risposta 2xx entro 15 secondi. Gli invii non riusciti verranno riprovati; gestisci le notifiche duplicate in modo idempotente tramite l'ID del task.

L'endpoint di callback deve accettare richieste POST con un corpo in formato JSON (Content-Type: application/json).

Crea un task con callback

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Attività completata: payload di callback riuscito

In caso di generazione riuscita, la callback conterrà lo stato status=completed. Utilizza id per identificare l'attività e data.results per recuperare gli URL dei video. Assicurati di scaricare e salvare i risultati prima della scadenza indicata in data.video_expires_at.

created_at indica la creazione dell’evento; task_created_at quella del task, in secondi Unix. Gli esempi mostrano i campi consigliati; le risposte possono contenere campi aggiuntivi.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Attività non riuscita: payload di callback fallito

In caso di errore durante la generazione, la callback conterrà lo stato status=failed. Utilizza id per identificare l'attività, failed_reason per conoscere il motivo del fallimento e credits_refunded per verificare il numero di crediti riaccreditati.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

Esempio di ricevitore

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Questo esempio in Next.js legge il corpo JSON della callback e gestisce direttamente le attività completate e fallite. Ti consigliamo di aggiungere logiche di persistenza e deduplicazione dei task-ID per la tua applicazione, e di accodare i processi più lenti prima di confermare la callback.

Requisiti e limitazioni dei media

  • Tutti i media e gli URL di callback devono essere URL HTTPS pubblici. Evita l'uso di localhost, IP privati o file che richiedono cookie o autenticazione. Gli URL dei file video/audio di riferimento devono indirizzare a file multimediali leggibili direttamente.
  • In reference-to-video, fornisci almeno un riferimento, con un limite massimo di 30 immagini, 10 video, 10 file audio e 50 elementi multimediali complessivi. La durata totale dei video e quella degli audio non devono superare i 30 secondi ciascuna.
  • La modalità text-to-video ignora tutti i riferimenti multimediali. La modalità image-to-video considera solo le immagini del primo e dell'ultimo fotogramma, ignorando i riferimenti video e audio. Usa la modalità reference-to-video per combinare più formati.
  • Ogni file video o audio di riferimento deve avere una durata compresa tra 2 e 30 secondi. Per gli esempi di modifica video, usa clip sorgente di almeno 4 secondi.

Requisiti delle immagini

  • Ogni immagine deve avere una dimensione inferiore a 30 MB.
  • Formati supportati: jpeg, png, webp, bmp, tiff, gif.
  • Rapporto d'aspetto (larghezza ÷ altezza): compreso tra 0,4 e 2,5.
  • Larghezza e altezza devono essere comprese tra 300 e 6.000 pixel.

Requisiti dei video

  • Formati supportati: mp4, mov.
  • Ogni video non deve superare i 100 MB.
  • Frequenza fotogrammi: compresa tra 24 e 60 fps.
  • Rapporto d'aspetto (larghezza ÷ altezza): compreso tra 0,4 e 2,5.
  • Pixel totali (larghezza × altezza): compresi tra 407.696 e 8.295.044. Ad esempio, 614 × 664 = 407.696 e 3.326 × 2.494 = 8.295.044. Questi sono solo esempi di calcolo dei pixel, non requisiti fissi per larghezza e altezza.

Requisiti dei file audio

  • Formati supportati: wav, mp3.
  • Ogni file audio non deve superare i 15 MB.