Gere vídeos e imagens com suas próprias ferramentas

Início Rápido

1. 1

   Criar uma chave

   Gere uma chave de API no seu painel. Ela só é exibida uma vez, então guarde-a em um local seguro.

   Gerenciar chaves
2. 2

   Chamar a API

   Envie uma requisição POST com sua chave Bearer e o cabeçalho Idempotency-Key.

   cURLJavaScriptPython

   Copy

   curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
     -H "Authorization: Bearer $SEEDANCE_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: demo-video-001" \
     -d '{
       "mode": "text-to-video",
       "quality_tier": "standard",
       "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
       "aspect_ratio": "16:9",
       "duration": "5",
       "resolution": "720p"
     }'

3. 3

   Coletar o resultado

   Consulte o endpoint de status da tarefa até que o status seja 'completed' ou 'failed', e então leia a saída.

   cURLJavaScriptPython

   Copy

   while true; do
     TASK=$(curl -s https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
       -H "Authorization: Bearer $SEEDANCE_API_KEY")
     STATUS=$(echo "$TASK" | jq -r '.status')
     if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
       echo "$TASK" | jq
       break
     fi
     sleep 10
   done

Autenticação

Cada requisição é autenticada com uma chave de API Bearer no cabeçalho Authorization.

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Tasks and balance

Read endpoints for building a task history, showing remaining credits, or discovering models at runtime. They share the read rate limit.

curl "https://www.seedance2ai.io/api/v1/tasks?limit=20" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "sd2_xxxxx",
      "type": "video",
      "status": "completed",
      "model": "seedance2",
      "credits_used": 30,
      "result_urls": ["https://..."]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://www.seedance2ai.io/api/v1/balance" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "credits": 1200,
  "subscription_credits": 1000,
  "subscription_credits_expire_at": "2026-07-01T00:00:00.000Z"
}

curl "https://www.seedance2ai.io/api/v1/models" \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

{
  "data": [
    {
      "id": "seedance2",
      "name": "Seedance 2.0",
      "type": "video",
      "method": "POST",
      "endpoint": "/api/v1/video/seedance2",
      "modes": ["text-to-video", "image-to-video", "media-to-video"],
      "task_id_prefix": "sd2_"
    }
  ]
}

Códigos de erro

Every error has the same shape. Branch on code, and show message to a person. A task that was accepted can still fail later, so also check status when you poll.

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body: prompt: String must contain at least 3 character(s)"
  }
}

Rate limits

A request over the limit returns HTTP 429 with a Retry-After header in seconds, plus X-RateLimit-Limit and X-RateLimit-Reset. Wait that long, then retry with the same Idempotency-Key.

Submit a job

30 per 60 seconds

Every POST endpoint, counted per account across all of its keys.

Read

120 per 60 seconds

Task status, task list, balance and models. Counted separately, so polling never uses up the submit budget.

Reference media validation

3 per 60 seconds

Seedance requests that include reference media, per account and source IP.

Use com Claude Code

Use o Copy for AI para exportar a API completa como Markdown limpo, cole no Claude Code ou Codex e deixe o agente configurar a integração. Ou aponte o agente diretamente para o endpoint de texto bruto.

Skill

Instale a skill Seedance no Claude Code, no Codex ou em qualquer agente — ela escreve prompts cinematográficos e os renderiza através da API para você.

# Download the one-file skill from Seedance 2.0 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Perguntas Frequentes

Quem pode usar a API?

Qualquer pessoa com créditos. Não há restrição de plano — qualquer conta com créditos pode criar uma chave e chamar a API.

Como consigo créditos?

Recarregue ou assine na página de preços. Os créditos são adicionados ao seu saldo instantaneamente.

Os créditos são compartilhados entre o site e a API?

Sim — seu saldo pessoal de créditos é usado tanto para as gerações na web quanto para as chamadas de API. Em uma equipe, as chamadas de API consomem o saldo pessoal de cada membro, e não o saldo compartilhado da equipe.

Como começar?

Crie uma chave de API no seu painel e chame os endpoints com um token Bearer (veja o Quickstart acima).

E se uma chamada retornar 'insufficient_credits'?

Seu saldo está vazio — recarregue na página de preços e tente novamente.