Seedance status e resultado da tarefa

A criação de vídeo Seedance é assíncrona. A solicitação de criação retorna um ID de tarefa; poll Modelflare até que a tarefa seja concluída ou falhe.

Modelos suportados

Criar uma tarefa

Use a página do modelo correspondente para o corpo completo da solicitação:

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

Salve id da resposta. As respostas de compatibilidade podem usar task_id.

Pesquise a tarefa

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

A resposta do público é normalizada entre provedores de vídeo:

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

Pesquisa enquanto status for queued ou in_progress. Pare em completed ou failed.

Estado	Significado	Próximo passo
queued	Aguardando execução	Pesquisa novamente
in_progress	Processamento	Pesquisa novamente
completed	O vídeo está pronto	Baixe o conteúdo
failed	Tarefa falhou	Leia o erro e corrija a solicitação

Quando a resposta do serviço os inclui, metadata pode conter a ação normalizada, resolução, proporção, formato de saída, sinalizador de áudio e uso de token. Trate esses campos como opcionais; use status e o endpoint de conteúdo como contrato estável.

Baixe o resultado

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

O endpoint de conteúdo retorna o stream de vídeo. Armazene-o imediatamente porque os URLs de resultados podem expirar.

Tarefas com falha

A criação pode retornar um ID de tarefa antes do término da validação do provedor. Uma votação posterior pode, portanto, alterar a tarefa para failed. Mantenha o ID da solicitação ao investigar erros. Não tente novamente alterando silenciosamente o envelope de solicitação para outra família de modelos.