الصور
الحصول على حالة الصورة
الحصول على حالة ونتيجة مهمة إنشاء الصور غير المتزامنة
المسارات الخاصة بالصور /v1/images/generations/{id} و /v1/images/{id} هي نقاط نهاية للتوافق. تظل مدعومة لعمليات التكامل الحالية. عمليات التكامل الجديدة يجب أن تستخدم GET /v1/tasks/{id}؛ راجع الحصول على حالة المهمة.
معاملات المسار (Path Parameters)
معرف المهمة الذي تم إرجاعه من طلب إنشاء الصورة الأولي.
استخدم id أو task_id من استجابة الإنشاء.
يقبل الاسم المستعار للتوافق /v1/images/{id} معرفات مهام الصور العامة مثل ldtask_.... وهو يستخدم نفس المصادقة، وفحوصات الملكية، ورؤوس الفوترة، ولقطات الحالة النهائية، وشكل الاستجابة مثل /v1/images/generations/{id}.
قد تُرجع المهمة العامة منتهية الصلاحية أو غير المتاحة الخطأ 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.
الاستجابة (Response)
يتم إرجاع الحقول التي تصف النتائج، والأخطاء، والطوابع الزمنية، والنموذج عندما تكون متاحة للمهمة.
المعرف القانوني للمهمة غير المتزامنة.
رابط الحالة لهذه المهمة. قم بعمل استطلاع (Poll) لـ GET /v1/tasks/{id} باستخدام id.
طابع Unix الزمني للإنشاء.
معرف المهمة.
حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، أو failed (فاشلة).
مصفوفة الصور التي تم إنشاؤها (يتم ملؤها عندما تكون status هي completed).
يحتوي كل كائن على:
url(string): رابط TokenLab لنتيجة الوسائط للصورة التي تم إنشاؤها، صالح لمدة 30 يوماًrevised_prompt(string): مراجعة اختيارية للمطالبة (prompt)، عندما يقوم النموذج المختار بإرجاع واحدة
سبب فشل المهمة (فقط عندما تكون status هي failed): سلسلة نصية، أو كائن يحتوي على message وعند توفره، type و code و param و retryable.
تفاصيل الفشل عند فشل المهمة: status و message و type و code و retryable و param عندما يكون هناك خطأ في حقل الطلب.
حالة حفظ روابط الصور: days و items[] مع url و kind و status و expires_at. قد يكون هذا الحقل غائباً؛ الروابط ستظل تعمل. راجع الاحتفاظ بالبيانات.
عدد الرموز (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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json