Przejdź do głównej treści

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.

Korzystaj z dokumentacji modeli wideo CometAPI, wybierając workflow dostawcy, który pasuje do typu Twojego zadania. Większość endpointów wideo tworzy zadania asynchroniczne, więc zapisz ID zadania i użyj pollingu do pobrania wyników. Dodawaj callbacki tylko wtedy, gdy strona dotycząca konkretnego modelu dokumentuje obsługę callbacków.

​
Wybierz video API

Tworzenie wideo Sora

Twórz zadania wideo Sora.

Pobieranie wideo Sora

Odpytuj zadania wideo Sora.

Runway image to video

Generuj filmy Runway z obrazów.

Kling text to video

Generuj filmy Kling z promptów tekstowych.

Tworzenie Seedance

Twórz zadania wideo Seedance.

Generowanie wideo xAI

Generuj zadania wideo xAI.

​
Tworzenie zadania wideo i polling

Użyj model ID obsługującego wideo ze strony Models lub z katalogu modeli. Poniższe przykłady tworzą zadanie wideo za pomocą POST /v1/videos, a następnie odpytują zwrócone ID zadania, aż zadanie osiągnie stan końcowy.
Te przykłady używają placeholdera your-video-model-id. Zastąp go dostępnym video model ID ze strony Models lub katalogu modeli przed uruchomieniem żądania.
Otwórz Create i Query, aby skorzystać z playgroundów API i schematów endpointów.
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)

​
Przykłady odpowiedzi

Pomyślna odpowiedź create może wyglądać tak. Zapisz ID zadania przed rozpoczęciem pollingu: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Pomyślna odpowiedź pollingu może wyglądać tak. Ukończone odpowiedzi mogą zawierać video_url; niektóre formaty dostawców używają pól wyników specyficznych dla modelu lub ścieżki content wideo, gdy ta ścieżka jest udokumentowana: 
{
  "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"
}

​
Przykładowe rekordy modeli

Ta przykładowa odpowiedź katalogu modeli pokazuje obiekt /api/models oraz kształt jednego rekordu modelu wideo. Nie jest to pełna lista modeli.
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
      }
    }
  ]
}

​
Typowe błędy

Zapisz ID z odpowiedzi create, zanim zakończysz działanie swojego handlera zadania.
Dodaj opóźnienie i backoff między sprawdzeniami statusu.
Używaj pól duration i resolution udokumentowanych dla wybranego endpointu wideo.
Traktuj video_url jako opcjonalne i używaj pól wyników specyficznych dla modelu lub ścieżki content, gdy są dostępne.
Używaj pollingu jako źródła prawdy i sprawdź, czy Twój URL callbacka akceptuje żądania POST.

​
Kody błędów i strategia retry

Nie ponawiaj żądania, dopóki pola prompt, plików, duration lub size nie zostaną poprawione.
Nie ponawiaj żądania, dopóki klucz API nie będzie obecny i prawidłowy.
Sprawdź ID zadania, base URL, ścieżkę i model ID przed ponowieniem próby.
Zmniejsz rozmiar uploadu przed ponowieniem próby.
Ponawiaj z exponential backoff i zmniejsz współbieżność create lub pollingu.
Ponów tworzenie zadania z backoff; kontynuuj polling istniejących zadań, chyba że zadanie osiągnie końcowy błąd.
Wzorce implementacyjne znajdziesz w Error codes and retry strategy, Rate limits and concurrency oraz Webhook and polling for video generation.

​
Cennik i katalog modeli

Strona Models

Przeczytaj, jak CometAPI udostępnia model ID w dokumentacji.

Katalog modeli

Przeglądaj dostępność modeli i ich możliwości.

Cennik

Sprawdź ceny przed wywołaniem modelu.
Last modified on May 28, 2026