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

API Reference

المهام

View Markdown

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

يعيد GET /v1/tasks/{id} جميع مهام الصور والفيديو والصوت، وSeedance أيضًا.

حالات المهام

الحالةالمعنىالخطوة التالية
processingقُبلت المهمة ولم تكتمل بعد.تابع الاستعلام.
completedنجحت المهمة.اقرأ النتيجة في output.
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.video_urlرابط الفيديو المولّد، لمهام الفيديو.
output.urlرابط ملف المخرجات، لمهام Whisper-1.
output.usageاستخدام الرموز المُبلّغ عنه عند توفره. وقد تتضمن كائنات التفاصيل عدد رموز النص والصورة.
errorخطأ مُهيكل في حال فشل المهمة.

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