Documentação dos Endpoints Compatíveis com OpenAI

Autenticação e URL Base

Come gerando sua chave de API via painel usando sua conta Google ou e-mail. Adicione esta chave a cada cabeçalho de solicitação como Authorization: Bearer YOUR_API_KEY. A URL base é https://api.openaicompatibleendpoints.com/v1, garantindo que o código do seu cliente existente funcione sem modificações. Você recebe uma chave ativa por conta, que pode ser regenerada instantaneamente se comprometida. Nenhum número de telefone é necessário para o cadastro, mantendo o processo rápido e privado.

Primeira solicitação

Envie uma solicitação padrão de conclusão de chat para começar a gerar texto imediatamente. Isso confirma que suas credenciais e saldo de token estão ativos antes de escalar seu fluxo de trabalho. O endpoint aceita payloads JSON padrão idênticos ao formato da OpenAI, permitindo que você teste a conectividade com sobrecarga mínima.

Copycurl https://api.openaicompatibleendpoints.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current server time in UTC format"}]
  }'

Integração do SDK Python

Instale o pacote oficial da OpenAI para Python e aponte-o para nossa URL base para aproveitar padrões familiares. Essa abordagem funciona perfeitamente com ferramentas como LangChain ou LlamaIndex, que esperam endpoints compatíveis com OpenAI. Você pode alternar modelos ou provedores simplesmente atualizando a configuração da URL base sem alterar a lógica do seu aplicativo. Essa flexibilidade é crítica para agências que gerenciam múltiplos pipelines de inferência.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openaicompatibleendpoints.com/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)

Uso do SDK Node

Inicialize o cliente Node.js com sua URL base e chave da API para iniciar solicitações de streaming ou síncronas. Esta configuração espelha a interface padrão do cliente OpenAI, facilitando a integração em aplicações Express ou Fastify. Você pode tratar erros elegantemente verificando os códigos de status retornados pelo servidor, garantindo que sua aplicação permaneça robusta durante o uso de alto volume.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openaicompatibleendpoints.com/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 (SSE)

Habilite o streaming definindo o stream parâmetro para true, que retorna dados em tempo real via Server-Sent Events. Isso reduz a latência percebida para os usuários finais, especialmente ao gerar respostas longas ou cadeias de raciocínio complexas. Cada chunk contém conteúdo parcial, permitindo que você renderize o texto progressivamente na sua interface. O último chunk inclui as estatísticas completas de uso de tokens para rastreamento preciso de cobranças.

Copystream = 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

Sua chave de API suporta até 300 solicitações por minuto e permite 8 conexões simultâneas. Se você exceder esses limites, o servidor retornará o código de status 429; fundos insuficientes acionarão um erro 402, enquanto chaves inválidas resultarão em 401. O modelo suporta uma janela de contexto de 100.000 tokens, combinando prompt e conclusão. Erros e recusas não consomem seu crédito pré-pago, garantindo que você pague apenas por inferências válidas.