Documentação Seedance 2.0 API

Guia completo para integrar a API de geração de vídeo Seedance 2.0 em suas aplicações.

API v1.0 Base URL: https://seedanceapi.org/v1

Início Rápido

bash

curl -X POST 'https://seedanceapi.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8"
  }'

Autenticação

Todas as requisições da API requerem autenticação usando um token Bearer no cabeçalho Authorization.

Importante: Você pode obter sua chave API na página API Keys no seu painel. → Obter chave API

http

Authorization: Bearer YOUR_API_KEY

Preços

480p

480p Resolução

Geração rápida, adequada para pré-visualizações e rascunhos

Duração	Sem áudio	Com áudio
4s	8 credits ($0.04)	14 credits ($0.07)
8s	14 credits ($0.07)	28 credits ($0.14)
12s	19 credits ($0.095)	38 credits ($0.19)

720p

720p Resolução

Saída de alta qualidade, recomendada para produção

Duração	Sem áudio	Com áudio
4s	14 credits ($0.07)	28 credits ($0.14)
8s	28 credits ($0.14)	56 credits ($0.28)
12s	42 credits ($0.21)	84 credits ($0.42)

Endpoints da API

POST/v1/generateGerar novo vídeo

Criar nova tarefa de geração de vídeo com o modelo Seedance 2.0. Suporta texto-para-vídeo e imagem-para-vídeo.

Corpo da Requisição

Parameter	Tipo	Obrigatório	Descrição
`prompt`	string	Obrigatório	Descrição textual do vídeo a gerar (máx. 2000 caracteres)
`aspect_ratio`	string	Opcional	Proporção da tela de saída. Suportadas: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (Padrão: 1:1)
`resolution`	string	Opcional	Resolução do vídeo: "480p" ou "720p" (Padrão: 720p)
`duration`	string	Opcional	Duração do vídeo em segundos: "4", "8" ou "12" (Padrão: 8)
`generate_audio`	boolean	Opcional	Ativar geração de áudio IA para o vídeo (Padrão: false)
`fixed_lens`	boolean	Opcional	Fixar a câmera para reduzir desfoque de movimento (Padrão: false)
`image_urls`	string[]	Opcional	Array de URLs de imagens de referência para imagem-para-vídeo (máx. 1)
`callback_url`	string	Opcional	URL webhook para notificações de status assíncronas. Deve ser acessível publicamente.

Texto para vídeo

json

{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

Imagem para vídeo

json

{
  "prompt": "The character slowly turns and smiles at the camera",
  "image_urls": [
    "https://example.com/my-image.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "4"
}

Com geração de áudio

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

Respostas

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

GET/v1/statusObter status da tarefa

Verificar o status de uma tarefa de geração de vídeo e obter o resultado quando concluída.

Parâmetros de Consulta

Parameter	Tipo	Obrigatório	Descrição
`task_id`	string	Obrigatório	O ID único da tarefa retornado do endpoint generate

Exemplo de Requisição

bash

curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: O campo response na API de status é um array de URLs de vídeo. Acesse diretamente data.response[0] para obter a URL do vídeo.

javascript

// Extract video URL from response
const videoUrl = data.response[0];

Respostas

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

Playground da API

Teste a API diretamente do seu navegador. Substitua YOUR_API_KEY pela sua chave API real.

Playground da APIPOST

URL Base

Endpoint

Cabeçalhos

Corpo da Requisição

Códigos de Erro

Status	Code	Description
400 Requisição Inválida	`INVALID_PROMPT`	O prompt é inválido ou vazio
400 Requisição Inválida	`INVALID_ASPECT_RATIO`	Proporção de tela não suportada
400 Requisição Inválida	`INVALID_RESOLUTION`	Resolução deve ser 480p ou 720p
400 Requisição Inválida	`INVALID_DURATION`	Duração deve ser 4, 8 ou 12 segundos
400 Requisição Inválida	`TOO_MANY_IMAGES`	Máximo 1 URL de imagem permitida no array image_urls
401 Não autorizado	`INVALID_API_KEY`	Chave API ausente ou inválida
402	`INSUFFICIENT_CREDITS`	Créditos insuficientes para esta operação
404 Não encontrado	`TASK_NOT_FOUND`	ID da tarefa não encontrado ou não pertence à sua conta
500 Erro Interno do Servidor	`INTERNAL_ERROR`	Erro do servidor, por favor tente novamente mais tarde