Skip to main content
POST
Use este endpoint para iniciar uma tarefa de renderização do Sora a partir de texto, ou de texto mais uma imagem de referência. A API retorna imediatamente um id de vídeo e não espera a renderização terminar.

​
Comece com a menor tarefa útil

  • Use sora-2 para iteração mais rápida ou sora-2-pro quando a qualidade da saída for mais importante do que a velocidade
  • Mantenha seconds em 4 na sua primeira solicitação
  • Comece com size: 1280x720, a menos que você precise especificamente de saída em retrato
  • Envie no máximo uma imagem de referência

​
Duração e tamanho

O Sora exige o campo size no formato exato WxH. Tokens de resolução como 720p e rótulos de proporção como 16:9 não são valores válidos de size do Sora neste endpoint.

​
Fluxo de ponta a ponta

1

Create the render job

Envie model, prompt, seconds e size, depois salve o id retornado.
2

Poll until the job finishes

Chame Retrieve Video até que o status se torne completed ou failed.
3

Download the result

Quando a renderização terminar, busque o arquivo com Retrieve Video Content.

​
Comportamento do Sora que ainda se aplica

A OpenAI documenta o mesmo fluxo create -> retrieve -> download na API de vídeos. No CometAPI, você mantém o formato de solicitação do Sora, mas usa a URL base e a chave do CometAPI. URLs de download concluídas são temporárias, então copie os ativos concluídos para o seu próprio armazenamento se precisar de retenção longa.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data
​
prompt
string
obrigatório

Text prompt that describes the video you want to create.

Exemplo:

"A paper airplane glides across a desk."

​
model
string
padrão:sora-2

Sora model ID. Choose an available model from the Models page.

Exemplo:

"sora-2"

​
seconds
enum<string>
padrão:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Opções disponíveis:
4,
8,
12,
16,
20
Exemplo:

"4"

​
size
enum<string>
padrão:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Opções disponíveis:
720x1280,
1280x720,
1024x1792,
1792x1024
Exemplo:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Resposta

200 - application/json

Video job accepted.

​
created_at
integer
obrigatório
​
id
string
obrigatório
​
model
string
obrigatório
​
object
string
obrigatório
​
progress
integer
obrigatório
​
seconds
string
obrigatório
​
size
string
obrigatório
​
status
string
obrigatório