Saltar para o conteúdo principal
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper airplane glides across a desk.' \
  --form input_reference='@example-file'
{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Comece com o menor trabalho útil

  • Use sora-2 para iterações mais rápidas 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 formato retrato
  • Envie no máximo uma imagem de referência

​
Fluxo de ponta a ponta

1

Criar o trabalho de renderização

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

Consultar até o trabalho terminar

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

Baixar ou remixar o resultado

Quando a renderização terminar, obtenha o arquivo com Retrieve Video Content. Se quiser uma variação direcionada, use Remix Video no resultado concluído.

​
Comportamento do Sora que ainda se aplica

A OpenAI documenta o mesmo fluxo create -> retrieve -> download na API de Videos. No CometAPI, você mantém o formato da solicitação do Sora, mas usa a URL base e a chave do CometAPI. As 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 prolongada.

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 a current model from the Models page.

Exemplo:

"sora-2"

​
seconds
enum<string>
padrão:4

Clip duration in seconds.

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

"4"

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

Output resolution formatted as width x height.

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