Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Utilisez la documentation des modèles vidéo CometAPI en choisissant le workflow fournisseur qui correspond à votre type de tâche. La plupart des endpoints vidéo créent des tâches asynchrones, alors enregistrez l’ID de tâche et utilisez le polling pour récupérer les résultats. Ajoutez des callbacks uniquement lorsque la page spécifique au modèle documente la prise en charge des callbacks.

​
Choisir une API vidéo

Créer une vidéo Sora

Créez des tâches vidéo Sora.

Récupérer une vidéo Sora

Interrogez des tâches vidéo Sora.

Runway image vers vidéo

Générez des vidéos Runway à partir d’images.

Kling texte vers vidéo

Générez des vidéos Kling à partir de prompts textuels.

Création Seedance

Créez des tâches vidéo Seedance.

Génération vidéo xAI

Générez des tâches vidéo xAI.

​
Créer une tâche vidéo et la sonder

Utilisez un model ID compatible vidéo depuis la page Models ou le répertoire de modèles. Les exemples ci-dessous créent une tâche vidéo avec POST /v1/videos, puis sondent l’ID de tâche renvoyé jusqu’à ce que la tâche atteigne un état terminal.
Ces exemples utilisent l’espace réservé your-video-model-id. Remplacez-le par un model ID vidéo disponible depuis la page Models ou le répertoire de modèles avant d’exécuter la requête.
Ouvrez Create et Query pour utiliser les playgrounds API et les schémas d’endpoint.
import os
import time
import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

create_response = requests.post(
    "https://api.cometapi.com/v1/videos",
    headers=headers,
    data={
        "model": "your-video-model-id",
        "prompt": "A calm camera move across a desk with a paper airplane",
    },
    timeout=30,
)
create_response.raise_for_status()
task = create_response.json()
task_id = task["id"]

terminal_statuses = {"completed", "failed", "error"}

while True:
    poll_response = requests.get(
        f"https://api.cometapi.com/v1/videos/{task_id}",
        headers=headers,
        timeout=30,
    )
    poll_response.raise_for_status()
    result = poll_response.json()
    print(result["status"], result.get("progress"))

    if result["status"] in terminal_statuses:
        print(result.get("video_url"))
        break

    time.sleep(10)

​
Exemples de réponses

Une réponse de création réussie peut ressembler à ceci. Stockez l’ID de tâche avant de lancer le polling : 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Une réponse de polling réussie peut ressembler à ceci. Les réponses terminées peuvent inclure video_url ; certains formats fournisseurs utilisent des champs de résultat spécifiques au modèle ou la route de contenu vidéo lorsque cette route est documentée : 
{
  "id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "https://example.com/generated-video.mp4"
}

​
Exemples d’enregistrements de modèle

Cet exemple de réponse du catalogue de modèles montre l’enveloppe /api/models et la forme d’un enregistrement de modèle vidéo. Il ne s’agit pas d’une liste complète de modèles.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1767529753,
      "id": "your-video-model-id",
      "code": "your-video-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example video model",
      "model_type": "video",
      "features": [
        "text-to-video"
      ],
      "endpoints": "{\n  \"seedance\": {\n    \"path\": \"/v1/videos\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": null,
        "output": null,
        "per_request": null,
        "per_second": 0.024
      }
    }
  ]
}

​
Erreurs courantes

Stockez l’ID de la réponse de création avant de retourner depuis votre gestionnaire de tâche.
Ajoutez un délai et un backoff entre les vérifications d’état.
Utilisez les champs de durée et de résolution documentés pour l’endpoint vidéo sélectionné.
Traitez video_url comme optionnel et utilisez en repli des champs de résultat spécifiques au modèle ou la route de contenu lorsqu’elle est disponible.
Utilisez le polling comme source de vérité et vérifiez que votre URL de callback accepte les requêtes POST.

​
Codes d’erreur et stratégie de retry

Ne réessayez pas tant que les champs de prompt, fichiers, durée ou taille n’ont pas été corrigés.
Ne réessayez pas tant que la clé API n’est pas présente et valide.
Vérifiez l’ID de tâche, l’URL de base, le chemin et le model ID avant de réessayer.
Réduisez la taille de l’upload avant de réessayer.
Réessayez avec un backoff exponentiel et réduisez la concurrence de création ou de polling.
Réessayez la création de tâche avec backoff ; continuez à sonder les tâches existantes sauf si la tâche atteint une erreur terminale.
Pour les modèles d’implémentation, consultez Error codes and retry strategy, Rate limits and concurrency, et Webhook and polling for video generation.

​
Tarification et répertoire de modèles

Page Models

Découvrez comment CometAPI expose les model IDs dans la documentation.

Répertoire de modèles

Parcourez la disponibilité et les capacités des modèles.

Tarification

Vérifiez la tarification avant d’appeler un modèle.
Last modified on May 28, 2026