Imagens
Obter Status da Imagem
Obtenha o status e o resultado de uma tarefa assíncrona de geração de imagem
Os caminhos específicos de imagem /v1/images/generations/{id} e /v1/images/{id} são endpoints de compatibilidade. Eles permanecem suportados para integrações existentes. Novas integrações devem consultar GET /v1/tasks/{id}; veja Obter Status da Tarefa.
Parâmetros de Caminho
O ID da tarefa retornado da solicitação inicial de geração de imagem.
Use o id ou task_id da resposta de criação.
O alias de compatibilidade /v1/images/{id} aceita IDs de tarefas de imagem públicas, como ldtask_.... Ele utiliza a mesma autorização, verificações de propriedade, cabeçalhos de faturamento, snapshots de terminal e formato de resposta que /v1/images/generations/{id}.
Uma tarefa pública expirada ou indisponível pode retornar 404 async_task_not_found. Se a propriedade da tarefa não puder ser estabelecida para a chave de API atual, a resposta será 403 task_not_owned.
Resposta
Campos que descrevem resultados, erros, carimbos de data/hora (timestamps) e o modelo são retornados quando disponíveis para a tarefa.
Identificador canônico da tarefa assíncrona.
URL de status para esta tarefa. Consulte GET /v1/tasks/{id} com o id.
Timestamp Unix da criação.
O identificador da tarefa.
Status da tarefa: pending, processing, completed ou failed.
Array de imagens geradas (preenchido quando o status é completed).
Cada objeto contém:
url(string): URL de resultado de mídia da TokenLab da imagem gerada, válida por 30 diasrevised_prompt(string): Revisão opcional do prompt, quando o modelo selecionado retorna uma
Motivo da falha da tarefa (apenas quando o status é failed): uma string ou um objeto com message e, quando conhecido, type, code, param e retryable.
Detalhes da falha quando a tarefa falha: status, message, type, code, retryable e param quando um campo da solicitação está incorreto.
Status de salvamento dos links de imagem: days e items[] com url, kind, status e expires_at. Pode estar ausente; os links continuam funcionando. Veja Retenção de dados.
Contagem de tokens para modelos precificados por token, como gpt-image-2, quando disponível.
Requisição
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Resposta
{
"created": 1706000000,
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"data": []
}Intervalo de Verificação
Verifique a cada 3–5 segundos enquanto o status for pending ou processing, e pare quando estiver em completed ou failed.
import requests
import time
def poll_image_task(task_id, api_key, max_wait=300, interval=3):
"""Poll for image generation result with timeout."""
url = f"https://api.tokenlab.sh/v1/tasks/{task_id}"
headers = {"Authorization": f"Bearer {api_key}"}
start_time = time.time()
while time.time() - start_time < max_wait:
response = requests.get(url, headers=headers, timeout=30)
response.raise_for_status()
data = response.json()
if data["status"] == "completed":
return data["data"][0]["url"]
elif data["status"] == "failed":
raise Exception(data.get("error", "Generation failed"))
time.sleep(interval)
raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")
# Usage
image_url = poll_image_task("ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sk-your-api-key")
print(f"Generated image: {image_url}")Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
O ID da tarefa assíncrona retornado por id / task_id, ou incorporado na poll_url
Resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json