Partner ufficiale di BytePlusBytePlus, un'azienda di ByteDance
API per sviluppatori · Partner ufficiale di BytePlus
API di Seedance 2.0 e API di Seedream
Genera video con Seedance 2.0 e immagini con Seedream dal tuo codice. Basato su BytePlus, un'azienda di ByteDance. Una chiave API, token prepagati a 0,05 $ l'uno, upload, webhook firmati e richieste idempotenti.
- Endpoint REST /v1
- 1 token = 0,05 $
- Webhook
- Idempotency-Key
- Seedance 2.0 fino al 4K
Aggiornato il
In questa pagina
Le API di Seedance e Seedream, senza configurazione
Chi cerca una API di Seedance, una API di Seedream o una API di BytePlus di solito vuole la stessa cosa: inviare un prompt e qualche riferimento, ricevere il video o l'immagine finita e pagare solo quello che usa. L'API per sviluppatori di KreatorFlow funziona proprio così. Con i modelli Seedance 2.0 e Seedream di ByteDance tramite BytePlus, un'azienda di ByteDance, con un piccolo insieme di endpoint REST sotto /v1.
I modelli video hanno alias stabili (kreator-video-fast, kreator-video-seedance-2-fast, kreator-video-mini, kreator-video-seedance-2-mini, kreator-video-pro, kreator-video-seedance-2, kreator-video-seedance-2-5, kreator-video-wan-3, kreator-video-wan-3-prime, kreator-video-kling-3, kreator-video-kling-3-omni, kreator-video-kling-3-turbo e kreator-video-kling-4), quelli di immagine kreator-image-fast, kreator-image-pro, kreator-image-wan-2-7-pro, kreator-image-wan-2-6, kreator-image-seedream-5-pro e kreator-image-seedream-5-flash. GET /v1/models restituisce per ogni alias durate, formati, risoluzioni e limiti dei riferimenti, così li leggi invece di scriverli nel codice. Seedance 2.0 crea clip da 4 a 15 secondi in 720p, 1080p e 4K, con fino a 9 immagini, 3 clip e 3 audio di riferimento per job. Seedance 2.5 crea clip fino a 30 secondi in 720p, 1080p e 4K.
Endpoint
POST /v1/videos
Job video Seedance: da testo a video, da immagine a video, primo e ultimo fotogramma, video con riferimenti.
POST /v1/video-edits
Modifica, cambia stile, trasforma o allunga le tue clip, o clip su cui hai i diritti.
POST /v1/images
Genera e modifica immagini Seedream da prompt, immagini di riferimento e personaggi.
POST /v1/uploads
Crea un upload, invia il file con PUT e passa l'ID dell'upload come riferimento. Nessun hosting pubblico necessario.
POST /v1/characters
Registra una volta un personaggio ricorrente e passa il suo ID in character_ids nei job di immagini e video.
GET /v1/jobs/{job_id}
Controlla lo stato e scarica il risultato. Le stesse informazioni arrivano anche via webhook.
Inizia subito con curl
Crea un job Seedance 2.0, poi interroga lo stato o aspetta il webhook.
curl https://kreatorflow.ai/v1/videos \
-H "Authorization: Bearer $KREATORFLOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: launch-teaser-001" \
-d '{
"model": "kreator-video-seedance-2",
"prompt": "slow dolly in on a glass perfume bottle, soft studio light",
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p",
"webhook_url": "https://example.com/hooks/kreatorflow"
}'
curl https://kreatorflow.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $KREATORFLOW_API_KEY"Crea una chiave nella console API, esportala come KREATORFLOW_API_KEY e tienila solo sul server. Il riferimento completo, con esempi in Node e Python, è nella documentazione per sviluppatori (in inglese).
Prezzi in token
Un token costa 0,05 $. Il prezzo viene calcolato prima che il job venga accettato e scalato dal saldo prepagato.
Immagine Seedream 5.0 Lite
1
token · 0,05 $ · kreator-image-fast
Immagine Seedream 4.5
2
token · 0,10 $ · kreator-image-pro
Seedance 2.0 Mini, 720p, 5 s
7
token · 0,35 $ · kreator-video-mini
Immagine Seedream 5.0 Flash
1
token · 0,05 $ · kreator-image-seedream-5-flash
Immagine Seedream 5.0 Pro
2
token · 0,10 $ · kreator-image-seedream-5-pro
Seedance 2 Fast, 720p, 5 s
9
token · 0,45 $ · kreator-video-fast
Seedance 2.0, 720p, 5 s
11
token · 0,55 $ · kreator-video-pro
Seedance 2.0, 1080p, 5 s
24
token · 1,20 $ · kreator-video-pro
Seedance 2.0, 4K, 5 s
58
token · 2,90 $ · kreator-video-pro
Seedance 2.5, 720p, 5 s
21
token · 1,05 $ · kreator-video-seedance-2-5
Seedance 2.5, 1080p, 30 s
267
token · 13,35 $ · kreator-video-seedance-2-5
Ricarichi con la carta dalla console, da 20 $ a 5.000 $ alla volta. I token dell'API si pagano in dollari USA. Nessun canone e nessun abbonamento, e i token riservati per un job non riuscito tornano sul saldo. Il prezzo per clip rispetto alle altre API di Seedance è nel confronto delle API di Seedance.
Cosa gestisce l'API di KreatorFlow al posto tuo
- Seedance 2.5, Seedance 2.0, Seedance 2 Fast, Seedance 2.0 Mini e Seedream con una sola chiave KreatorFlow, con permessi separabili.
- Token prepagati senza abbonamento, con ricarica tramite carta.
- ID di upload limitati al tuo workspace, quindi i riferimenti non hanno bisogno di URL pubblici.
- Le immagini di riferimento vengono preparate in una libreria di risorse affidabile prima dell'invio.
- Webhook firmati per job.completed, job.failed, job.canceled e job.blocked.
- Supporto a Idempotency-Key: se rimandi la stessa richiesta ottieni il job originale invece di un duplicato.
- Nuovo tentativo automatico per gli invii di immagini bloccati e rilascio dei token riservati se il job non riesce.
- Personaggi ricorrenti e modifica dei video di partenza con endpoint semplici.
Inizia in tre passi
- 1
Crea l'account e la chiave
Accedi alla console API su developers.kreatorflow.ai e crea una chiave API.
- 2
Ricarica i token
Nella scheda Billing ricarica almeno 20 $. Il saldo è condiviso da tutte le chiavi dell'account.
- 3
Invia il primo job
Chiama POST /v1/videos o POST /v1/images con una Idempotency-Key, poi interroga lo stato o ricevi il webhook.
Regole d'uso
L'API segue la stessa politica di uso accettabile (in inglese) dello studio. I riferimenti devono essere tuoi o materiale su cui hai i diritti. Se preferisci creare senza codice, gli stessi modelli sono nel generatore video Seedance 2.0.
Domande frequenti sull'API di Seedance
È l'API ufficiale di Seedance?
È l'API di KreatorFlow, costruita su BytePlus, un'azienda di ByteDance. KreatorFlow è un partner ufficiale di BytePlus, un'azienda di ByteDance: le richieste passano da BytePlus fino a Seedance 2.0 e Seedream, con alias di modello stabili e una sola chiave KreatorFlow.
Quanto costa l'API di Seedance 2.0?
Paghi con token prepagati e un token costa 0,05 $. Una clip Seedance 2.0 di 5 secondi in 720p costa 11 token, la stessa durata con Seedance 2 Fast 9 token, con Seedance 2.0 Mini 7 token e un'immagine Seedream 4.5 2 token. Puoi ricaricare da 20 $ a 5.000 $.
In che valuta si paga l'API?
In dollari USA. I token dell'API si acquistano e si scalano sempre in dollari; la tua banca può mostrare l'importo convertito nella tua valuta.
Posso usare immagini di riferimento con l'API di Seedream?
Sì. Carica l'immagine con POST /v1/uploads e passa l'ID dell'upload come riferimento, oppure invia un URL HTTPS pubblico. kreator-image-pro (Seedream 4.5) accetta fino a 14 immagini di riferimento, e un personaggio che usi spesso si registra una volta sola con POST /v1/characters.
Ricevo webhook o devo interrogare lo stato?
Tutte e due le cose. Aggiungi webhook_url alla richiesta per ricevere gli eventi job.completed, job.failed, job.canceled e job.blocked, ognuno firmato con X-KreatorFlow-Signature tramite il segreto della scheda Webhooks. Oppure interroga GET /v1/jobs/{job_id}.
Cosa succede se un job non riesce?
I token vengono riservati all'avvio del job e rilasciati se il job non riesce, va in timeout o viene rifiutato prima dell'invio: non paghi i job non riusciti. Se rimandi una richiesta con la stessa Idempotency-Key ottieni il job originale invece di un duplicato, quindi i nuovi tentativi di rete sono sicuri. Per un nuovo tentativo vero e proprio usa una chiave nuova.
Crea con l'API di Seedance 2.0
Crea una chiave, ricarica i token e in pochi minuti puoi inviare il tuo primo job Seedance o Seedream.