Skip to main content
Use a documentação de modelos de vídeo da CometAPI escolhendo o fluxo de trabalho do provedor que corresponde ao seu tipo de tarefa. A maioria dos endpoints de vídeo cria tarefas assíncronas, então salve o ID da tarefa e use polling para recuperar os resultados. Adicione callbacks apenas quando a página específica do modelo documentar suporte a callback.

Escolha uma API de vídeo

Criar um vídeo Seedance

Crie tarefas de vídeo Seedance.

Criar um vídeo HappyHorse

Crie tarefas de texto para vídeo do HappyHorse.

Criar um vídeo Sora 2

Crie tarefas de vídeo Sora 2.

Recuperar um vídeo Sora 2

Consulte tarefas de vídeo do Sora.

Criar um vídeo Veo 3

Crie tarefas de vídeo Veo.

Criar um vídeo Wan

Crie tarefas de texto para vídeo do Wan.

Criar um vídeo xAI

Gere tarefas de vídeo xAI.

Criar um vídeo Vidu

Crie tarefas de texto para vídeo do Vidu.

Criar um vídeo Omni (Beta)

Crie tarefas beta de vídeo Omni.

Criar uma tarefa de texto para vídeo do Kling

Gere vídeos Kling a partir de prompts de texto.

Criar uma tarefa de imagem para vídeo do Runway

Gere vídeos Runway a partir de imagens.

Criar e consultar uma tarefa de vídeo

Use um model ID com capacidade de vídeo da página Models ou do diretório de modelos. Os exemplos abaixo criam uma tarefa de vídeo com POST /v1/videos e, em seguida, consultam o task ID retornado até que a tarefa atinja um estado terminal.
Estes exemplos usam o placeholder your-video-model-id. Substitua-o por um model ID de vídeo disponível na página Models ou no diretório de modelos antes de executar a requisição.
Abra Create a Seedance video e Retrieve a Seedance video para usar os playgrounds da API e os schemas dos endpoints.

Exemplos de resposta

Uma resposta de criação bem-sucedida pode ser assim. Armazene o task ID antes de consultar:
Uma resposta de consulta bem-sucedida pode ser assim. Respostas concluídas podem incluir video_url; alguns formatos de provider usam campos de resultado específicos do modelo ou a rota de conteúdo de vídeo quando essa rota está documentada:

Registros de modelo de exemplo

Esta resposta de exemplo do catálogo de modelos mostra o envelope de /api/models e o formato de um registro de modelo de vídeo. Não é uma lista completa de modelos.
cURL

Erros comuns

Armazene o ID da resposta de criação antes de retornar do seu manipulador de job.
Adicione atraso e backoff entre as verificações de status.
Use os campos de duração e resolução documentados para o endpoint de vídeo selecionado.
Trate video_url como opcional e use como fallback campos de resultado específicos do modelo ou a rota de conteúdo, quando disponível.
Use polling como fonte da verdade e verifique se a sua URL de callback aceita requisições POST.

Códigos de erro e estratégia de retry

Não tente novamente até que os campos de prompt, arquivos, duração ou tamanho sejam corrigidos.
Não tente novamente até que a chave de API esteja presente e seja válida.
Verifique o ID da tarefa, a URL base, o path e o model ID antes de tentar novamente.
Reduza o tamanho do upload antes de tentar novamente.
Tente novamente com backoff exponencial e reduza a concorrência de criação ou polling.
Tente novamente a criação da tarefa com backoff; continue fazendo polling das tarefas existentes, a menos que a tarefa atinja um erro terminal.

Preços e diretório de modelos

Página de modelos

Leia como a CometAPI expõe model IDs na documentação.

Diretório de modelos

Navegue pela disponibilidade e capacidades dos modelos.

Preços

Verifique os preços antes de chamar um modelo.
Última modificação em 23 de junho de 2026