Skip to main content

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:
Consulte o status com:
Baixe o conteúdo concluído com:
Autentique com um token Bearer:

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. Consulte GET /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

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.
Baixe o conteúdo somente depois que o endpoint de status reportar completed. Armazene o arquivo finalizado no seu próprio armazenamento.
Use tamanhos Pro maiores apenas com um fluxo de trabalho de modelo Pro. Comece com 1280x720 para uma primeira solicitação.

Próximos passos

Última modificação em 30 de junho de 2026