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: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. ConsultaGET /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
La solicitud de creación falla
La solicitud de creación falla
Usa datos de formulario multipart. Las solicitudes de creación de Sora en la referencia usan campos de formulario, no un cuerpo JSON.
La descarga del contenido falla
La descarga del contenido falla
Descarga el contenido solo después de que el endpoint de estado informe
completed. Guarda el archivo finalizado en tu propio almacenamiento.Un tamaño Pro no funciona
Un tamaño Pro no funciona
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
- Lee la referencia de API para crear un video de Sora 2.
- Haz polling con Recuperar un video de Sora 2.
- Descarga con Recuperar el contenido de video de Sora 2.
- Encuentra los modelos de video disponibles en Models.
- Revisa Usar polling y webhooks para la generación de video.
- Estima el costo de la tarea con Estimar el costo de la solicitud antes de llamar a un modelo.