API Reference
المهام
استعلم عن حالة المهام واحصل على الصور المولّدة.
حالات المهام
| الحالة | المعنى | الخطوة التالية |
|---|---|---|
processing | قُبلت المهمة ولم تكتمل بعد. | تابع الاستعلام. |
completed | نجحت المهمة. | اقرأ output.data[].url. |
failed | لم تكتمل المهمة بنجاح. | افحص error؛ ولا تُحتسب رسوم على هذه المهمة. |
استجابة الإرسال
يعيد الإرسال مرجعًا للمهمة:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "processing",
"created_at": 1789970508
}الاستعلام عن المهمة
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"استعلم على فترات معتدلة، كل ثلاث ثوانٍ مثلًا، حتى تصبح قيمة status هي completed أو failed. وانتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل الإنشاء: احتفظ بمعرّف المهمة واستأنف التحقق. ولا تنشئ مهمة أخرى لمعرفة التقدّم.
مثال استعلام كامل
شغّل هذا بعد مثال الإرسال بلغة Python الوارد في البدء السريع. يستخدم المثال task_id المُعاد وينتظر حتى عشر دقائق. وبلوغ هذه المهلة المحلية يوقف الاستعلام فحسب؛ احتفظ بالمعرّف واستأنف الاستعلام عن المهمة نفسها.
import time
print(f"Task ID: {task_id}")
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
result = requests.get(
f"https://api.seedrouter.ai/v1/tasks/{task_id}",
headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
timeout=30,
)
result.raise_for_status()
task = result.json()
if task["status"] == "completed":
for image in task["output"]["data"]:
print(image["url"])
break
if task["status"] == "failed":
raise RuntimeError(task["error"]["message"])
time.sleep(3)
else:
raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")المهمة المكتملة
تعيد المهمة المكتملة روابط الصور المستضافة وبيانات الاستخدام:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "completed",
"created_at": 1789970508,
"finished_at": 1789970538,
"output": {
"created": 1789970532,
"data": [{"url": "https://static.seedrouter.ai/media/tasks/task_example/0.png"}],
"usage": {
"input_tokens": 29,
"output_tokens": 196,
"total_tokens": 225
}
}
}| الحقل | المعنى |
|---|---|
id | احتفظ بهذا المعرّف للاستعلامات اللاحقة. |
status | processing أو completed أو failed. |
created_at، finished_at | طوابع زمنية Unix بالثواني؛ ويكون وقت الاكتمال فارغًا أو صفرًا أثناء المعالجة. |
output.data[].url | روابط الصور المولّدة، وتتوفر عند الاكتمال. |
output.usage | استخدام الرموز المُبلّغ عنه عند توفره. وقد تتضمن كائنات التفاصيل عدد رموز النص والصورة. |
error | خطأ مُهيكل في حال فشل المهمة. |
تسلّم هذه الواجهة النتائج عبر مهام غير متزامنة. وهي ليست بديلًا عن Images SDK المتزامن؛ ولا تدعم stream ولا partial_images.
