Claude Opus 5.5 متاح الآن على SeedRouter
SeedRouter Docs
API Reference

المهام

استعلم عن حالة المهام واحصل على الصور المولّدة.

View Markdown

حالات المهام

الحالةالمعنىالخطوة التالية
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احتفظ بهذا المعرّف للاستعلامات اللاحقة.
statusprocessing أو completed أو failed.
created_at، finished_atطوابع زمنية Unix بالثواني؛ ويكون وقت الاكتمال فارغًا أو صفرًا أثناء المعالجة.
output.data[].urlروابط الصور المولّدة، وتتوفر عند الاكتمال.
output.usageاستخدام الرموز المُبلّغ عنه عند توفره. وقد تتضمن كائنات التفاصيل عدد رموز النص والصورة.
errorخطأ مُهيكل في حال فشل المهمة.

تسلّم هذه الواجهة النتائج عبر مهام غير متزامنة. وهي ليست بديلًا عن Images SDK المتزامن؛ ولا تدعم stream ولا partial_images.