DOCUMENTAÇÃO PARA DESENVOLVEDORES

Um caminho direto do prompt ao vídeo.

Estes exemplos chamam o SeedanceLink. Use sua própria chave de API; sua sessão do Google é destinada ao console web.

Antes de começar

Entre, adicione saldo suficiente para a cotação e crie uma chave em um grupo com Seedance habilitado. O menor exemplo abaixo solicita 4 segundos em 480p.

Criar sua chave de API Modelos e preços

Autenticação

Envie Authorization: Bearer YOUR_API_KEY nas solicitações de criação, status e conteúdo. Use a mesma chave que criou a tarefa. Nunca coloque sua chave em uma URL.

Authorization: Bearer YOUR_API_KEY

Origem da APIhttps://seedancelink.io

Modelo do exemplo

Se omitidos, a duração é de 5 segundos e a resolução de 720p. Estes exemplos escolhem explicitamente 4 segundos e 480p. Envie application/json e use um dos dois IDs de modelo da página de modelos.

Execute os exemplos curl no mesmo terminal macOS/Linux ou no Windows WSL. O primeiro define sua chave e o endereço da API deste site. Mantenha a chave em segredo.

Criar uma tarefa

Este exemplo solicita um vídeo de 4 segundos. Salve o id retornado. Seedance 2.0 aceita 4–15 segundos e Seedance 2.5, 4–30. Ambos aceitam 480p, 720p e 1080p.

POST /api/v3/contents/generations/tasks

API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "Um pequeno barco atravessa um lago tranquilo ao nascer do sol, iluminação cinematográfica."
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

Exemplo de resposta

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

Salve o ID da tarefa recebido na resposta e use-o nas duas próximas etapas.

Consultar o status

Substitua REPLACE_WITH_RESPONSE_ID pelo id salvo. Consulte a cada 15 segundos durante a espera ou execução. Baixe quando o status for succeeded. Se for failed ou needs_reconcile, pare as consultas; para needs_reconcile, contate o suporte. Não envie novamente de forma automática.

GET /api/v3/contents/generations/tasks/<task_id>

TASK_ID='REPLACE_WITH_RESPONSE_ID'

curl --fail-with-body "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY"

Exemplo de resposta

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

Consulte aproximadamente a cada 15 segundos. Baixe apenas quando o status for succeeded.

Baixar o vídeo

Use a mesma chave que criou a tarefa. Este endpoint protegido exige sua chave Bearer; abrir a URL no navegador não basta. curl segue redirecionamentos HTTPS sem compartilhar a chave com outros hosts.

GET /api/v3/contents/generations/tasks/<task_id>/content

curl --fail --location --proto-redir '=https' --max-redirs 3 \
  "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID/content" \
  --header "Authorization: Bearer $API_KEY" \
  --output video.mp4

Estados e cobrança

queued: Aceita e aguardando.
running: Geração em andamento.
succeeded: Concluída; o endpoint de conteúdo autenticado está pronto.
failed: A geração falhou; o valor reservado foi devolvido.
needs_reconcile: O resultado do envio é incerto; o valor continua reservado para revisão.

Cotação antes da geração.

Segundos solicitados × tarifa da resolução × multiplicador aplicável. O valor é reservado no envio, cobrado em caso de sucesso e devolvido em caso de falha.

Baixe com a mesma chave

Após succeeded, use content.video_url ou o endpoint de conteúdo abaixo com sua chave de API. Um saldo restante de zero não impede o download de uma tarefa já paga.

Se o resultado do envio for incerto

Um recibo 202 com needs_reconcile ainda contém um ID de tarefa local. Guarde esse ID e consulte o status. Não crie outra tarefa automaticamente: o valor original continua reservado.