Início rápido para usuários GLM

Instalação e Configuração

Para começar, certifique-se de ter o SDK oficial da OpenAI instalado para sua linguagem. A API utiliza um esquema de autenticação padrão baseado em cabeçalhos. Você deve definir o cabeçalho Authorization para Bearer your-api-key e configurar a URL base para https://api.glmapi.cc/v1. Esta URL funciona com qualquer cliente que suporte o formato Chat Completions da OpenAI.

Não é necessária inicialização especial de cliente além da configuração padrão. O serviço atua como uma substituição pronta para usar para integrações existentes com OpenAI. Você pode verificar sua configuração consultando o endpoint de modelos disponíveis.

Primeira Requisição

Envie uma solicitação simples de conclusão de texto para testar a conectividade. Use o identificador do modelo uncensored para o modelo de linguagem principal. A API aceita parâmetros padrão como max_tokens e temperature.

Esta solicitação retorna uma resposta de texto direta. Se você encontrar um erro 401, verifique sua chave de API. Um erro 402 indica crédito pré-pago insuficiente.

Copiarcurl https://api.glmapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integração com SDK Python

Use a biblioteca oficial Python para interagir com a API. Inicialize o cliente com sua URL base e chave de API. A sintaxe espelha a estrutura padrão do cliente OpenAI.

Esta abordagem permite trocar de provedor sem reescrever a lógica de negócios. O modelo responde a formatos padrão de prompt. Você pode controlar o comprimento e a aleatoriedade da saída por meio de parâmetros padrão.

Copiarfrom openai import OpenAI

client = OpenAI(base_url="https://api.glmapi.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Integração com SDK Node.js

Para ambientes JavaScript, use o SDK Node.js. Configure o baseUrl para apontar para nosso endpoint de API. Isso garante que todas as requisições sejam roteadas corretamente para nossos servidores.

O SDK gerencia retentativas e análise de resposta automaticamente. Você pode passar parâmetros padrão de conclusão. O objeto de resposta contém o texto gerado no local esperado.

Copiarimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapi.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Respostas em Streaming

Ative o streaming definindo o parâmetro stream como true. A API retorna blocos por meio de Server-Sent Events (SSE). Cada bloco contém texto parcial e estatísticas de uso.

Este método reduz a latência percebida para respostas longas. Você pode processar tokens conforme chegam. O último bloco inclui a contagem total de tokens para faturamento.

Copiarstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Limites, Erros e Contexto

A janela de contexto suporta 100.000 tokens no total, com uma saída máxima de 32.000 tokens. Requisições que excedam o limite de corpo de 8 MB falharão. Você está limitado a 300 requisições por minuto e 8 requisições simultâneas por chave.

O erro 401 significa uma chave inválida. O erro 402 indica que não há mais crédito pré-pago. O erro 429 sinaliza limite de requisições atingido. O crédito nunca expira e os erros não consomem tokens. A privacidade é mantida; os prompts não são usados para treinamento.