Skip to main content
Use a documentação dos 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; portanto, salve o ID da tarefa e use polling para recuperar os resultados. Adicione callbacks somente quando a página específica do modelo documentar suporte a callbacks.

Escolha uma API de vídeo

Criar um vídeo Seedance

Criar tarefas de vídeo Seedance.

Criar um vídeo HappyHorse

Criar tarefas de text-to-video do HappyHorse.

Criar um vídeo MiniMax H3

Criar tarefas de text-to-video ou de vídeo com imagem de referência do MiniMax H3.

Criar um vídeo Flux 3

Criar tarefas de text-to-video ou image-to-video do Flux 3.

Criar um vídeo Sora 2

Criar tarefas de vídeo Sora 2.

Recuperar um vídeo Sora 2

Consultar tarefas de vídeo Sora.

Criar um vídeo Veo 3

Criar tarefas de vídeo Veo.

Criar um vídeo Wan

Criar tarefas de text-to-video ou image-to-video do Wan.

Criar um vídeo xAI

Gerar tarefas de vídeo xAI.

Criar um vídeo Vidu

Criar tarefas de text-to-video ou image-to-video do Vidu.

Criar um vídeo Omni (Beta)

Criar tarefas de vídeo Omni em beta.

Criar uma tarefa de text-to-video do Kling

Gerar vídeos Kling a partir de Prompts de texto.

Usar modelos Runway

Escolha um modelo Runway para tarefas de imagem, vídeo ou áudio.

Criar e consultar uma tarefa de vídeo

Use um ID de modelo compatível com vídeo da página de modelos ou o diretório de modelos. Os exemplos abaixo criam uma tarefa de vídeo com POST /v1/videos e, em seguida, consultam o ID da tarefa retornado até que a tarefa alcance um estado terminal.
Estes exemplos usam o espaço reservado your-video-model-id. Substitua-o por um ID de modelo de vídeo disponível na página de modelos ou no diretório de modelos antes de executar a solicitação.
Abra Criar um vídeo Seedance e Recuperar um vídeo Seedance para usar os playgrounds da API e os esquemas de endpoint.
Crie a tarefa com uma solicitação direta:
Consulte a tarefa uma vez usando o ID retornado:

Exemplos de resposta

Uma resposta de criação bem-sucedida pode ser assim. Armazene o ID da tarefa antes de fazer consultas:
Uma resposta de consulta bem-sucedida pode ser assim. Respostas concluídas podem incluir video_url; alguns formatos de provedores 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 /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 manipulador do seu trabalho.
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 campos de resultado específicos do modelo ou a rota de conteúdo quando disponíveis.
Use o polling como fonte da verdade e verifique se a URL do seu callback aceita solicitações POST.

Códigos de erro e estratégia de retentativa

Não tente novamente antes de corrigir os campos de prompt, arquivos, duração ou tamanho.
Não tente novamente antes de garantir que a chave de API esteja presente e seja válida.
Verifique o ID da tarefa, a URL base, o caminho e o ID do modelo 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 criar a tarefa novamente com backoff; continue o polling das tarefas existentes, a menos que a tarefa atinja um erro terminal.

Preços e catálogo de modelos

Página de modelos

Saiba como a CometAPI expõe IDs de modelo na documentação.

Catálogo de modelos

Navegue pela disponibilidade e pelas capacidades dos modelos.

Preços

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