Aufgaben
Aufgabenstatus abfragen und erzeugte Bilder abrufen.
Aufgabenstatus
| Status | Bedeutung | Nächster Schritt |
|---|---|---|
processing | Die Aufgabe wurde angenommen und ist noch nicht abgeschlossen. | Weiter abfragen. |
completed | Die Aufgabe war erfolgreich. | output.data[].url auslesen. |
failed | Die Aufgabe wurde nicht erfolgreich abgeschlossen. | error prüfen; die Aufgabe wird nicht berechnet. |
Antwort beim Senden
Beim Senden wird eine Aufgabenreferenz zurückgegeben:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "processing",
"created_at": 1789970508
}Aufgabe abfragen
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Frag in einem maßvollen Abstand ab, etwa alle drei Sekunden, bis status den Wert completed oder failed hat. Eine Zeitüberschreitung des Netzwerks während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist: Behalte die Aufgaben-ID und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.
Vollständiges Abfragebeispiel
Führe dies nach dem Python-Beispiel zum Senden im Schnellstart aus. Es verwendet die zurückgegebene task_id und wartet bis zu zehn Minuten. Wird diese lokale Frist erreicht, endet lediglich die Abfrage; behalte die ID und frag dieselbe Aufgabe weiter ab.
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}.")Abgeschlossene Aufgabe
Eine abgeschlossene Aufgabe gibt gehostete Bild-URLs und die Nutzung zurück:
{
"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
}
}
}| Feld | Bedeutung |
|---|---|
id | Bewahre diese ID für spätere Abfragen auf. |
status | processing, completed oder failed. |
created_at, finished_at | Unix-Zeitstempel in Sekunden; während der Verarbeitung ist der Abschlusszeitpunkt nicht gesetzt oder null. |
output.data[].url | URLs der erzeugten Bilder, nach Abschluss verfügbar. |
output.usage | Gemeldete Token-Nutzung, sofern verfügbar. Detailobjekte können Token-Zahlen für Text und Bild enthalten. |
error | Strukturierter Fehler bei einer fehlgeschlagenen Aufgabe. |
Diese API liefert Ergebnisse asynchron über Aufgaben. Sie ist kein Ersatz für ein synchrones Images-SDK; stream und partial_images werden nicht unterstützt.