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שגיאה מובנית במשימה שנכשלה.

ה-API הזה מספק תוצאות באופן אסינכרוני באמצעות משימות. הוא אינו תחליף ל-Images SDK סינכרוני; stream ו-partial_images אינם נתמכים.