BestPrivateAI API — referensi

Satu endpoint kompatibel OpenAI, satu model, satu key. Jika kode Anda sudah berbicara dengan /v1/chat/completions, ubah base URL dan key-nya, lalu kode itu akan berbicara dengan kami.

Base URL & autentikasi

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

Key dibuat di halaman key. Sebuah key ditampilkan sekali, saat dibuat; kami menyimpan hash-nya dan enam karakter terakhirnya. Kirim hanya lewat HTTPS dan hanya di header Authorization — jangan pernah di URL.

Semuanya JSON (Content-Type: application/json). Respons menggunakan skema OpenAI, sehingga SDK resmi openai dan setiap klien yang kompatibel dengan OpenAI berfungsi tanpa perubahan.

Model

GET /v1/models

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

Hanya ada satu model, notrack-uncensored: tune companion buatan kami sendiri, dijalankan di hardware kami sendiri. Apa pun yang Anda kirim sebagai model akan dirutekan ke model ini; gunakan id publiknya agar log Anda cocok dengan log kami.

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
}

Respons — bentuk standar, dengan jumlah token sebenarnya di usage (itulah yang menjadi dasar penagihan Anda):

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

Set "stream": true dan baca server-sent events, sama seperti pada OpenAI. Chunk terakhir membawa usage (kami selalu menyertakannya, baik Anda meminta stream_options atau tidak), lalu 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]

Parameter

Limit & header respons

Setiap respons yang berhasil membawa:

Error

Error berupa JSON dengan type yang stabil; message untuk manusia dan dapat berubah.

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

Penagihan

Saldo prabayar, ditagih per token berdasarkan usage sebenarnya dari setiap respons: $0.25 per 1 juta token input, $1.00 per 1 juta token output. Input adalah semua yang Anda kirim (system prompt, riwayat, pesan baru); output adalah yang ditulis model.

• Key pertama Anda disertai $0.50 saldo gratis, berlaku selama 7 hari — cukup untuk mengintegrasikan dan menguji. Email terverifikasi diperlukan untuk sebuah key (itulah tujuan notifikasi "saldo hampir habis"). Saldo berbayar tidak pernah kedaluwarsa.
• Saldo tidak kedaluwarsa, tidak ada subscription, dan tidak ada yang otomatis diperpanjang. Isi ulang dengan kartu atau dalam USDT/USDC di halaman key.
• Tidak ada biaya untuk request yang ditolak (4xx) atau gagal (5xx). Sebuah request ditagih sekali, setelah respons, berdasarkan X-Request-Id-nya.
• Saldo habis → 402 no_credit sampai Anda mengisi ulang. Tetapkan batas harian pada setiap key agar key yang bocor tidak dapat menghabiskan akun.
• Kredit dapat dikembalikan jika belum digunakan dalam waktu 24 jam setelah pembelian, atau nantinya diterapkan ke langganan. Lihat Kredit dan pengembalian dana.

Persona — model polos atau karakter BestPrivateAI

Setiap key memiliki gaya, dipilih di halaman key dan dapat diganti kapan saja:

• Polos (default) — system prompt Anda adalah keseluruhan prompt. Kami menambahkan satu baris identitas dan tidak ada yang lain.
• Persona BestPrivateAI — karakter dan gaya chat di bestprivateai.com: langsung, tanpa filter, tanpa menceramahi, menjawab dalam bahasa pengguna. Model sama, harga sama, kebijakan konten sama; hanya prompt di depan pesan Anda yang berubah. Pesan sistem Anda sendiri tetap mengikutinya dan dapat menyesuaikannya.

Sebuah request dapat menimpa setelan key, baik dengan field maupun dengan suffix model (untuk klien yang hanya bisa mengatur nama model):

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

Nama persona: notrack (karakter polos), concise, detailed, creative (varian yang sama yang ditawarkan chat), bare. Header respons X-NoTrack-Persona menunjukkan mana yang diterapkan.

Kebijakan konten

Kami tidak menambahkan system prompt dan tidak menjalankan filter topik apa pun. Fiksi dewasa, tema gelap, bahasa kasar, kekerasan dalam fiksi — model menjawab sesuai yang ditulis. Satu aturan diberlakukan dalam kode dan tidak dapat dimatikan: apa pun yang bersifat seksual yang melibatkan anak di bawah umur akan ditolak.

• 403 child_safety — request mencari konten seksual yang melibatkan anak. Ditolak, tidak ditagih, dicatat sebagai kejadian keamanan.
• 400 minor_in_sexual_context — skenario bersifat seksual dan sebuah karakter terbaca di bawah 18 tahun (usia disebutkan, latar sekolah, framing "anak perempuan/laki-laki"). Bukan larangan permanen: jadikan usia dan framing secara jelas dewasa dan kirim ulang.

403 yang berulang pada sebuah key akan berujung pada penutupan key, lalu akun. Teks lengkapnya ada di Acceptable Use policy.

Privasi

Prompt dan completion tidak ditulis ke disk — tidak oleh gateway, tidak oleh server model. Yang kami simpan per request adalah id request, id key, jumlah token, dan harga, karena itulah dasar penagihan. Penolakan keamanan dicatat berdasarkan kategori, tanpa teksnya. Tidak ada penyedia model pihak ketiga yang pernah melihat traffic Anda: model berjalan di hardware yang kami sewa dan kendalikan sendiri.

Klien & SDK

Situs BestPrivateAI dan aplikasi BestPrivateAI adalah chat kami sendiri — keduanya tidak memiliki field untuk API key dan tidak akan pernah memilikinya. Sebuah key ditujukan untuk program lain: tempelkan ke salah satu klien di bawah ini, atau ke kode Anda sendiri.

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 aktif. Jaga ukuran konteks pada atau di bawah 64,000 token.

Chatbox

Settings → Model Provider → Add → Add Custom Provider, mode OpenAI API Compatible → tempelkan base URL dan key, lalu tambahkan notrack-uncensored sebagai model.

NextChat

Settings → aktifkan Custom Endpoint (kompatibel OpenAI) → base URL dan key, lalu ketik nama model di field model.

Cherry Studio

Settings → Model Providers → Add Provider → ketik OpenAI → base URL dan key, lalu "Add model" → notrack-uncensored.

LobeChat

Settings → AI Service Provider → OpenAI → aktifkan custom API endpoint, tempelkan base URL dan key, lalu tambahkan model ke daftar model.

Lainnya

LangChain, LlamaIndex, Open WebUI, Continue, setelan proxy JanitorAI, curl — klien apa pun dengan opsi "kompatibel OpenAI" atau "base URL custom".

Penulisan menu di atas berubah antar versi aplikasi — jika sebuah label tidak cocok tepat, cari setelan yang menyebut "custom", "OpenAI-compatible", atau "base URL".

Jika klien tidak bisa terhubung

• 401 / "invalid API key" — key tidak pernah terkirim. Pastikan klien mengirim Authorization: Bearer sk-… dengan seluruh key, termasuk prefix-nya.
• 404 / endpoint tidak dikenal — klien berbeda-beda soal apakah mereka menambahkan /v1 sendiri. Jika https://api.bestprivateai.com/v1 memberi 404, coba https://api.bestprivateai.com sebagai base URL sebagai gantinya (atau sebaliknya).
• "The Responses API is not supported yet" — beberapa klien yang lebih baru secara default memakai Responses API milik OpenAI. Kami hanya melayani Chat Completions; alihkan klien ke mode itu.
• Daftar model kosong — beberapa klien hanya mengisinya setelah pengecekan key yang valid. Ketik notrack-uncensored secara manual.
• Tidak ada yang terjadi pada klien Ollama / llama.cpp — klien tersebut memakai protokolnya sendiri, tidak kompatibel dengan OpenAI. Gunakan salah satu klien di atas sebagai gantinya.

Key

• Hingga 20 key aktif per akun. Beri setiap aplikasi key-nya sendiri dan batas hariannya sendiri.
• Tanggal kedaluwarsa opsional; mencabut sebuah key langsung menghentikannya dan tidak dapat dibatalkan — buat key baru sebagai gantinya.
• Halaman key menampilkan pengeluaran per key, penggunaan terakhir, dan total 30 hari akun.

Pertanyaan atau id request yang ingin diperiksa: support · bestprivateai.com/support.