Seedance 2.5 Flash

Genera video di 4–30 secondi a 480p o 720p da testo, fotogrammi iniziali/finali o riferimenti multimodali, oppure modifica un video sorgente.

Seedance 2.5 Flash supporta la generazione da testo a video, da fotogrammi iniziali/finali, da riferimenti e la modifica di video. Usa dreamina-seedance-2-5-flash con il livello Default. Invia i contenuti multimediali tramite URL HTTP o HTTPS pubblici senza credenziali. Salva l’ID attività restituito e interrogalo per ottenere il video completato.

Consulta il playground e i prezzi aggiornati, la specifica OpenAPI e la guida ai prezzi.

Esempio rapido

Questa richiesta crea un video di quattro secondi. Controlla il prezzo attuale prima di inviarla; l’invio di una generazione completata con successo comporta un addebito.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

Parametri

model e content sono obbligatori. Tutti gli altri campi sono facoltativi. I valori null espliciti e i campi sconosciuti vengono rifiutati.

Campo	Tipo	Valore predefinito	Vincoli
`model`	stringa	obbligatorio	`dreamina-seedance-2-5-flash`
`content`	array	obbligatorio	Almeno un elemento di testo non vuoto; gli elementi multimediali richiedono un ruolo.
`resolution`	stringa	`720p`	`480p` o `720p`.
`duration`	intero	`5`, o `-1` per la modifica	Generazione: 4–30 secondi. Modifica: ometti o usa `-1`; l’output segue la sorgente.
`ratio`	stringa	`16:9`, o `adaptive` per fotogrammi/modifica	Generazione da testo/riferimenti: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`. Fotogrammi iniziali/finali e modifica: solo `adaptive`.
`generate_audio`	booleano	`true`	Abilita o disabilita l’audio generato; non cambia la tariffa.
`omni_reference_task_type`	stringa	`generate`	`generate` o `edit`. La modifica richiede esattamente un video.
`content_filter`	booleano	`true`	È accettato solo `true`; non serve alcun controllo nel playground.

La documentazione indica un massimo di 10.000 token per i prompt. Non è specificato alcun tokenizer pubblico, quindi il conteggio dei caratteri non deve essere considerato un conteggio esatto dei token.

Contenuti e modalità

Il testo usa {"type":"text","text":"Describe the shot"}. Immagini, video e audio usano un URL annidato e un ruolo esplicito:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

Modalità	Contenuto	Inquadratura e durata
Da testo a video	Solo testo	Rapporto fisso; 4–30 secondi.
Fotogrammi iniziali/finali	Testo più un’immagine `first_frame`, facoltativamente un’immagine `last_frame`	`adaptive`; 4–30 secondi. Il fotogramma finale richiede quello iniziale.
Generazione da riferimenti	Testo più elementi `reference_image`, `reference_video` o `reference_audio`	Rapporto fisso; 4–30 secondi. Fino a 10 immagini, 5 video e 5 audio.
Modifica video	Testo, esattamente un `reference_video`, immagini/audio di riferimento facoltativi; tipo di attività `edit`	`adaptive`; durata omessa o `-1`.

Gli elementi video usano type: "video_url", video_url: {"url": "..."}, role: "reference_video"; gli elementi audio usano audio_url e reference_audio con la stessa struttura. I fotogrammi iniziali/finali non possono essere combinati con contenuti multimediali di riferimento. I controlli Draft, Extend, 1080p, filigrana, seed e output del fotogramma finale non sono disponibili per questa integrazione. Non sono previsti callback.

Vincoli dei contenuti multimediali

Contenuto multimediale	Formati	Dimensioni e durata
Immagine	JPEG, PNG, WebP	Fino a 30 MB; ciascun lato 300–6.000 px; rapporto larghezza/altezza 0,4–2,5.
Video	MP4, MOV	Fino a 200 MB; 24–60 FPS; ciascun lato 300–6.000 px; rapporto 0,4–2,5; 409.600–8.295.044 pixel. Riferimenti: 2–30 secondi ciascuno, al massimo 30 secondi complessivi. Sorgente da modificare: 4–30 secondi.
Audio	WAV, MP3	Fino a 15 MB; 2–30 secondi ciascuno, al massimo 30 secondi complessivi.

I file devono essere leggibili prima dell’invio. La durata del video viene misurata dal contenuto multimediale per calcolare l’addebito. Usa URL pubblici stabili.

Risposta dell’attività e polling

La creazione restituisce id, model, status e created_at. Interroga la stessa attività fino al completamento:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Lo stato è processing, completed o failed. In caso di successo, leggi output.video_url per il video archiviato. In caso di errore, leggi error.code ed error.message. Le risposte pubbliche non includono i costi. Un timeout del polling non dimostra che la generazione sia fallita: conserva l’ID attività e interrogala di nuovo anziché inviare un’altra generazione.

Fatturazione

La tariffa aggiornata dipende dalla risoluzione e dalla presenza di un video fornito in input. Senza video in input, i secondi fatturati equivalgono alla durata dell’output. Con video di riferimento, i secondi fatturati equivalgono alla durata dell’output più il valore maggiore tra la durata dell’output e la durata complessiva dell’input arrotondata per eccesso. La modifica fattura il doppio della durata della sorgente arrotondata per eccesso. L’audio è incluso. Le richieste non riuscite non vengono addebitate.

Ad esempio, un output di cinque secondi con tre secondi di video di riferimento comporta dieci secondi fatturati. La modifica di una sorgente di dieci secondi comporta venti secondi fatturati. Moltiplica i secondi fatturati per la tariffa aggiornata applicabile.

Consulta il ciclo di vita delle attività e i codici di errore per le risposte comuni e le indicazioni sui nuovi tentativi.