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

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

FunzioneEndpoint
Modelli consentiti alla KeyGET /models
Crea videoPOST /videos
Crea immaginePOST /images
Stato generazioneGET /generations/{id}
Saldo crediti PCGET /credits/balance
Scarica OpenAPIGET /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-Key stabile.
  • La generazione è asincrona: interroga solo lo status_url restituito.
  • Gli URL finali sono in output.urls, output.video_url e output.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.