API Pública

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

Crie uma chave, chame a API com autenticação Bearer e consulte o status da tarefa até que seu resultado esteja pronto. Funciona com Claude Code, Codex e qualquer cliente HTTP.

Gerenciar chaves

Início Rápido

Etapa 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.

Etapa 2

Chamar a API

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

Etapa 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.

Autenticação

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

http

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

Seedance 2 Video

Texto, imagem ou mídia para vídeo.

Enviar um trabalho

POST

/api/v1/video/seedance2

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Valores permitidos
`mode` Generation mode.	`string`	Opcional	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Opcional	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Opcional	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Obrigatório	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Opcional	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Opcional	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Opcional	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opcional	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Opcional	`—`	`public https URL, ≤ 30 MB`
`media_urls` Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.	`string[] (URL)`	Opcional	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Opcional	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opcional	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Opcional	`—`	`-1 – 4294967295`

Seedance prompt guide

Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.

Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.

Requisição

bash

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"
  }'

Resposta202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

Os valores de credits_used mostrados nestes exemplos são ilustrativos. O consumo real é calculado no envio e retornado pela API.

Verificar status da tarefa

GET

/api/v1/tasks/{id}

Requisição

bash

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

Resposta200

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "resolution": "720p",
  "credits_used": 30,
  "credits_refunded": 0,
  "output": {
    "video_url": "https://...",
    "last_frame_url": "https://...",
    "seed": 123
  },
  "error": null,
  "created_at": "2026-06-03T10:00:00.000Z",
  "updated_at": "2026-06-03T10:03:12.000Z"
}

status: processing · completed · failed

Códigos de erro

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

Código	HTTP	Significado
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it.
`insufficient_credits`	`402`	Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied.
`rate_limited`	`429`	Too many requests — the general limit is 30 requests per 60 seconds per account; Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. Retry after the Retry-After response header (in seconds).
`idempotency_conflict`	`409`	Same Idempotency-Key reused with a different body, or still running.
`service_busy`	`503`	Temporary upstream or credit-concurrency issue. Retry.
`not_found`	`404`	Task does not exist or does not belong to this key owner.
`internal_error`	`500`	Unexpected server-side failure.

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.

Abrir llms-api.txt DeepSeek Harness plugin

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ê.

bash

# Download the one-file skill from Seedance 2 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

Baixar skill

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.