Seedance 2.5 API: come aggiungere la generazione video al tuo progetto

Seedance 2.5 è disponibile su NeuralSpace tramite l'interfaccia web e gli sviluppatori ottengono anche un'API pubblica per la generazione di video. Ti consente di incorporare la creazione di clip nel tuo servizio: invia una richiesta, ricevi un'attività e recupera il file finito tramite URL.

Come funziona l'API

La generazione del video richiede pochi minuti, quindi l'API è asincrona. Per prima cosa invii una richiesta POST per creare un'attività: il servizio addebita immediatamente i token e restituisce un identificatore. Quindi esegui il polling sullo stato dell'attività e quando la clip è pronta ottieni un collegamento al file. In caso di errore o timeout, i token vengono rimborsati.

Endpoint

Crea un'attività con POST /v1/videos/generations e un corpo di { model, prompt, duration, resolution, aspect_ratio, image_urls }. Lo stato e il risultato provengono da GET /v1/videos/generations/:id. L'autorizzazione utilizza una chiave API nell'intestazione della richiesta.

Quali modelli video sono disponibili

L'API espone Seedance 2.0, Sora 2, Veo 3.1, Kling 3.0, Grok Imagine e Wan 2.6, ciascuno con le proprie opzioni di durata, risoluzione e formato. Seedance 2.5 è attualmente disponibile tramite l'interfaccia web sul sitopagina del modello, dove è possibile impostare riferimenti, audio e risoluzione fino a 1080p.

Una richiesta di esempio

Una richiesta minima è simile a questa: POST /v1/videos/generations con il corpo {"model": "seedance-2.0", "prompt": "close-up of a product on a dark table, camera slowly orbits", "duration": 5, "resolution": "720p"}. La risposta restituisce un'attività id di cui esegui il polling finché lo stato non diventa completed.

Domande frequenti

Seedance 2.5 è disponibile tramite l'API?

Seedance 2.5 attualmente viene eseguito tramite l'interfaccia web, mentre l'API pubblica espone Seedance 2.0. L'elenco dei modelli attuali è nella documentazione API.

Come posso ottenere una chiave API?

La chiave viene emessa nella dashboard di NeuralSpace nella sezione API.

Quanto costa la generazione dell'API?

La stessa fatturazione al secondo del sito: il prezzo dipende dal modello, dalla durata e dalla risoluzione.