cicora.ai
Español (México)
Especificación de la APIMedios asíncronos

Vídeo

Inicia el vídeo como trabajo asíncrono, conserva su ID y separa la creación de la lectura del resultado.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

Crea un trabajo

Una solicitud de vídeo suele incluir prompt, model y propiedades de fotograma como duración, relación de aspecto, resolución o referencias solo cuando el modelo elegido las admita.

Guarda inmediatamente el ID del trabajo. Es necesario para mostrar progreso, permitir cancelación en tu interfaz y obtener el contenido final.

Trabajo de generación de vídeo
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Consulta el estado

  • Lee un trabajo mediante GET /videos/{video_id}.
  • Trata el estado terminal como fuente fiable de finalización.
  • Usa un intervalo de consulta creciente y detenlo cuando el usuario se marche.

Trabaja con el resultado

Al terminar, usa la URL o el contenido devuelto por el trabajo y verifica que el archivo esté listo antes de mostrar un reproductor.

Conserva prompt, model, parámetros e ID del trabajo para soporte, pero no guardes referencias de entrada más tiempo del que requiera tu producto.

Continuar con