Tarefas
Consulte o estado das tarefas e recupere as imagens geradas.
Estados da tarefa
| Estado | Significado | Próximo passo |
|---|---|---|
processing | A tarefa foi aceita e ainda não terminou. | Continue consultando. |
completed | A tarefa foi concluída com sucesso. | Leia output.data[].url. |
failed | A tarefa não foi concluída com sucesso. | Verifique error; a tarefa não é cobrada. |
Resposta do envio
O envio retorna uma referência de tarefa:
{
"id": "task_...",
"model": "gpt-image-2",
"status": "processing",
"created_at": 1789970508
}Consultar a tarefa
curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Consulte em um intervalo moderado, por exemplo a cada três segundos, até que status seja completed ou failed. Um tempo limite de rede durante a consulta não significa que a geração falhou: guarde o identificador da tarefa e retome a verificação. Não crie outra tarefa para acompanhar o progresso.
Exemplo completo de consulta
Execute isto após o exemplo de envio em Python do Início rápido. Ele usa o task_id retornado e aguarda até dez minutos. Atingir esse prazo local apenas encerra a consulta; guarde o identificador e retome a consulta da mesma tarefa.
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}.")Tarefa concluída
Uma tarefa concluída retorna as URLs das imagens hospedadas e o 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 | Guarde este identificador para consultas posteriores. |
status | processing, completed ou failed. |
created_at, finished_at | Marcas de tempo Unix em segundos; durante o processamento o horário de conclusão fica vazio ou zero. |
output.data[].url | URLs das imagens geradas, disponíveis na conclusão. |
output.usage | Uso de tokens informado, quando disponível. Objetos de detalhe podem conter a contagem de tokens de texto e imagem. |
error | Erro estruturado em uma tarefa que falhou. |
Esta API entrega os resultados de forma assíncrona por tarefas. Ela não substitui um SDK de Images síncrono; stream e partial_images não são aceitos.