Skip to main content
POST
Usa este endpoint para iniciar un 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 de inmediato y no espera a que finalice el renderizado.

​
Empieza 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
  • Empieza con size: 1280x720 a menos que necesites específicamente una salida en formato vertical
  • Sube como máximo una imagen de referencia

​
Duración y tamaño

Sora requiere el campo size en el formato exacto WxH. Los tokens de resolución como 720p y las etiquetas de relación de aspecto como 16:9 no son valores válidos de size de Sora en este endpoint.

​
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 termine el trabajo

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

Descargar el resultado

Cuando el renderizado esté listo, obtén el archivo con Retrieve Video Content.

​
Comportamiento de Sora que sigue aplicando

OpenAI documenta el mismo flujo de crear -> recuperar -> descargar en la API de Videos. En CometAPI mantienes la estructura de solicitud de Sora, pero usas la URL base y la clave de CometAPI. Las URL de descarga finalizadas son temporales, así que copia los recursos completados a tu propio almacenamiento si necesitas una retención prolongada.

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 an available model from the Models page.

Ejemplo:

"sora-2"

​
seconds
enum<string>
predeterminado:4

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

Opciones disponibles:
4,
8,
12,
16,
20
Ejemplo:

"4"

​
size
enum<string>
predeterminado: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.

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