الصور

الحصول على حالة الصورة

الحصول على حالة ونتيجة مهمة إنشاء الصور غير المتزامنة

GET
/v1/tasks/{id}

المسارات الخاصة بالصور /v1/images/generations/{id} و /v1/images/{id} هي نقاط نهاية للتوافق. تظل مدعومة لعمليات التكامل الحالية. عمليات التكامل الجديدة يجب أن تستخدم GET /v1/tasks/{id}؛ راجع الحصول على حالة المهمة.

معاملات المسار (Path Parameters)

idstringpathمطلوب

معرف المهمة الذي تم إرجاعه من طلب إنشاء الصورة الأولي.

استخدم id أو task_id من استجابة الإنشاء.

يقبل الاسم المستعار للتوافق /v1/images/{id} معرفات مهام الصور العامة مثل ldtask_.... وهو يستخدم نفس المصادقة، وفحوصات الملكية، ورؤوس الفوترة، ولقطات الحالة النهائية، وشكل الاستجابة مثل /v1/images/generations/{id}.

قد تُرجع المهمة العامة منتهية الصلاحية أو غير المتاحة الخطأ 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.

الاستجابة (Response)

يتم إرجاع الحقول التي تصف النتائج، والأخطاء، والطوابع الزمنية، والنموذج عندما تكون متاحة للمهمة.

idstring

المعرف القانوني للمهمة غير المتزامنة.

poll_urlstring

رابط الحالة لهذه المهمة. قم بعمل استطلاع (Poll) لـ GET /v1/tasks/{id} باستخدام id.

createdinteger

طابع Unix الزمني للإنشاء.

task_idstring

معرف المهمة.

statusstring

حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، أو failed (فاشلة).

dataarray

مصفوفة الصور التي تم إنشاؤها (يتم ملؤها عندما تكون status هي completed).

يحتوي كل كائن على:

  • url (string): رابط TokenLab لنتيجة الوسائط للصورة التي تم إنشاؤها، صالح لمدة 30 يوماً
  • revised_prompt (string): مراجعة اختيارية للمطالبة (prompt)، عندما يقوم النموذج المختار بإرجاع واحدة
errorstring | object

سبب فشل المهمة (فقط عندما تكون status هي failed): سلسلة نصية، أو كائن يحتوي على message وعند توفره، type و code و param و retryable.

error_detailsobject

تفاصيل الفشل عند فشل المهمة: status و message و type و code و retryable و param عندما يكون هناك خطأ في حقل الطلب.

media_retentionobject

حالة حفظ روابط الصور: days و items[] مع url و kind و status و expires_at. قد يكون هذا الحقل غائباً؛ الروابط ستظل تعمل. راجع الاحتفاظ بالبيانات.

usageobject

عدد الرموز (Tokens) للنماذج المسعرة بالرموز مثل gpt-image-2، عند توفره.

الطلب

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

الاستجابة

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": []
}

الفاصل الزمني للتحقق (Check Interval)

تحقق كل 3–5 ثوانٍ بينما تكون الحالة pending أو processing، وتوقف عند completed أو failed.

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

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات المسار

id*string

معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json