Görseller
Görüntü Durumunu Al
Asenkron bir görüntü oluşturma görevinin durumunu ve sonucunu alın
Yol Parametreleri
İlk görüntü oluşturma isteğinden döndürülen görev kimliği (task ID).
Eğer oluşturma yanıtı poll_url içeriyorsa, yoklama (polling) için tam olarak bu URL'yi çağırmayı tercih edin. Bazı görüntü görevleri, görüntüye özel durum yolu yerine /v1/tasks/{id} altında bir poll_url sunabilir.
ldtask_... gibi herkese açık görsel görev ID’lerini /v1/images/{id} üzerinden de sorgulayabilirsiniz. Bu uyumluluk alias’ı /v1/images/generations/{id} ile aynı yetkilendirme, ownership kontrolü, faturalama başlıkları, terminal snapshot’ları ve yanıt şeklini kullanır.
Süresi dolmuş veya kullanılamayan bir görev 404 async_task_not_found döndürebilir. Geçerli API anahtarının görev sahipliği doğrulanamazsa yanıt 403 task_not_owned olur.
Yanıt
Sonuç, hata, zaman damgası ve model alanları görev için mevcut olduğunda döndürülür.
Görev tanımlayıcısı.
Oluşturma yanıtı sağladığında tercih edilen yoklama URL’si.
Oluşturulma zamanının Unix zaman damgası.
Görev tanımlayıcı.
Görev durumu: pending, processing, completed veya failed.
Oluşturulan görüntülerin dizisi (status değeri completed olduğunda doldurulur).
Her nesne şunları içerir:
url(string): Oluşturulan görüntünün URL'sirevised_prompt(string): Upstream model raporlarsa sağlayıcıdan gelen isteğe bağlı prompt revizyonu
Hata mesajı (yalnızca status değeri failed olduğunda mevcuttur).
İstek
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Yanıt
{
"created": 1706000000,
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"data": []
}Yoklama (Polling) İçin En İyi Uygulamalar
Durum pending veya processing iken 3–5 saniyede bir sorgulayın; completed veya failed olduğunda durun.
import requests
import time
def poll_image_task(task_id, api_key, max_wait=300, interval=3):
"""Poll for image generation result with timeout."""
url = f"https://api.tokenlab.sh/v1/tasks/{task_id}"
headers = {"Authorization": f"Bearer {api_key}"}
start_time = time.time()
while time.time() - start_time < max_wait:
response = requests.get(url, headers=headers, timeout=30)
response.raise_for_status()
data = response.json()
if data["status"] == "completed":
return data["data"][0]["url"]
elif data["status"] == "failed":
raise Exception(data.get("error", "Generation failed"))
time.sleep(interval)
raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")
# Usage
image_url = poll_image_task("ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sk-your-api-key")
print(f"Generated image: {image_url}")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