Ana içeriğe atla

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.

İş türünüze uyan sağlayıcı iş akışını seçerek CometAPI video model dokümanlarını kullanın. Çoğu video endpoint’i eşzamansız görevler oluşturur, bu nedenle görev kimliğini kaydedin ve sonuçları almak için polling kullanın. Callback’leri yalnızca modele özel sayfa callback desteğini belgeliyorsa ekleyin.

​
Bir video API’si seçin

Sora video oluştur

Sora video işleri oluşturun.

Sora videoyu al

Sora video işlerini sorgulayın.

Runway image to video

Görsellerden Runway videoları oluşturun.

Kling text to video

Metin prompt’larından Kling videoları oluşturun.

Seedance oluştur

Seedance video görevleri oluşturun.

xAI video üretimi

xAI video işleri oluşturun.

​
Bir video görevi oluşturun ve polling yapın

Models page veya model directory içinden video destekli bir model ID kullanın. Aşağıdaki örnekler POST /v1/videos ile bir video görevi oluşturur, ardından görev son duruma ulaşana kadar dönen görev kimliği üzerinde polling yapar.
Bu örneklerde your-video-model-id yer tutucusu kullanılır. İsteği çalıştırmadan önce bunu Models page veya model directory içinden kullanılabilir bir video model ID ile değiştirin.
API playground’larını ve endpoint şemalarını kullanmak için Create ve Query sayfalarını açın.
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)

​
Yanıt örnekleri

Başarılı bir oluşturma yanıtı şöyle görünebilir. Polling yapmadan önce görev kimliğini saklayın: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
Başarılı bir polling yanıtı şöyle görünebilir. Tamamlanan yanıtlar video_url içerebilir; bazı sağlayıcı formatları modele özel sonuç alanlarını veya bu rota belgelendiğinde video content rotasını kullanır: 
{
  "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"
}

​
Örnek model kayıtları

Bu örnek model katalog yanıtı, /api/models zarf yapısını ve bir video model kaydının şeklini gösterir. Bu, eksiksiz bir model listesi değildir.
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
      }
    }
  ]
}

​
Yaygın hatalar

İş işleyicinizden dönmeden önce oluşturma yanıtındaki kimliği saklayın.
Durum kontrolleri arasına gecikme ve backoff ekleyin.
Seçilen video endpoint’i için belgelenen süre ve çözünürlük alanlarını kullanın.
video_url değerini isteğe bağlı kabul edin ve gerektiğinde modele özel sonuç alanlarına veya content rotasına geri dönün.
Doğruluk kaynağı olarak polling kullanın ve callback URL’nizin POST isteklerini kabul ettiğini doğrulayın.

​
Hata kodları ve yeniden deneme stratejisi

prompt, dosyalar, süre veya boyut alanları düzeltilene kadar yeniden denemeyin.
API anahtarı mevcut ve geçerli olana kadar yeniden denemeyin.
Yeniden denemeden önce görev kimliğini, temel URL’yi, yolu ve model ID’yi kontrol edin.
Yeniden denemeden önce yükleme boyutunu azaltın.
Exponential backoff ile yeniden deneyin ve oluşturma veya polling eşzamanlılığını azaltın.
Görev oluşturmayı backoff ile yeniden deneyin; görev son hata durumuna ulaşmadığı sürece mevcut görevlerde polling yapmaya devam edin.
Uygulama kalıpları için Error codes and retry strategy, Rate limits and concurrency ve Webhook and polling for video generation sayfalarına bakın.

​
Fiyatlandırma ve model dizini

Models page

CometAPI’nin dokümanlarda model ID’leri nasıl sunduğunu okuyun.

Model directory

Model kullanılabilirliğine ve yeteneklerine göz atın.

Fiyatlandırma

Bir modeli çağırmadan önce fiyatlandırmayı kontrol edin.
Last modified on May 28, 2026