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 | שגיאה מובנית במשימה שנכשלה. |
ה-API הזה מספק תוצאות באופן אסינכרוני באמצעות משימות. הוא אינו תחליף ל-Images SDK סינכרוני; stream ו-partial_images אינם נתמכים.
