Guía de integración GloopAPI
Introducción a la integración
Obtén una clave, descubre modelos y envía tu primera solicitud.
GloopAPI ofrece modelos, tareas de generación, herramientas y archivos de resultados mediante una API unificada. Crea primero una clave independiente para tu aplicación y consulta su catálogo disponible; que el sitio muestre un modelo o herramienta no implica que tu clave tenga permiso para llamarlo.
Primera solicitud
Crea una clave en los ajustes de desarrollador de tu cuenta y guárdala en una variable de entorno del servidor. GLOOP_API_BASE es el origen de API del despliegue, sin /v1; los ejemplos web usan la dirección de API configurada actualmente.
export GLOOP_API_BASE="https://api.gloopapi.com"
curl "$GLOOP_API_BASE/v1/models" \
-H "Authorization: Bearer $GLOOP_API_KEY"
Elige un modelo de texto del catálogo devuelto, guárdalo como GLOOP_MODEL y envía una solicitud mínima:
curl "$GLOOP_API_BASE/v1/chat/completions" \
-H "Authorization: Bearer $GLOOP_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"model\":\"$GLOOP_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"
Estos ejemplos explican cómo usar la API. Los modelos disponibles y los precios se determinan mediante el catálogo y las cotizaciones actuales. Leer o copiar la documentación no envía solicitudes.
Elegir un flujo
La generación de texto permite consumir directamente las respuestas. Para imágenes y vídeos persistentes, consulta capacidades, prepara entradas, cotiza y confirma la creación; conserva la clave de solicitud para recuperar la tarea. Las imágenes síncronas y la voz devuelven resultados directamente y no admiten los endpoints de recuperación de tareas persistentes.
Empieza por Autenticación, Selección de modelos e Integración con SDK. Para leer streams, consulta Respuestas en streaming; para recuperar tareas, Tareas asíncronas e idempotencia.
Entradas de API
- Catálogo de modelos: obtén los ID públicos de la clave actual.
- Generación de texto: envía mensajes y consume respuestas síncronas o en streaming.
- Capacidades de imágenes persistentes: descubre modos y tamaños antes de preparar recursos.
- Síntesis de voz: guarda audio binario; la clonación usa endpoints de tareas separados.
- Capacidades de vídeos persistentes: obtén un preset completo y confirma la cotización.
- Catálogo de herramientas: descubre versiones autorizadas y reglas de precios por uso.
- Catálogo de archivos: comprueba el estado de guardado y obtén URL de descarga.
- Crear una respuesta