Documentación

Referencia de API

Obtener cotización de imagen persistente

POST/v1/image-quotes

Solo valida entradas y permisos; no bloquea imágenes. Cotización válida 60 segundos; crear revalida ruta/precio/solicitud. Interruptor de servicio apagado devuelve 503.

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

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
modelpromptsize
Propiedades adicionales
false

Cuerpo de solicitud obligatorio

  • modelstringObligatorio

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

    Longitud máxima
    191
  • promptstringObligatorio

    No vacío, máximo 32000 bytes UTF-8; maxLength de OpenAPI cuenta caracteres, por eso no se inventa un máximo de caracteres.

  • sizestringObligatorio

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

  • nintegerOpcional

    Omitido o 0 se normaliza a 1. Límite real: max_n de image-models; el máximo global no es capacidad del modelo.

    Valor predeterminado
    1
    Mínimo
    1
    Máximo
    6
  • referencesarrayOpcional

    En cada elemento, solo uno de file_id, asset_id o url; cantidad según max_references.

    Máximo de elementos
    14
    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

    Tarea de origen opcional de la misma clave, solo para trazabilidad; no sustituye references.

    Longitud máxima
    64
  • quote_idstringOpcional

    Al crear debe ser una cotización válida y coincidente con la solicitud; se ignora al cotizar.

Respuestas y errores

HTTP 200

Cotización de imagen persistente obtenida correctamente

application/json

Tipo
object
Campos obligatorios
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
  • pricing_notestringObligatorio

    Descripción del precio del modelo; liquidación final según medición confirmada.

  • idstringObligatorio

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

  • expires_atintegerObligatorio

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

  • reserved_quotaintegerObligatorio

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

  • estimated_costnumberObligatorio

    Cargo de venta estimado en la moneda cotizada.

  • currencystringObligatorio

    Moneda de cotización/facturación.

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