Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
API oficial
Crear video
Usa POST /v1/videos para crear tareas de generación de video de Sora 2 a partir de prompts de texto o imágenes de referencia, y luego consultar el estado por ID de tarea para obtener los resultados.
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"
}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-2para iterar más rápido osora-2-procuando la calidad de salida importe más que la velocidad - Mantén
secondsen4para tu primera solicitud - Comienza con
size: 1280x720a menos que necesites específicamente una salida en formato vertical - Sube como máximo una imagen de referencia
Flujo de extremo a extremo
Consultar hasta que el trabajo finalice
Llama a Retrieve Video hasta que el estado cambie a
completed o failed.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
Bearer token authentication. Use your CometAPI key.
Cuerpo
multipart/form-data
Text prompt that describes the video you want to create.
Ejemplo:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Ejemplo:
"sora-2"
Clip duration in seconds.
Opciones disponibles:
4, 8, 12 Ejemplo:
"4"
Output resolution formatted as width x height.
Opciones disponibles:
720x1280, 1280x720, 1024x1792, 1792x1024 Ejemplo:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
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"
}