Görüntü Durumunu Al

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

import requests

response = requests.get(
    "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    headers={"Authorization": "Bearer sk-your-api-key"}
)

data = response.json()
print(f"Status: {data['status']}")

if data["status"] == "completed":
    print(f"Image URL: {data['data'][0]['url']}")

const response = await fetch(
  'https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
  {
    headers: {
      'Authorization': 'Bearer sk-your-api-key'
    }
  }
);

const data = await response.json();
console.log(`Status: ${data.status}`);

if (data.status === 'completed') {
  console.log(`Image URL: ${data.data[0].url}`);
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": [
    {
      "url": "",
      "revised_prompt": "a beautiful sunset over mountains"
    }
  ]
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "data": [
    {
      "url": "https://cdn.example.com/generated/image-abc123.png",
      "revised_prompt": "a beautiful sunset over mountains with vibrant orange and purple colors"
    }
  ]
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "error": "Content policy violation",
  "data": []
}

Yol Parametreleri

string

gerekli

İ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.Görev artık mevcut değilse veya genel görev kaydında artık bulunmuyorsa TokenLab Task not found or no longer available. mesajıyla async_task_not_found döndürür.

Yanıt

integer

Oluşturulma zamanının Unix zaman damgası.

string

Görev tanımlayıcı.

string

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

array

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’si
revised_prompt (string): Oluşturma için kullanılan istem (prompt)

string

Hata mesajı (yalnızca status değeri failed olduğunda mevcuttur).

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

import requests

response = requests.get(
    "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    headers={"Authorization": "Bearer sk-your-api-key"}
)

data = response.json()
print(f"Status: {data['status']}")

if data["status"] == "completed":
    print(f"Image URL: {data['data'][0]['url']}")

const response = await fetch(
  'https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
  {
    headers: {
      'Authorization': 'Bearer sk-your-api-key'
    }
  }
);

const data = await response.json();
console.log(`Status: ${data.status}`);

if (data.status === 'completed') {
  console.log(`Image URL: ${data.data[0].url}`);
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": [
    {
      "url": "",
      "revised_prompt": "a beautiful sunset over mountains"
    }
  ]
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "data": [
    {
      "url": "https://cdn.example.com/generated/image-abc123.png",
      "revised_prompt": "a beautiful sunset over mountains with vibrant orange and purple colors"
    }
  ]
}

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "error": "Content policy violation",
  "data": []
}

Yoklama (Polling) İçin En İyi Uygulamalar

Önerilen yoklama aralığı: 3-5 saniye. Çoğu görüntü oluşturma görevi, modele ve yönlendirilen sağlayıcı yoluna bağlı olarak 30-120 saniye içinde tamamlanır.

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)
        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}")

Temel

Metin

Dosyalar ve toplu işler

Görseller

Ses ve gerçek zamanlı

Müzik

Video ve materyaller

Worlds

3D

Asenkron işler

Gemini yerel

Yönetim

Görüntü Durumunu Al

Yol Parametreleri

Yanıt

Yoklama (Polling) İçin En İyi Uygulamalar

​Yol Parametreleri

​Yanıt

​Yoklama (Polling) İçin En İyi Uygulamalar

Yol Parametreleri

Yanıt

Yoklama (Polling) İçin En İyi Uygulamalar