Documentación

Referencia de API

Subir imagen de referencia

POST/v1/image-assets

La primera y única parte multipart debe ser file y tener nombre de archivo. Solo JPEG/PNG/WebP no animados, como máximo 10 MiB tanto al subir como tras recodificar.

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

Encabezados de solicitud

  • Idempotency-KeystringObligatorio

    Conserva la intención original con la misma clave; tras una interrupción, consulta recuperación primero. No reenvíes a ciegas estados desconocidos.

    Longitud mínima
    1
    Longitud máxima
    191

Cuerpo de solicitud · multipart/form-data

Tipo
object
Campos obligatorios
file
Propiedades adicionales
false

Cuerpo de solicitud obligatorio

  • filestringObligatorio

    Única parte de imagen con filename; JPEG/PNG/WebP no animado <=10MiB.

    Formato
    "binary"

Respuestas y errores

HTTP 200

Imagen de referencia subida correctamente

application/json

Tipo
object
Campos obligatorios
idmime_typesize_byteswidthheightexpires_at
  • file_idstringOpcional

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

  • idstringObligatorio

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

  • mime_typestringObligatorio

    Tipo MIME verificado del archivo.

  • size_bytesintegerObligatorio

    Tamaño del archivo en bytes.

  • widthintegerObligatorio

    Anchura de imagen en píxeles.

  • heightintegerObligatorio

    Altura de imagen en píxeles.

  • expires_atintegerObligatorio

    Segundos Unix; 0 indica que no hay caducidad fija. La subida se asocia a un archivo gestionado; la lectura exige la misma cuenta y clave.

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