Tareas
Sondea el estado de las tareas y recupera las imágenes generadas.
Estados de tarea
| Estado | Significado | Siguiente paso |
|---|---|---|
processing | La tarea se ha aceptado y aún no ha terminado. | Sigue sondeando. |
completed | La tarea se completó correctamente. | Lee output.data[].url. |
failed | La tarea no se completó correctamente. | Revisa error; la tarea no se cobra. |
Respuesta al enviar
El envío devuelve una referencia de tarea:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "processing",
"created_at": 1789970508
}Sondear la tarea
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Sondea a un ritmo moderado, por ejemplo cada tres segundos, hasta que status sea completed o failed. Que se agote el tiempo de red durante el sondeo no significa que la generación haya fallado: conserva el identificador de tarea y reanuda la comprobación. No crees otra tarea para consultar el progreso.
Ejemplo completo de sondeo
Ejecuta esto después del ejemplo de envío en Python de la Guía rápida. Usa el task_id devuelto y espera hasta diez minutos. Alcanzar este plazo local solo detiene el sondeo; conserva el identificador y reanuda la consulta de la misma tarea.
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}.")Tarea completada
Una tarea completada devuelve las URL de las imágenes alojadas y el uso:
{
"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 | Significado |
|---|---|
id | Conserva este identificador para consultas posteriores. |
status | processing, completed o failed. |
created_at, finished_at | Marcas de tiempo Unix en segundos; la hora de finalización está vacía o es cero mientras se procesa. |
output.data[].url | URL de las imágenes generadas, disponibles al completarse. |
output.usage | Uso de tokens informado, cuando está disponible. Los objetos de detalle pueden incluir el número de tokens de texto e imagen. |
error | Error estructurado en una tarea fallida. |
Esta API entrega los resultados de forma asíncrona mediante tareas. No sustituye a un SDK de Images síncrono; stream y partial_images no son compatibles.