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 comPOST /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.Exemplos de resposta
Uma resposta de criação bem-sucedida pode ser assim. Armazene o task ID antes de consultar: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
ID da tarefa ausente
ID da tarefa ausente
Armazene o ID da resposta de criação antes de retornar do seu manipulador de job.
Polling rápido demais
Polling rápido demais
Adicione atraso e backoff entre as verificações de status.
Duração ou tamanho não suportados
Duração ou tamanho não suportados
Use os campos de duração e resolução documentados para o endpoint de vídeo selecionado.
video_url ausente
video_url ausente
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.Callback não recebido
Callback não recebido
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
400
400
Não tente novamente até que os campos de prompt, arquivos, duração ou tamanho sejam corrigidos.
401
401
Não tente novamente até que a chave de API esteja presente e seja válida.
404
404
Verifique o ID da tarefa, a URL base, o path e o model ID antes de tentar novamente.
413
413
Reduza o tamanho do upload antes de tentar novamente.
429
429
Tente novamente com backoff exponencial e reduza a concorrência de criação ou polling.
500 or 503
500 or 503
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.