BestPrivateAI API — справочник

Один эндпоинт, совместимый с OpenAI, одна модель, один ключ. Если ваш код уже работает с /v1/chat/completions, поменяйте базовый URL и ключ — и он будет работать с нами.

Базовый URL и авторизация

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

Ключи создаются на странице ключей. Ключ показывается один раз, при создании; мы храним его хеш и последние шесть символов. Отправляйте его только по HTTPS и только в заголовке Authorization — никогда в URL.

Всё в формате JSON (Content-Type: application/json). Ответы используют схему OpenAI, поэтому официальные SDK openai и любой совместимый с OpenAI клиент работают без изменений.

Модели

GET /v1/models

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

Есть одна модель, notrack-uncensored: наша собственная версия компаньона, работающая на нашем собственном оборудовании. Всё, что вы передадите в model, будет направлено к ней; используйте публичный id, чтобы ваши логи совпадали с нашими.

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
}

Ответ — стандартный формат, с реальным числом токенов в usage (именно по нему списывается оплата):

{
  "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 }
}

Стриминг

Установите "stream": true и читайте server-sent events, точно как в OpenAI. Последний фрагмент содержит usage (мы всегда включаем его, независимо от того, запрашиваете ли вы stream_options), затем 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]

Параметры

Лимиты и заголовки ответа

Каждый успешный ответ содержит:

Ошибки

Ошибки — это JSON со стабильным type; message предназначен для людей и может меняться.

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

Оплата

Предоплаченный кредит, списывается за токен на основе реального usage каждого ответа: $0.25 за 1M входных токенов, $1.00 за 1M выходных токенов. Input — это всё, что вы отправляете (системный промпт, история, новое сообщение); output — то, что пишет модель.

• Ваш первый ключ идёт с $0.50 бесплатного кредита, действующего 7 дней — достаточно для интеграции и тестирования. Для получения ключа нужен подтверждённый e-mail (именно на него приходит уведомление «кредит заканчивается»). Оплаченный кредит никогда не истекает.
• Кредит не истекает, подписки нет, и ничего не продлевается само по себе. Пополняйте картой или в USDT/USDC на странице ключей.
• За отклонённые запросы (4xx) или неудачные (5xx) плата не взимается. Запрос оплачивается один раз, после ответа, по его X-Request-Id.
• Баланс закончился → 402 no_credit до пополнения. Установите дневной лимит на каждом ключе, чтобы утёкший ключ не мог опустошить счёт.
• Кредиты можно вернуть, если они не использованы в течение 24 часов после покупки, либо позже зачесть в счёт тарифа. См. Кредиты и возвраты.

Персона — чистая модель или персонаж BestPrivateAI

У каждого ключа есть стиль, выбираемый на странице ключей и переключаемый в любой момент:

• Чистая (по умолчанию) — ваш системный промпт — это весь промпт. Мы добавляем одну строку идентификации и ничего больше.
• Персона BestPrivateAI — персонаж и стиль чата на bestprivateai.com: прямой, без цензуры, без морализаторства, отвечает на языке пользователя. Та же модель, та же цена, та же политика контента; меняется только промпт перед вашими сообщениями. Ваше собственное системное сообщение всё так же идёт после него и может его корректировать.

Запрос может переопределить настройку ключа — либо полем, либо суффиксом в названии модели (для клиентов, которые могут задать только имя модели):

{ "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

Названия персон: notrack (обычный персонаж), concise, detailed, creative (те же варианты, что предлагает чат), bare. Заголовок ответа X-NoTrack-Persona указывает, какая была применена.

Политика контента

Мы не добавляем никакого системного промпта и не запускаем никакого фильтра тем. Взрослая художественная литература, тёмные темы, грубый язык, насилие в вымысле — модель отвечает так, как написано. Одно правило закреплено в коде и не может быть отключено: любой сексуальный контент с участием несовершеннолетнего отклоняется.

• 403 child_safety — запрос был направлен на сексуальный контент с участием ребёнка. Отклонено, не оплачено, зафиксировано как событие безопасности.
• 400 minor_in_sexual_context — сцена сексуальная, а персонаж читается как младше 18 лет (указан возраст, школьная обстановка, формулировка «девочка/мальчик»). Это не запрет: сделайте возраст и обстановку однозначно взрослыми и отправьте повторно.

Повторяющиеся 403 на ключе приводят к закрытию ключа, а затем и аккаунта. Полный текст — в Политике допустимого использования.

Приватность

Промпты и ответы не записываются на диск — ни шлюзом, ни серверами модели. Что мы храним по каждому запросу — это id запроса, id ключа, число токенов и цена, потому что именно это формирует счёт. Отказы по безопасности логируются по категории, без текста. Ни один сторонний провайдер модели никогда не видит ваш трафик: модель работает на оборудовании, которое мы арендуем и контролируем.

Клиенты и SDK

Сайт BestPrivateAI и приложение BestPrivateAI — это наш собственный чат: у них нет поля для API-ключа и никогда не будет. Ключ предназначен для других-программ: вставьте его в один из клиентов ниже или в свой собственный код.

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 включён. Держите размер контекста на уровне 64,000 токенов или ниже.

Chatbox

Settings → Model Provider → Add → Add Custom Provider, режим OpenAI API Compatible → вставьте базовый URL и ключ, затем добавьте notrack-uncensored как модель.

NextChat

Settings → включите Custom Endpoint (совместимый с OpenAI) → базовый URL и ключ, затем введите название модели в поле модели.

Cherry Studio

Settings → Model Providers → Add Provider → введите OpenAI → базовый URL и ключ, затем «Add model» → notrack-uncensored.

LobeChat

Settings → AI Service Provider → OpenAI → включите custom API endpoint, вставьте базовый URL и ключ, и добавьте модель в список моделей.

Что-то другое

LangChain, LlamaIndex, Open WebUI, Continue, настройки proxy JanitorAI, curl — любой клиент с опцией «OpenAI-compatible» или «custom base URL».

Формулировки меню выше отличаются между версиями приложения — если название не совпадает точно, ищите настройку, где упоминается «custom», «OpenAI-compatible» или «base URL».

Если клиент не подключается

• 401 / «invalid API key» — ключ не дошёл. Убедитесь, что клиент отправляет Authorization: Bearer sk-… с полным ключом, включая префикс.
• 404 / неизвестный эндпоинт — клиенты по-разному решают, добавлять ли /v1 самостоятельно. Если https://api.bestprivateai.com/v1 даёт 404, попробуйте https://api.bestprivateai.com как базовый URL (или наоборот).
• «The Responses API is not supported yet» — некоторые новые клиенты по умолчанию используют Responses API от OpenAI. Мы поддерживаем только Chat Completions; переключите клиента на этот режим.
• Пустой список моделей — некоторые клиенты заполняют его только после проверки корректного ключа. Введите notrack-uncensored вручную.
• В клиенте Ollama / llama.cpp ничего не происходит — они используют собственный протокол, не совместимый с OpenAI. Используйте вместо этого один из клиентов выше.

Ключи

• До 20 активных ключей на аккаунт. Дайте каждому приложению свой ключ и свой дневной лимит.
• Необязательная дата истечения; отзыв ключа останавливает его немедленно и не может быть отменён — выпустите новый вместо этого.
• Страница ключей показывает расход по каждому ключу, последнее использование и итоги за 30 дней по аккаунту.

Вопросы или id запроса для проверки: поддержка · bestprivateai.com/support.