BestPrivateAI API — referência

Um endpoint compatível com OpenAI, um modelo, uma chave. Se seu código já conversa com /v1/chat/completions, troque a URL base e a chave e ele vai conversar com a gente.

URL base e autenticação

Base URL:  https://api.bestprivateai.com/v1
Header:    Authorization: Bearer sk-…

As chaves são criadas em a página de chaves. Uma chave é exibida uma única vez, na criação; guardamos um hash e os últimos seis caracteres. Envie-a somente via HTTPS e somente no cabeçalho Authorization — nunca em uma URL.

Tudo é JSON (Content-Type: application/json). As respostas usam o schema da OpenAI, então os SDKs oficiais da openai e qualquer cliente compatível com OpenAI funcionam sem alterações.

Modelos

GET /v1/models

{ "object": "list",
  "data": [ { "id": "notrack-uncensored", "object": "model", "owned_by": "notrack" } ] }

Há um modelo, notrack-uncensored: nosso próprio ajuste de companheiro de conversa, servido em nosso próprio hardware. O que você passar em model é roteado para ele; use o id público para que seus logs correspondam aos nossos.

Chat completions

POST /v1/chat/completions

{
  "model": "notrack-uncensored",
  "messages": [
    { "role": "system",    "content": "You are Mira, a wry bartender in 1920s Berlin." },
    { "role": "user",      "content": "Evening. What's good tonight?" }
  ],
  "max_tokens": 400,
  "temperature": 0.9
}

Resposta — o formato padrão, com contagens reais de tokens em usage (é isso que é cobrado):

{
  "id": "chatcmpl-…", "object": "chat.completion", "model": "notrack-uncensored",
  "choices": [ { "index": 0, "finish_reason": "stop",
                 "message": { "role": "assistant", "content": "…" } } ],
  "usage": { "prompt_tokens": 41, "completion_tokens": 118, "total_tokens": 159 }
}

Streaming

Defina "stream": true e leia os server-sent events, exatamente como na OpenAI. O último bloco traz usage (nós sempre incluímos, quer você peça stream_options ou não), depois data: [DONE].

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Ev"}}]}
data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"ening"}}]}
…
data: {"id":"chatcmpl-…","object":"chat.completion.chunk","choices":[],"usage":{"prompt_tokens":41,"completion_tokens":118,"total_tokens":159}}
data: [DONE]

Parâmetros

Limites e cabeçalhos de resposta

Toda resposta bem-sucedida traz:

Erros

Os erros são JSON com um type estável; o message é para humanos e pode mudar.

{ "error": { "type": "no_credit", "message": "no credit left on this account — top up at bestprivateai.com/api-keys" } }

Cobrança

Crédito pré-pago, cobrado por token a partir do usage real de cada resposta: $0.25 por 1M de tokens de entrada, $1.00 por 1M de tokens de saída. Input é tudo que você envia (system prompt, histórico, a nova mensagem); output é o que o modelo escreve.

• Sua primeira chave vem com $0.50 de crédito grátis, válido por 7 dias — suficiente para integrar e testar. É necessário um e-mail confirmado para uma chave (é para onde vai o aviso de que "o crédito está acabando"). Crédito pago nunca expira.
• O crédito não expira, não há assinatura e nada se renova por conta própria. Recarregue com cartão ou em USDT/USDC na página de chaves.
• Nada é cobrado por requisições recusadas (4xx) ou que falharam (5xx). Uma requisição é cobrada uma única vez, após a resposta, com base no seu X-Request-Id.
• Saldo esgotado → 402 no_credit até você recarregar. Defina um teto diário em cada chave para que uma chave vazada não possa esvaziar a conta.
• Créditos podem ser reembolsados se não forem usados em até 24 horas após a compra, ou aplicados depois a um plano. Veja Créditos e reembolsos.

Persona — modelo puro ou o personagem da BestPrivateAI

Cada chave tem um estilo, escolhido na página de chaves e alternável em qualquer momento:

• Puro (padrão) — seu system prompt é o prompt inteiro. Adicionamos uma linha de identidade e nada mais.
• Persona BestPrivateAI — o personagem e o estilo do chat em bestprivateai.com: direto, sem filtros, sem moralismo, responde no idioma do usuário. Mesmo modelo, mesmo preço, mesma política de conteúdo; só muda o prompt na frente das suas mensagens. Sua própria mensagem de sistema ainda vem depois dele e pode ajustá-lo.

Uma requisição pode sobrescrever a configuração da chave, seja com um campo ou com um sufixo no nome do modelo (para clientes que só conseguem definir um nome de modelo):

{ "model": "notrack-uncensored", "notrack": { "persona": "notrack" }, "messages": [ … ] }

{ "model": "notrack-uncensored:notrack", "messages": [ … ] }      // same thing, by model name
{ "model": "notrack-uncensored:bare",    "messages": [ … ] }      // force the bare model on a persona key

Nomes de persona: notrack (o personagem simples), concise, detailed, creative (as mesmas variantes que o chat oferece), bare. O cabeçalho de resposta X-NoTrack-Persona indica qual foi aplicada.

Política de conteúdo

Não adicionamos nenhum system prompt e não executamos nenhum filtro de tema. Ficção adulta, temas obscuros, linguagem forte, violência na ficção — o modelo responde como está escrito. Uma regra é aplicada no código e não pode ser desativada: qualquer conteúdo sexual envolvendo um menor é recusado.

• 403 child_safety — a requisição buscava conteúdo sexual envolvendo uma criança. Recusado, não cobrado, registrado como evento de segurança.
• 400 minor_in_sexual_context — a cena é sexual e um personagem é lido como menor de 18 anos (idade declarada, ambiente escolar, enquadramento "menina/menino"). Não é um banimento: torne as idades e o enquadramento inequivocamente adultos e reenvie.

403s repetidos em uma chave levam ao encerramento da chave e depois da conta. O texto completo está na Política de Uso Aceitável.

Privacidade

Prompts e completions não são gravados em disco — nem pelo gateway, nem pelos servidores do modelo. O que guardamos por requisição é o id da requisição, o id da chave, as contagens de tokens e o preço, porque é isso que compõe a fatura. Recusas de segurança são registradas por categoria, sem o texto. Nenhum provedor de modelo terceirizado jamais vê seu tráfego: o modelo roda em hardware que alugamos e controlamos.

Clientes e SDKs

O site da BestPrivateAI e o app da BestPrivateAI são o nosso próprio chat — não têm campo para uma chave de API e nunca terão. Uma chave é para programas outros: cole-a em um dos clientes abaixo, ou no seu próprio código.

Python

from openai import OpenAI
client = OpenAI(base_url="https://api.bestprivateai.com/v1", api_key="sk-…")
stream = client.chat.completions.create(model="notrack-uncensored",
    messages=[{"role": "user", "content": "Hello"}], stream=True)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestprivateai.com/v1", apiKey: process.env.API_KEY });
const r = await client.chat.completions.create({ model: "notrack-uncensored",
  messages: [{ role: "user", content: "Hello" }] });
console.log(r.choices[0].message.content);

SillyTavern

API Connections → API: Chat Completion → Source: Custom (OpenAI-compatible) → Custom Endpoint https://api.bestprivateai.com/v1 → Custom API Key → Connect → Model notrack-uncensored. Streaming ativado. Mantenha o tamanho do contexto em 64,000 tokens ou menos.

Chatbox

Configurações → Model Provider → Add → Add Custom Provider, modo OpenAI API Compatible → cole a URL base e a chave, depois adicione notrack-uncensored como o modelo.

NextChat

Configurações → ative Custom Endpoint (compatível com OpenAI) → URL base e chave, depois digite o nome do modelo no campo de modelo.

Cherry Studio

Configurações → Model Providers → Add Provider → digite OpenAI → URL base e chave, depois "Add model" → notrack-uncensored.

LobeChat

Configurações → AI Service Provider → OpenAI → ative custom API endpoint, cole a URL base e a chave, e adicione o modelo à lista de modelos.

Qualquer outro

LangChain, LlamaIndex, Open WebUI, Continue, configurações de proxy do JanitorAI, curl — qualquer cliente com uma opção "OpenAI-compatible" ou "custom base URL".

Os termos de menu acima mudam entre versões do app — se um rótulo não corresponder exatamente, procure a configuração que menciona "custom", "OpenAI-compatible" ou "base URL".

Se um cliente não conectar

• 401 / "invalid API key" — a chave nunca chegou. Confirme que o cliente envia Authorization: Bearer sk-… com a chave completa, incluindo o prefixo.
• 404 / endpoint desconhecido — os clientes divergem sobre se acrescentam /v1 por conta própria. Se https://api.bestprivateai.com/v1 der 404, tente https://api.bestprivateai.com como URL base (ou o contrário).
• "The Responses API is not supported yet" — alguns clientes mais novos usam por padrão a Responses API da OpenAI. Servimos apenas Chat Completions; mude o cliente para esse modo.
• Lista de modelos vazia — alguns clientes só a preenchem após uma verificação de chave válida. Digite notrack-uncensored manualmente.
• Nada acontece em um cliente Ollama / llama.cpp — esses falam seu próprio protocolo, não compatível com OpenAI. Use um dos clientes acima em vez disso.

Chaves

• Até 20 chaves ativas por conta. Dê a cada app sua própria chave e seu próprio teto diário.
• Data de expiração opcional; revogar uma chave a interrompe imediatamente e não pode ser desfeito — emita uma nova em vez disso.
• A página de chaves mostra o gasto por chave, o último uso e os totais de 30 dias da conta.

Dúvidas ou um id de requisição para analisar: suporte · bestprivateai.com/support.