Saltar al contenido 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.

Usa este endpoint para iniciar un nuevo trabajo de renderizado de Sora a partir de texto, o de texto más una imagen de referencia. La API devuelve un id de video inmediatamente y no espera a que termine el renderizado.

​
Comienza con el trabajo útil más pequeño

  • Usa sora-2 para iterar más rápido o sora-2-pro cuando la calidad de salida importe más que la velocidad
  • Mantén seconds en 4 para tu primera solicitud
  • Comienza con size: 1280x720 a menos que necesites específicamente una salida en formato vertical
  • Sube como máximo una imagen de referencia

​
Flujo de extremo a extremo

1

Crear el trabajo de renderizado

Envía model, prompt, seconds y size, y luego guarda el id devuelto.
2

Consultar hasta que el trabajo finalice

Llama a Retrieve Video hasta que el estado cambie a completed o failed.
3

Descargar o remezclar el resultado

Cuando el renderizado termine, obtén el archivo con Retrieve Video Content. Si quieres una variación específica, usa Remix Video sobre el resultado completado.

​
Comportamiento de Sora que sigue aplicando

OpenAI documenta el mismo flujo de crear -> recuperar -> descargar en la API de Videos. En CometAPI mantienes la forma de solicitud de Sora, pero usas la URL base y la clave de CometAPI. Las URLs de descarga finalizadas son temporales, así que copia los recursos completados a tu propio almacenamiento si necesitas conservarlos durante más tiempo.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

multipart/form-data
​
prompt
string
requerido

Text prompt that describes the video you want to create.

Ejemplo:

"A paper airplane glides across a desk."

​
model
string
predeterminado:sora-2

Sora model ID. Choose a current model from the Models page.

Ejemplo:

"sora-2"

​
seconds
enum<string>
predeterminado:4

Clip duration in seconds.

Opciones disponibles:
4,
8,
12
Ejemplo:

"4"

​
size
enum<string>
predeterminado:1280x720

Output resolution formatted as width x height.

Opciones disponibles:
720x1280,
1280x720,
1024x1792,
1792x1024
Ejemplo:

"1280x720"

​
input_reference
file

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

Respuesta

200 - application/json

Video job accepted.

​
created_at
integer
requerido
​
id
string
requerido
​
model
string
requerido
​
object
string
requerido
​
progress
integer
requerido
​
seconds
string
requerido
​
size
string
requerido
​
status
string
requerido