API pública do Seedance
Documentação das APIs de geração de vídeo e imagem do Seedance.
Acesso Live — Usuários com e-mail verificado podem criar uma Key
sd_live_...em Configurações → Chaves de API. A API compartilha créditos, preços, tarefas e reembolsos com o produto PC. Todas as Keys de autoatendimento permitem escolher o modo de pessoa real por solicitação com controles rígidos.
Pontos de entrada
- Documentação:
https://seedance2video.io/pt/docs/api - Conta:
/settings/public-api - Base URL:
https://api.seedance2video.io/v1 - OpenAPI:
https://api.seedance2video.io/v1/openapi.json
Importe o OpenAPI no Postman, Insomnia, Bruno ou em um gerador de cliente no servidor. A v1 não habilita CORS no navegador; nunca exponha uma Live Key no JavaScript do frontend.
Endpoints da primeira fase
| Recurso | Endpoint |
|---|---|
| Modelos permitidos para a Key | GET /models |
| Criar vídeo | POST /videos |
| Criar imagem | POST /images |
| Consultar geração | GET /generations/{id} |
| Saldo de créditos PC | GET /credits/balance |
| Baixar OpenAPI | GET /openapi.json |
Uploads, Webhooks, cancelamento, lista de uso, Test Keys e carteira API separada não estão disponíveis nesta fase.
Contrato essencial
- Autentique com
Authorization: Bearer sd_live_.... - Toda criação exige um
Idempotency-Keyestável. - A geração é assíncrona; consulte apenas o
status_urlretornado. - URLs concluídas ficam em
output.urls, comoutput.video_urleoutput.image_urlscomo campos específicos. - Entradas devem ser URLs HTTPS públicas de hosts de armazenamento aprovados. Base64,
data:, localhost, IPs e hosts arbitrários são rejeitados. - Nomes e IDs do Provider, respostas brutas e IDs internos nunca são retornados.
Modelos públicos: seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2 e nano-banana-pro. Veo e Lite não são expostos.
Toda Key com permissão de geração pode escolher o modo de pessoa real por solicitação. Ele exige modelo Seedance, modo de imagem ou multimodal, confirmação de direitos e referência de auditoria do cliente. Os controles de segurança permanecem no servidor.
Os campos exatos são parameters.real_person_mode: true, compliance.rights_confirmed: true e uma referência de auditoria não pessoal em compliance.consent_reference.
Comece pelo guia rápido e pela integração n8n.