Documentação da API

Referência da API Seedance

Documentação completa da API para integrar o Seedance Video AI em seus aplicativos. Gere vídeos de alta qualidade a partir de prompts de texto e imagens.

API REST

Respostas JSON

Geração de Vídeo

Autenticação

A API Seedance usa autenticação Bearer Token. Inclua seu token de API no cabeçalho Authorization:

Authorization: Bearer your-api-token-here

Nota de Segurança: Nunca exponha seu token de API em código do lado do cliente ou repositórios públicos.

URL Base

Todas as requisições de API devem ser feitas para:

https://seedanceapi.org/v1

Endpoints da API

POST

Gerar Vídeo

/generate

Gere vídeos de alta qualidade a partir de prompts de texto e imagens usando modelos de IA.

Corpo da Requisição

Texto para Vídeo (T2V)

{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}

Imagem para Vídeo (I2V)

{
  "prompt": "kissing",
  "mode": "img2img",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1,
  "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}

Parâmetros

Parâmetro	Tipo	Descrição
prompt	string	Descrição textual do vídeo a ser gerado
mode	string	Modo de geração: "text" para T2V ou "img2img" para I2V
image_url	string?	URL da imagem de entrada (obrigatório para o modo img2img)
resolution	string	Resolução do vídeo: "480p", "720p" ou "1080p"
ratio	string	Proporção do vídeo (padrão: "adaptive")
duration	inteiro	Duração do vídeo em segundos (padrão: 5)
framespersecond	inteiro	Quadros por segundo (padrão: 24)
seed	inteiro	Seed aleatória para resultados reproduzíveis (padrão: -1)

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

endpoints.generate.curl

Texto para Vídeo (T2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cardi b bends over to pick up coins",
    "mode": "text",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1
  }'

Imagem para Vídeo (I2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kissing",
    "mode": "img2img",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1,
    "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
  }'

GET

Obter Status da Tarefa

/status?task_id=xxxx

Verifique o status de uma tarefa de geração de vídeo em andamento ou concluída.

Parâmetros

Parâmetro	Tipo	Descrição
task_id	string	ID da tarefa retornado do endpoint de geração

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 10,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "user_request": {
      "prompt": "A beautiful landscape with flowing water",
      "model": "seedance-video-v1",
      "duration": 5
    },
    "user_response": {
      "video_url": "https://cdn.seedance.com/generated/video.mp4",
      "last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
    },
    "provider_status": "success",
    "model": "seedance-video-v1"
  }
}

endpoints.generate.curl

curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Tratamento de Erros

A API Seedance retorna códigos de status HTTP padrão e mensagens de erro:

Códigos de Status HTTP

200OK

400Bad Request

401Unauthorized

429Rate Limited

500Server Error

Formato de Resposta de Erro

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Melhor Prática: Sempre trate erros de forma elegante e verifique os códigos de status HTTP antes de processar o corpo da resposta.

Limites de Taxa

100

requisições/minuto

Plano Gratuito

1000

requisições/minuto

Plano Pro

5000

requisições/minuto

Empresarial

Cabeçalhos de Limite de Taxa: Cada resposta inclui os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset para rastrear seu uso atual.

Pronto para começar a construir?

Obtenha sua chave de API e comece a criar vídeos incríveis com o Seedance

Começar Voltar ao Início