Documentación

Referencia de API

Consultar historial de imágenes persistentes

GET/v1/image-tasks

Historial de la misma clave, 20 elementos por página, cursor devuelto por el servicio; sigue comprobando la autorización actual del modelo.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de consulta

  • cursorstringOpcional

    next_cursor de la respuesta original; no lo compongas.

  • qstringOpcional

    Búsqueda de prompt, máximo 256 bytes UTF-8.

  • statusstringOpcional

    Filtro exacto: queued/dispatching/running/succeeded/partial_succeeded/failed/unknown.

    Enumeración
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown"]

Respuestas y errores

HTTP 200

Historial de imágenes persistentes consultado correctamente

application/json

Tipo
object
Campos obligatorios
datanext_cursor
  • dataarrayObligatorio

    Matriz de datos de página/catálogo actual.

    Campos secundarios de data (1)
    • []objectOpcional
      Campos secundarios de [] (17)
      • modelstringObligatorio

        ID público de modelo del catálogo de la clave actual.

      • promptstringObligatorio

        Prompt de generación.

      • sizestringObligatorio

        Tamaño devuelto por image-models seleccionado; capacidades y tamaños se validan por modelo.

      • nintegerObligatorio

        Cantidad solicitada de imágenes, sujeta al máximo del modelo.

      • referencesarrayObligatorio

        Lista de imágenes de referencia para generar.

        Campos secundarios de references (1)
        • []objectOpcional
          Campos secundarios de [] (3)
          • file_idstringOpcional

            ID público de archivo gestionado de la misma cuenta y clave.

          • asset_idstringOpcional

            ID de recurso subido de la misma cuenta y clave.

          • urlstringOpcional

            URL HTTPS pública; no admite userinfo ni fragment y está sujeta a comprobaciones SSRF.

            Formato
            "uri"
          Rama oneOf 1

          Obligatorio en esta rama: file_id

          Rama oneOf 2

          Obligatorio en esta rama: asset_id

          Rama oneOf 3

          Obligatorio en esta rama: url

      • source_task_idstringOpcional

        ID público de tarea de origen, solo para trazabilidad.

      • quote_idstringOpcional

        ID público de cotización; debe coincidir con precio y solicitud al crear.

      • idstringObligatorio

        Identificador público del objeto, usado en su ruta de detalles.

      • statusstringObligatorio

        unknown no se reenvía automáticamente; el cargo reservado puede seguir pending.

        Enumeración
        ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
      • created_atintegerObligatorio

        Fecha de creación en segundos Unix.

      • updated_atintegerObligatorio

        Última actualización en segundos Unix.

      • reserved_quotaintegerObligatorio

        Reserva en unidades quota de la plataforma, no en USD.

      • final_quotaintegerObligatorio

        Cargo final en unidades quota de la plataforma; null indica que aún no se ha determinado.

      • billing_statusstringObligatorio

        Estado de reserva/liquidación/devolución; compruébalo aparte de tarea y archivado.

      • error_codestringOpcional

        Código público de error para decisiones de flujo.

      • error_messagestringOpcional

        Descripción para usuario mediante clasificación pública de errores.

      • resultsarrayObligatorio

        Elementos generados; archivado independiente por elemento.

        Campos secundarios de results (1)
        • []objectOpcional
          Campos secundarios de [] (7)
          • file_idstringOpcional

            ID público de archivo gestionado de la misma cuenta y clave.

          • storage_statusstringOpcional

            Estado de archivado; descarga gestionada garantizada solo tras ready.

          • storage_errorstringOpcional

            Categoría pública de fallo de archivado.

          • expires_atintegerOpcional

            Caducidad en segundos Unix; 0 indica que no hay caducidad fija.

          • urlstringOpcional

            URL de acceso al resultado o referencia; firmadas solo válidas temporalmente.

          • b64_jsonstringOpcional

            Cadena Base64 de imagen; no la solicites como URL.

          • revised_promptstringOpcional

            Prompt revisado devuelto por el servicio, si existe.

  • next_cursorstringObligatorio

    Cursor siguiente; úsalo sin cambios en la paginación de este endpoint. Vacío indica última página.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error