Imágenes

Obtener estado de la imagen

Obtenga el estado y el resultado de una tarea asíncrona de generación de imágenes

GET
/v1/tasks/{id}

Las rutas específicas de imágenes /v1/images/generations/{id} y /v1/images/{id} son endpoints de compatibilidad. Se mantienen para integraciones existentes. Las nuevas integraciones deben consultar GET /v1/tasks/{id}; consulte Obtener estado de la tarea.

Parámetros de ruta

idstringpathobligatorio

El ID de la tarea devuelto por la solicitud inicial de generación de imágenes.

Utilice el id o task_id de la respuesta de creación.

El alias de compatibilidad /v1/images/{id} acepta IDs de tareas de imagen públicas como ldtask_.... Utiliza la misma autorización, comprobaciones de propiedad, encabezados de facturación, instantáneas terminales y formato de respuesta que /v1/images/generations/{id}.

Una tarea pública caducada o no disponible puede devolver 404 async_task_not_found. Si no se puede establecer la propiedad de la tarea para la API key actual, la respuesta será 403 task_not_owned.

Respuesta

Los campos que describen resultados, errores, marcas de tiempo y el modelo se devuelven cuando están disponibles para la tarea.

idstring

Identificador canónico de la tarea asíncrona.

poll_urlstring

URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con el id.

createdinteger

Marca de tiempo Unix de creación.

task_idstring

El identificador de la tarea.

statusstring

Estado de la tarea: pending, processing, completed o failed.

dataarray

Matriz de imágenes generadas (se completa cuando el status es completed).

Cada objeto contiene:

  • url (string): URL de resultado multimedia de TokenLab de la imagen generada, válida por 30 días
  • revised_prompt (string): Revisión opcional del prompt, cuando el modelo seleccionado devuelve una
errorstring | object

Razón por la que falló la tarea (solo cuando el status es failed): una cadena, o un objeto con message y, cuando se conoce, type, code, param y retryable.

error_detailsobject

Detalles del fallo cuando la tarea falló: status, message, type, code, retryable y param cuando un campo de la solicitud es el causante.

media_retentionobject

Estado de guardado de los enlaces de imagen: days e items[] con url, kind, status y expires_at. Puede estar ausente; los enlaces siguen funcionando. Consulte Retención de datos.

usageobject

Recuento de tokens para modelos con precios basados en tokens, como gpt-image-2, cuando esté disponible.

Solicitud

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Respuesta

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": []
}

Intervalo de consulta

Consulte cada 3–5 segundos mientras el estado sea pending o processing, y deténgase cuando sea completed o 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}")

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

id*string

El ID de tarea asíncrona devuelto por id / task_id, o incrustado en poll_url

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json