Zum Hauptinhalt springen

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.

Verwenden Sie die CometAPI-Dokumentation für Video-Modelle, indem Sie den Anbieter-Workflow auswählen, der zu Ihrem Auftragstyp passt. Die meisten Video-Endpunkte erstellen asynchrone Aufgaben, daher speichern Sie die Task-ID und verwenden Polling, um Ergebnisse abzurufen. Fügen Sie Callbacks nur hinzu, wenn die modellspezifische Seite Callback-Unterstützung dokumentiert.

​
Wählen Sie eine Video-API

Sora-Video erstellen

Sora-Video-Jobs erstellen.

Sora-Video abrufen

Sora-Video-Jobs abfragen.

Runway Bild zu Video

Runway-Videos aus Bildern generieren.

Kling Text zu Video

Kling-Videos aus Text-Prompts generieren.

Seedance erstellen

Seedance-Video-Tasks erstellen.

xAI-Video-Generierung

xAI-Video-Jobs generieren.

​
Eine Video-Task erstellen und pollen

Verwenden Sie eine model ID mit Video-Funktionen von der Models-Seite oder dem model directory. Die folgenden Beispiele erstellen eine Video-Task mit POST /v1/videos und pollen dann die zurückgegebene Task-ID, bis die Aufgabe einen terminalen Status erreicht.
Diese Beispiele verwenden den Platzhalter your-video-model-id. Ersetzen Sie ihn vor der Ausführung der Anfrage durch eine verfügbare Video model ID von der Models-Seite oder aus dem model directory.
Öffnen Sie Create und Query, um die API-Playgrounds und Endpunktschemas zu verwenden.
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)

​
Beispiel-Antworten

Eine erfolgreiche Create-Antwort kann folgendermaßen aussehen. Speichern Sie die Task-ID, bevor Sie mit dem Polling beginnen: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Eine erfolgreiche Polling-Antwort kann folgendermaßen aussehen. Abgeschlossene Antworten können video_url enthalten; einige Anbieterformate verwenden modellspezifische Ergebnisfelder oder den video content route, wenn dieser Route dokumentiert ist: 
{
  "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"
}

​
Beispiel-Modelldatensätze

Diese Beispielantwort des Modellkatalogs zeigt den /api/models-Envelope und die Form eines einzelnen Video-Modelldatensatzes. Es ist keine vollständige Modellliste.
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
      }
    }
  ]
}

​
Häufige Fehler

Speichern Sie die ID aus der Create-Antwort, bevor Sie von Ihrem Job-Handler zurückkehren.
Fügen Sie Verzögerung und Backoff zwischen den Statusprüfungen hinzu.
Verwenden Sie die für den ausgewählten Video-Endpunkt dokumentierten Felder für Dauer und Auflösung.
Behandeln Sie video_url als optional und verwenden Sie stattdessen, falls verfügbar, modellspezifische Ergebnisfelder oder den content route.
Verwenden Sie Polling als Single Source of Truth und prüfen Sie, ob Ihre Callback-URL POST-Anfragen akzeptiert.

​
Fehlercodes und Retry-Strategie

Versuchen Sie es erst erneut, wenn die Felder prompt, files, duration oder size korrigiert sind.
Versuchen Sie es erst erneut, wenn der API key vorhanden und gültig ist.
Prüfen Sie vor einem erneuten Versuch die Task-ID, die Base URL, den Pfad und die model ID.
Reduzieren Sie die Upload-Größe vor einem erneuten Versuch.
Wiederholen Sie den Vorgang mit exponentiellem Backoff und reduzieren Sie die gleichzeitigen Create- oder Polling-Anfragen.
Wiederholen Sie die Erstellung der Task mit Backoff; pollen Sie bestehende Tasks weiter, außer die Task erreicht einen terminalen Fehler.
Für Implementierungsmuster siehe Error codes and retry strategy, Rate limits and concurrency und Webhook and polling for video generation.

​
Preise und model directory

Models-Seite

Lesen Sie, wie CometAPI model IDs in der Dokumentation bereitstellt.

Model directory

Durchsuchen Sie die Verfügbarkeit und Fähigkeiten der Modelle.

Preise

Prüfen Sie die Preise, bevor Sie ein Modell aufrufen.
Last modified on May 28, 2026