Guia de integração GloopAPI

Integração com SDK

Integre usando um SDK compatível.

Use um SDK compatível com OpenAI para os endpoints de texto que ele realmente suporta. Acrescente /v1 à origem da API para o base_url do SDK; a origem não inclui versão. Modelos continuam usando IDs públicos do catálogo da chave atual.

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);

Os exemplos desativam novas tentativas automáticas para evitar repetir solicitações cobráveis sem confirmação após interrupções de rede. Ative-as conforme o contrato de idempotência de cada endpoint; não presuma que a plataforma deduplica todas as chamadas do SDK.

Endpoints específicos da plataforma

Use um cliente HTTP comum para cotações de imagem, tarefas persistentes, ferramentas e arquivos. Não chame métodos inexistentes, como client.image_tasks.create. As páginas de endpoints oferecem exemplos cURL, requests e fetch e distinguem JSON, multipart, SSE e binário.

Salve respostas de áudio como bytes; deixe o cliente gerar o boundary multipart ao enviar imagens; analise streams evento por evento. Envie campos personalizados somente quando o endpoint os aceitar explicitamente. Compatibilidade com SDK não significa disponibilidade de todas as funções OpenAI. Leia primeiro o Guia de streaming e Recuperação assíncrona.

Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.