الحصول على حالة المهمة

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

نظرة عامة

استخدم نقطة النهاية هذه للاستطلاع غير المتزامن الموحّد عبر أنواع المهام مثل إنشاء الفيديو والصورة والموسيقى و3D. إذا كانت استجابة الإنشاء تتضمن poll_url، فاستدعِ ذلك المسار نفسه تمامًا. بالنسبة لسير العمل غير المتزامن الأحدث، قد يشير poll_url إلى /v1/tasks/{id}.

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

string

مطلوب

معرّف المهمة المُعاد من طلب الإنشاء.

الاستجابة

string

معرّف المهمة.

string

اسم مستعار لمعرّف المهمة غير المتزامنة.

string

عنوان URL المفضل للاستعلام عندما توفره استجابة الإنشاء.

string

حالة المهمة مثل pending أو processing أو completed أو failed. يتم تمثيل المهام الملغاة كـ failed مع cancelled: true.

boolean

true عندما يتم إلغاء مهمة غير متزامنة في قائمة الانتظار قبل التنفيذ.

string

مؤشر الإلغاء. يظهر كـ cancelled عند نجاح الإلغاء.

array

بالنسبة لمهام الصور المكتملة، تُعاد نتائج الصور التي تم إنشاؤها هنا. تعيد مهام الصور روابط URL في data[].url.

number

قيمة تقدم اختيارية. لا تُعاد إلا عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد اكتمال المهمة.

string

URL الأصل الناتج عند اكتمال المهمة وإنتاج فيديو.

string

رسالة الخطأ عند فشل المهمة.

سلوك الخطأ

إذا لم تعد المهمة موجودة، أو انتهت صلاحيتها، أو تعذر حلها عبر عقد المهمة غير المتزامنة العام، فستعيد TokenLab:

{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

أمثلة

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

Python

import requests

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

JavaScript

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

الأساسيات

النص

الملفات والدفعات

الصور

الصوت والوقت الفعلي

الموسيقى

الفيديو والمواد

Worlds

3D

المهام غير المتزامنة

Gemini الأصلي

الإدارة

الحصول على حالة المهمة

نظرة عامة

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

الاستجابة

سلوك الخطأ

أمثلة

​نظرة عامة

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

​الاستجابة

​سلوك الخطأ

​أمثلة

نظرة عامة

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

الاستجابة

سلوك الخطأ

أمثلة