API pubblica Seedance
Documentazione delle API Seedance per la generazione di video e immagini.
Accesso Live — Gli utenti con e-mail verificata possono creare una Key
sd_live_...in Impostazioni → Chiavi API. L’API condivide crediti, prezzi, attività e rimborsi con il prodotto PC. Tutte le Key self-service permettono di scegliere la modalità persona reale per richiesta con rigorosi controlli.
Punti di accesso
- Documentazione:
https://seedance2video.io/it/docs/api - Account:
/settings/public-api - Base URL:
https://api.seedance2video.io/v1 - OpenAPI:
https://api.seedance2video.io/v1/openapi.json
Importa OpenAPI in Postman, Insomnia, Bruno o in un generatore server. v1 non abilita CORS nel browser: non esporre mai una Live Key nel JavaScript frontend.
Endpoint della prima fase
| Funzione | Endpoint |
|---|---|
| Modelli consentiti alla Key | GET /models |
| Crea video | POST /videos |
| Crea immagine | POST /images |
| Stato generazione | GET /generations/{id} |
| Saldo crediti PC | GET /credits/balance |
| Scarica OpenAPI | GET /openapi.json |
Upload, Webhook, annullamento, elenco utilizzi, Test Key e portafoglio API separato non sono disponibili nella prima fase.
Contratto essenziale
- Autenticazione:
Authorization: Bearer sd_live_.... - Ogni creazione richiede un
Idempotency-Keystabile. - La generazione è asincrona: interroga solo lo
status_urlrestituito. - Gli URL finali sono in
output.urls,output.video_urleoutput.image_urls. - Gli input devono essere URL HTTPS pubblici di host approvati. Base64,
data:, localhost, IP e host arbitrari vengono rifiutati. - Nomi e ID del Provider, risposte grezze e ID interni non vengono restituiti.
Modelli: seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2, nano-banana-pro. Veo e Lite non sono esposti.
Ogni Key abilitata alla generazione può scegliere la modalità persona reale per richiesta. Richiede un modello Seedance, modalità immagine o multimodale, conferma dei diritti e riferimento di audit del cliente. I controlli di sicurezza restano sul server.
I campi esatti sono parameters.real_person_mode: true, compliance.rights_confirmed: true e un riferimento di audit non personale in compliance.consent_reference.
Inizia con la guida rapida e l'integrazione n8n.