Geração Assíncrona de Vídeo Seedance 1.5 Pro

Documentação da API

Use estes endpoints para submeter trabalhos Seedance 1.5 Pro e verificar o seu status. Cada chamada gasta créditos com base na duração e áudio (diálogos sincronizados, efeitos sonoros, música).

Autenticação

Todos os pedidos devem incluir a sua chave de API dentro do Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Chaves ausentes ou inválidas retornam 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

Criar tarefa de geração

Submete um novo trabalho Seedance 1.5 Pro. A chamada retorna imediatamente um task_id enquanto a renderização é concluída de forma assíncrona.

Parâmetro	Tipo	Obrigatório	Descrição
prompt	string (max 1000 chars)	Sim	Descrição da cena principal (texto ou fluxo de imagem).
aspect_ratio	string	Sim	Suportado: 16:9, 9:16, 1:1. Ignorado quando image_urls existe.
duration	string	Sim	Duração da renderização em segundos ("5" ou "10").
sound	boolean	Não	Incluir áudio no clipe (diálogos sincronizados, efeitos sonoros, música).
image_urls	string[]	Não	URLs opcionais de imagens de referência (obrigatório para imagem para vídeo).

Consumo de Crédito

Os créditos são deduzidos quando a tarefa é criada. Trabalhos falhados são automaticamente reembolsados.

Predefinição	Créditos deduzidos
5 s sem som	65
10 s sem som	130
5 s com áudio	130
10 s com áudio	260

Exemplo de pedido

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Exemplo de resposta

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

GET / POST

https://seedance1-5pro.com/api/status

Verificar status da tarefa

Use este endpoint para consultar o registro mais recente. Quando a tarefa ainda está em IN_PROGRESS, consultamos o provedor mais uma vez antes de responder.

Parâmetro	Tipo	Obrigatório	Descrição
task_id	string	Sim	ID retornado por /generate. Enviar via query (?task_id=) ou corpo JSON.

Campo	Descrição
task_id	ID retornado de /generate.
status	SUCCESS (SUCESSO)
request	Cópia higienizada do payload submetido.
response	Array de URLs de mídia quando o status é SUCCESS.
consumed_credits	Créditos cobrados pela tarefa (0 quando reembolsado).
error_message	Erro do provedor quando o status é FAILED.
created_at	Carimbo de data/hora UTC quando o trabalho foi armazenado.

Exemplo de pedido

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Tratamento de Erros

401 Unauthorized - Chave API ausente ou inválida.
402 Payment Required - O saldo de crédito não pôde cobrir a dedução.
429 Too Many Requests - Reduza a cadência de polling ou a taxa de pedidos.
500 - Problema transitório; tente novamente com backoff exponencial.