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 comPOST /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.Exemplos de resposta
Uma resposta de criação bem-sucedida pode ser assim. Armazene o ID da tarefa antes de fazer consultas: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
ID da tarefa ausente
ID da tarefa ausente
Armazene o ID da resposta de criação antes de retornar do manipulador do seu trabalho.
Polling muito rápido
Polling muito rápido
Adicione atraso e backoff entre as verificações de status.
Duração ou tamanho não compatível
Duração ou tamanho não compatível
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 campos de resultado específicos do modelo ou a rota de conteúdo quando disponíveis.Callback não recebido
Callback não recebido
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
400
400
Não tente novamente antes de corrigir os campos de prompt, arquivos, duração ou tamanho.
401
401
Não tente novamente antes de garantir que a chave de API esteja presente e seja válida.
404
404
Verifique o ID da tarefa, a URL base, o caminho e o ID do modelo 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 ou 503
500 ou 503
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.