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