Best LLM API Documentação
Guia de início rápido: integração pronta para usar
Integre nossa API LLM sem censura ao seu aplicativo substituindo a URL base e a chave de API no seu código existente compatível com OpenAI.
Pré-requisitos
Antes de fazer sua primeira requisição, certifique-se de ter uma chave de API válida. Cadastre-se na página Obter chave de API para receber sua chave instantaneamente. Nenhum cartão de crédito é necessário para o teste inicial. Você precisará de um ambiente de linguagem de programação suportado (Python 3.8+ ou Node.js 18+) e o SDK oficial da OpenAI instalado no seu projeto.
Nosso serviço atua como uma substituição pronta para usar para endpoints padrão de chat-completions. Você não precisa instalar uma biblioteca de cliente personalizada; o SDK padrão da OpenAI lida com o protocolo de comunicação, incluindo streaming e chamada de ferramentas, desde que você configure a URL base corretamente.
Autenticação
A autenticação é feita por meio do cabeçalho Authorization. Passe sua chave de API como token Bearer. Se a chave for inválida ou expirada, a API retorna um erro 401 Unauthorized. Se o saldo da sua conta for insuficiente, você receberá um erro 402 Payment Required. Adicione sua chave às variáveis de ambiente ou ao arquivo de configuração para evitar codificar as credenciais.
- Cabeçalho:
Authorization: Bearer YOUR_API_KEY - URL base:
https://api.bestllmapi.com/v1
Mantenha sua chave segura. Você pode regenerá-la a qualquer momento no seu painel, o que invalida imediatamente a chave anterior.
Conclusão básica de chat
Envie uma requisição POST para /v1/chat/completions com um ID de model uncensored e o histórico de mensagens. A API retorna uma resposta de texto. Este endpoint suporta estruturas JSON padrão da OpenAI, facilitando a migração de outros provedores.
Certifique-se de estruturar suas mensagens corretamente com funções como system, user e assistant. O modelo processa a entrada e gera uma conclusão com base no contexto do seu prompt.
curl https://api.bestllmapi.com/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."}]
}'
Respostas em streaming
Para experiências em tempo real, ative o streaming definindo stream: true no corpo da requisição. A API retorna um stream de Server-Sent Events (SSE) contendo objetos delta. Cada delta contém um fragmento do texto gerado. Processe esses blocos incrementalmente para exibir o texto conforme é gerado, reduzindo a latência percebida para os usuários finais.
O tratamento do stream é idêntico ao protocolo de streaming padrão da OpenAI. Você deve lidar com o evento de conclusão do stream para saber quando a geração termina.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.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)
Chamada de funções
Defina funções no corpo da requisição usando o parâmetro tools. O modelo pode retornar um objeto de chamada de ferramenta em vez de texto direto. Analise o nome da função e os argumentos, execute a função no seu código e, em seguida, envie os resultados de volta ao modelo para uma resposta final. Isso permite que seu LLM interaja com APIs ou bancos de dados externos dinamicamente.
A chamada de funções segue o esquema padrão da OpenAI. Certifique-se de que suas definições de função sejam precisas para melhorar a precisão do modelo na seleção da ferramenta correta e na extração de argumentos.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.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);
Limites da janela de contexto
O modelo suporta uma janela de contexto de 100.000 tokens, combinando tokens de prompt e de conclusão. Monitore o uso de tokens para evitar exceder esse limite, o que resulta em um erro 400 Bad Request. Se você atingir o limite de 300 requisições por minuto, receberá um erro 429 Too Many Requests.
Implemente backoff exponencial para retries. Os corpos das requisições são limitados a 8 MB. Para conversas longas, considere resumir mensagens anteriores para permanecer dentro do orçamento de tokens enquanto mantém o contexto.
stream = 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)Recursos e limites
Todos os limites e recursos reais da API em um só lugar — confira antes de recarregar.
| Item | Valor |
|---|---|
| Formato | compatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave |
| Autenticação | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| ID do modelo | uncensored |
| Chamada de funções | sim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool |
| Modo JSON | response_format: {"type": "json_object"} |
| Saída máxima | até o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado) |
| Janela de contexto | 100.000 tokens (entrada + saída) |
| Parâmetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sim — server-sent events; o último bloco traz o uso de tokens |
| Concorrência | 8 requisições ao mesmo tempo por chave |
| Limite de taxa | 300 requisições por minuto por chave |
| Tamanho | até 8 MB por requisição |
| Cabeçalhos | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Validade | crédito pago não expira, sem assinatura |
| Bônus | +5% a partir de $50, +10% a partir de $100, +15% a partir de $200 |
| Recarga | USDT (TRC20) ou USDC (Base), qualquer valor inteiro de $20 a $500 |
| Preço | $0,15 por 1M tokens de entrada · $0,50 por 1M de saída |
| Cobrança | crédito pré-pago pelo uso real; erros e recusas são grátis |
| Teste grátis | $0,50 por 7 dias, sem cartão · Chave de teste: 2 requisições paralelas, 60 por minuto; limites totais (8 e 300) após a primeira recarga |
| Chaves | uma chave ativa por conta; uma nova substitui a anterior |
| Conteúdo | conteúdo adulto permitido; conteúdo sexual com menores é recusado |
| Login | Google ou e-mail e senha |
Erros e o que fazer
Erros chegam em JSON com um type fixo; requisições com falha ou recusadas não são cobradas.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais |
401 | missing_key · invalid_key · key_revoked | chave ausente, errada ou substituída |
402 | no_credit | sem crédito — recarregue e continue na hora |
403 | content_blocked | conteúdo sexual com menores — recusado, sem cobrança |
404 | not_found | endpoint desconhecido |
413 | request_too_large | corpo acima de 8 MB |
429 | rate_limited · concurrency | acima de 300/min ou 8 em paralelo — aguarde e tente de novo |
503 | upstream_busy | modelo ocupado — tente em alguns segundos |
Perguntas e respostas
Esta API é compatível com o SDK oficial da OpenAI?
Sim, é totalmente compatível. Você só precisa alterar a URL base e a chave de API na configuração existente do SDK da OpenAI para usar este serviço.
O que acontece se eu exceder o limite de requisições?
A API retorna um erro 429 Too Many Requests. Você deve implementar lógica de retry com backoff exponencial para lidar com isso de forma elegante.
Posso usar esta API para geração de imagens?
Não, esta API oferece apenas conclusões de texto. Ela não suporta endpoints de geração de imagem, áudio ou vídeo.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave, altere a URL base. Essa é toda a configuração.