O que você vai criar
Você enviará um job de vídeo do Sora 2, armazenará o ID do vídeo retornado, consultará até que o job seja concluído e baixará o conteúdo final do vídeo.Pré-requisitos
- Uma chave de API da CometAPI armazenada em
COMETAPI_KEY - Python 3.10+ com
requests, ou Node.js 18+ - Um worker do lado do servidor ou fila de jobs para polling
Chave de API, URL base, autenticação
Crie jobs do Sora com:Exemplos de código
Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.Explicação do fluxo
A geração com Sora é assíncrona. O endpoint de criação retorna um ID de vídeo e um status inicial. ConsulteGET /v1/videos/<video_id> até que status seja completed ou failed. Quando o trabalho estiver concluído, baixe o arquivo com GET /v1/videos/<video_id>/content.
Use tamanhos WxH exatos. A referência da API do Sora documenta tamanhos padrão em paisagem e retrato, com tamanhos Pro maiores para fluxos de trabalho do modelo Pro.
Parâmetros comuns
Solução de problemas / FAQ
A solicitação de criação falha
A solicitação de criação falha
Use dados de formulário multipart. As solicitações de criação do Sora na referência usam campos de formulário, não um corpo JSON.
O download do conteúdo falha
O download do conteúdo falha
Baixe o conteúdo somente depois que o endpoint de status reportar
completed. Armazene o arquivo finalizado no seu próprio armazenamento.Um tamanho Pro não funciona
Um tamanho Pro não funciona
Use tamanhos Pro maiores apenas com um fluxo de trabalho de modelo Pro. Comece com
1280x720 para uma primeira solicitação.Próximos passos
- Leia a referência da API Create a Sora 2 video.
- Faça polling com Retrieve a Sora 2 video.
- Baixe com Retrieve Sora 2 video content.
- Encontre os modelos de vídeo disponíveis em Models.
- Revise Use polling and webhooks for video generation.
- Estime o custo da tarefa com Estimate request cost before calling a model.