Attività
Interroga lo stato delle attività e recupera le immagini generate.
Stati delle attività
| Stato | Significato | Passaggio successivo |
|---|---|---|
processing | L'attività è stata accettata e non è ancora conclusa. | Continua il polling. |
completed | L'attività è riuscita. | Leggi output.data[].url. |
failed | L'attività non si è conclusa correttamente. | Esamina error; l'attività non viene addebitata. |
Risposta all'invio
L'invio restituisce un riferimento all'attività:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "processing",
"created_at": 1789970508
}Interrogare l'attività
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Interroga a intervalli moderati, ad esempio ogni tre secondi, finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l'identificativo dell'attività e riprendi il controllo. Non creare un'altra attività per verificare l'avanzamento.
Esempio di polling completo
Esegui questo dopo l'esempio di invio in Python della Guida rapida. Usa il task_id restituito e attende fino a dieci minuti. Raggiungere questa scadenza locale interrompe solo il polling; conserva l'identificativo e riprendi a interrogare la stessa attività.
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}.")Attività completata
Un'attività completata restituisce gli URL delle immagini ospitate e l'utilizzo:
{
"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
}
}
}| Campo | Significato |
|---|---|
id | Conserva questo identificativo per le interrogazioni successive. |
status | processing, completed o failed. |
created_at, finished_at | Timestamp Unix in secondi; durante l'elaborazione l'orario di completamento è assente o zero. |
output.data[].url | URL delle immagini generate, disponibili al completamento. |
output.usage | Utilizzo di token riportato, quando disponibile. Gli oggetti di dettaglio possono contenere il numero di token di testo e immagine. |
error | Errore strutturato per un'attività fallita. |
Questa API consegna i risultati in modo asincrono tramite attività. Non sostituisce un SDK Images sincrono; stream e partial_images non sono supportati.