Saltar al contenido principal
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}
Usa este endpoint después de iniciar un trabajo de Sora. Informa el estado actual del trabajo, el tamaño y la duración configurados, y cualquier error devuelto por el proveedor.

​
Observa estos campos

  • status para el estado del ciclo de vida
  • progress para una señal aproximada del progreso
  • error cuando el proveedor rechaza o falla el trabajo
  • expires_at después de completarse si necesitas saber cuándo expiran los recursos temporales

​
Consulta hasta la finalización

1

Crea o remezcla el video primero

Comienza con Create Video o Remix Video.
2

Consulta por id

Pasa aquí el id devuelto y sigue comprobando hasta que el trabajo alcance completed o failed.
3

Descarga el archivo

Cuando el trabajo esté en completed, continúa con Retrieve Video Content.

​
Forma de la respuesta en CometAPI

Este paso coincide estrechamente con el flujo de consulta de Sora. CometAPI mantiene la forma de objeto al estilo OpenAI para que puedas conectar las comprobaciones de estado con una traducción mínima.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Parámetros de ruta

​
video_id
string
requerido

Video id returned by the create or remix endpoint.

Respuesta

200 - application/json

Current job state.

​
id
string
requerido
​
size
string
requerido
​
model
string
requerido
​
object
string
requerido
​
status
string
requerido
​
seconds
string
requerido
​
progress
integer
requerido
​
created_at
integer
requerido
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null