Video ve materyaller
Video Durumunu Al
Bir video görevinin durumunu ve sonucunu alın
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
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.
Görev kimliği.
id ile aynı görev kimliği.
Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.
Ödeme sonrası faturalandırma işlem kimliği. Görev kimliğinden farklıdır.
Görev durumu: pending, processing, completed, failed.
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.
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.
return_last_frame ile talep ettiğinizde ve model desteklediğinde, oluşturulan son karenin URL'si.
Mevcut olduğunda url, duration, width ve height bilgilerini içeren tek video sonucu.
Görev birden fazla çıktı döndürdüğünde çoklu video sonuçları.
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.
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.
Oluşturulma zaman damgası.
Son güncelleme zaman damgası.
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.502veya503 media_unavailable: sonuç hala kaydediliyor veya TokenLab meşgul.Retry-Aftergecikmesinden sonra tekrar deneyin.- Dosya yerine kayıt durumunu okumak için URL'ye
metadata=trueekleyin.
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
failedolduğunda durun ve döndürülenerrorbilgisini 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 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 / 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