Guía de integración GloopAPI

Integración con SDK

Integra mediante un SDK compatible.

Puedes usar un SDK compatible con OpenAI para los endpoints de texto que realmente admita. Añade /v1 al origen de API para el base_url del SDK; el origen no incluye versión. Los modelos siguen usando ID públicos del catálogo de la clave actual.

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GLOOP_API_KEY"],
    base_url=os.environ["GLOOP_API_BASE"].rstrip("/") + "/v1",
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["GLOOP_MODEL"],
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.GLOOP_API_KEY,
  baseURL: process.env.GLOOP_API_BASE.replace(/\/$/, '') + '/v1',
  maxRetries: 0,
});
const response = await client.chat.completions.create({
  model: process.env.GLOOP_MODEL,
  messages: [{ role: 'user', content: '你好' }],
});
console.log(response.choices[0].message.content);

Los ejemplos desactivan los reintentos automáticos para evitar repetir solicitudes facturables sin confirmación tras una interrupción de red. Actívalos según el contrato de idempotencia de cada endpoint; no supongas que la plataforma deduplica todas las llamadas del SDK.

Endpoints específicos de la plataforma

Usa un cliente HTTP ordinario para cotizaciones de imagen, tareas persistentes, herramientas y archivos. No llames a métodos inexistentes como client.image_tasks.create. Las páginas de endpoints ofrecen ejemplos cURL, requests y fetch y distinguen JSON, multipart, SSE y binario.

Guarda las respuestas de audio como bytes; deja que el cliente genere el boundary multipart al subir imágenes; analiza los streams evento por evento. Envía campos personalizados solo si el endpoint los admite explícitamente. Compatibilidad con el SDK no significa disponibilidad de todas las funciones OpenAI. Lee primero la Guía de streaming y Recuperación asíncrona.