Documentación

Referencia de API

Generar imágenes síncronas

POST/v1/images/generations

La generación síncrona valida parámetros por modelo y solo admite capacidades del modelo seleccionado. Qwen: máximo 6 imágenes/3 referencias; Ark según modelo; Venice genera una desde texto y no admite referencias. Los archivos ordinarios siguen retención por días, distinta de tareas de imagen persistentes.

Límites de la salida síncrona

Qwen admite hasta 6 salidas y 3 referencias; los límites de Ark varían por modelo, y Venice solo genera una imagen desde texto. Elige primero el modelo y envía sus campos correspondientes; no envíes referencias a modelos que no las admitan.

Si necesitas confirmación de cotización, historial duradero y recuperación tras desconexión, usa imágenes persistentes en vez de repetir automáticamente la generación síncrona. Los encabezados de archivado solo describen el guardado. La retención de archivos ordinarios es distinta de la protección por referencias de tareas; consulta Facturación.

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
modelprompt

Cuerpo de solicitud obligatorio

  • image_urlsarrayOpcional

    Lista de URL de referencias según modelo; Qwen/Ark tienen límites propios, Venice síncrono de texto a imagen rechaza este campo.

    Campos secundarios de image_urls (1)
    • []stringOpcional
  • modelstringObligatorio

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

  • promptstringObligatorio

    Prompt de generación.

  • nintegerOpcional

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

  • sizestringOpcional

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

  • response_formatstringOpcional

    Formato de salida según modelo; no supongas soporte de todos los formatos.

  • userunknownOpcional

    Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

  • extra_bodyunknownOpcional

    Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

Respuestas y errores

HTTP 200

Imágenes síncronas generadas correctamente

application/json

Tipo
object
Campos obligatorios
createddata
  • createdintegerObligatorio

    Fecha de generación de la respuesta de imagen en segundos Unix.

  • dataarrayObligatorio

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

    Campos secundarios de data (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.

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