Video ve materyaller

Video Durumunu Al

Bir video görevinin durumunu ve sonucunu alın

GET
/v1/tasks/{id}

GET /v1/videos/generations/{id} bir uyumluluk uç noktasıdır. Mevcut entegrasyonlar için desteklenmeye devam eder ve sonucu GET /v1/tasks/{id} ile aynı formatta döndürür. Yeni entegrasyonlar GET /v1/tasks/{id} uç noktasını sorgulamalıdır; bkz. Görev Durumunu Al.

Yol Parametreleri

idstringpathzorunlu

Video oluşturma isteği tarafından döndürülen görev kimliği (ID). id ve task_id aynı görevi tanımlar.

Görev başarısız olsa bile durum okuma işlemi HTTP 200 döndürür; status alanını kontrol edin. Süresi dolmuş veya kullanılamayan bir görev 404 async_task_not_found döndürür. Çalışma alanınıza ait olmayan bir görev 403 task_not_owned döndürür. 503 async_task_owner_unavailable geçicidir: isteği yeniden deneyin.

Yanıt

Sonuçları, hataları, zaman damgalarını ve modeli açıklayan alanlar, görev için mevcut olduklarında döndürülür.

idstring

Görev kimliği.

task_idstring

id ile aynı görev kimliği.

poll_urlstring

Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.

billing_transaction_idstring

Ödeme sonrası faturalandırma işlem kimliği. Görev kimliğinden farklıdır.

statusstring

Görev durumu: pending, processing, completed, failed.

progressinteger

0 ile 100 arasında isteğe bağlı ilerleme durumu. Yalnızca gerçek bir ilerleme değeri mevcut olduğunda döndürülür; tamamlanma durumunu belirlemek için status alanını kullanın.

video_urlstring

Oluşturulan videonun URL'si (tamamlandığında). Bu, 30 gün boyunca geçerli kalan bir TokenLab medya sonucu URL'sidir; bkz. Sonucu İndir. Başarısız olan ve tamamlanmamış görevler video URL'si döndürmez.

last_frame_urlstring

return_last_frame ile talep ettiğinizde ve model desteklediğinde, oluşturulan son karenin URL'si.

videoobject

Mevcut olduğunda url, duration, width ve height bilgilerini içeren tek video sonucu.

videosarray

Görev birden fazla çıktı döndürdüğünde çoklu video sonuçları.

errorstring | object

Görevin neden başarısız olduğu (yalnızca status değeri failed olduğunda): bir metin dizisi veya message içeren bir nesne; biliniyorsa type, code, param ve retryable alanlarını da içerir. Başarısız bir görev error_details da taşıyabilir; bkz. Asenkron işler ve sorgulama.

media_retentionobject

Videonun kayıt durumu: her biri url, kind, status ve expires_at içeren days ve items. Durum zamanında bilinmediğinde mevcut olmayabilir; URL yine de çalışır.

createdinteger

Oluşturulma zaman damgası.

updatedinteger

Son güncelleme zaman damgası.

modelstring

Görev için kullanılan model.

İstek

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Yanıt

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000,
  "updated": 1706000000
}

Sonucu İndir

video_url şu şekildedir: https://api.tokenlab.sh/v1/media-results/{id}.mp4?token=…. URL içindeki token kimlik bilgisi olduğundan, Authorization başlığına gerek yoktur. URL'yi yalnızca videoyu görmesi gereken kişilerle paylaşın. URL dosyaya yönlendirme yapar, bu nedenle indirirken yönlendirmeleri takip edin (curl -L).

  • Sonuç ilk kaydedildiği andan itibaren 30 gün boyunca geçerlidir. Daha uzun süre ihtiyacınız varsa dosyayı indirin; bkz. Veri saklama.
  • 404 media_not_found: token veya dosya uzantısı sonuçla eşleşmiyor. Aldığınız tam URL'yi kullanın.
  • 410 media_expired: 30 günlük süre dolmuştur.
  • 502 veya 503 media_unavailable: sonuç hala kaydediliyor veya TokenLab meşgul. Retry-After gecikmesinden sonra tekrar deneyin.
  • Dosya yerine kayıt durumunu okumak için URL'ye metadata=true ekleyin.

Bazı sonuçlar https://api.tokenlab.sh/v1/videos/generations/{id}/content olarak iletilir. Bu URL, sorgulama için kullandığınız Authorization: Bearer başlığının aynısını gerektirir ve yalnızca görevin sahibi olan çalışma alanı açabilir.

Kontrol Aralığı

  • Her 5–10 saniyede bir kontrol edin.
  • Uzun süren görevler için aralığı artırın.
  • Uygulamanız için maksimum bir bekleme süresi belirleyin.
  • Durum failed olduğunda durun ve döndürülen error bilgisini gösterin.
import requests
import time

def wait_for_video(task_id, max_wait=600, interval=5):
    """Zaman aşımı ile video bekleme."""
    start = time.time()

    while time.time() - start < max_wait:
        response = requests.get(
            f"https://api.tokenlab.sh/v1/tasks/{task_id}",
            headers={"Authorization": "Bearer sk-your-api-key"}
        )
        response.raise_for_status()
        data = response.json()

        if data["status"] == "completed":
            return data["video_url"]
        elif data["status"] == "failed":
            raise Exception(data.get("error", "Video oluşturma başarısız oldu"))

        time.sleep(interval)

    raise TimeoutError("Video oluşturma zaman aşımına uğradı")

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

id*string

id / task_id tarafından döndürülen veya poll_url içine gömülü olan asenkron görev kimliği

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json