cicora.ai
Français (Belgique)
Spécification de l’APIMédias asynchrones

Vidéo

Lancez la création de la vidéo comme une tâche asynchrone, conservez son ID et séparez la création de la lecture du résultat.

Référence d’intégration : choisissez les paramètres et les capacités disponibles dans les réglages de l’API de votre compte et dans le catalogue de modèles de votre environnement.

Créer une tâche

Une requête vidéo comprend généralement prompt, model et des propriétés d’image telles que la durée, le rapport d’aspect, la résolution ou les références, uniquement lorsque le modèle choisi les prend en charge.

Enregistrez immédiatement l’ID de la tâche. Il est nécessaire pour afficher la progression, permettre l’annulation dans votre interface et obtenir le contenu final.

Tâche de génération vidéo
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"
  }'

Interroger le statut

  • Lisez une tâche via GET /videos/{video_id}.
  • Considérez le statut terminal comme la source de vérité de l’achèvement.
  • Utilisez un intervalle d’interrogation croissant et arrêtez-le lorsque l’utilisateur quitte la page.

Travailler avec le résultat

Une fois la tâche terminée, utilisez l’URL ou le contenu renvoyé et vérifiez que le fichier est prêt avant d’afficher un lecteur.

Conservez le prompt, le modèle, les paramètres et l’ID de la tâche pour l’assistance, mais ne gardez pas les références d’entrée plus longtemps que ne l’exige votre produit.

Continuer avec