Skip to main content

Lo que vas a crear

Enviarás un trabajo de video de Sora 2, almacenarás el ID del video devuelto, consultarás el estado hasta que el trabajo se complete y descargarás el contenido final del video.

Requisitos previos

  • Una clave API de CometAPI almacenada en COMETAPI_KEY
  • Python 3.10+ con requests, o Node.js 18+
  • Un worker del lado del servidor o una cola de trabajos para consultar el estado

Clave API, URL base, autenticación

Crea trabajos de Sora con:
Consulta el estado con:
Descarga el contenido completado con:
Autentícate con un token Bearer:

Ejemplos de código

Usa las pestañas de abajo para ver ejemplos copiables en cURL, Python y Node.js.

Explicación del flujo

La generación de Sora es asíncrona. El endpoint de creación devuelve un video ID y un estado inicial. Consulta GET /v1/videos/<video_id> hasta que status sea completed o failed. Cuando la tarea se complete, descarga el archivo con GET /v1/videos/<video_id>/content. Usa tamaños WxH exactos. La referencia de la API de Sora documenta tamaños estándar en horizontal y vertical, con tamaños Pro más grandes para los flujos de trabajo del modelo Pro.

Parámetros comunes

Solución de problemas / Preguntas frecuentes

Usa datos de formulario multipart. Las solicitudes de creación de Sora en la referencia usan campos de formulario, no un cuerpo JSON.
Descarga el contenido solo después de que el endpoint de estado informe completed. Guarda el archivo finalizado en tu propio almacenamiento.
Usa tamaños Pro más grandes solo con un flujo de trabajo de modelo Pro. Empieza con 1280x720 para una primera solicitud.

Siguientes pasos