NoTrack API — referencia

Jeden endpoint kompatibilný s OpenAI, jeden model, jeden kľúč. Ak váš kód už komunikuje s /v1/chat/completions, zmeňte základnú URL a kľúč a bude komunikovať s nami.

Základná URL a autentifikácia

Base URL:  https://api.notrack.ai/v1
Header:    Authorization: Bearer sk-notrack-…

Kľúče sa vytvárajú na stránke kľúčov. Kľúč sa zobrazí iba raz, pri vytvorení; uchovávame jeho hash a posledných šesť znakov. Odosielajte ho iba cez HTTPS a iba v hlavičke Authorization — nikdy v URL.

Všetko je JSON (Content-Type: application/json). Odpovede používajú schému OpenAI, takže oficiálne SDK openai a každý klient kompatibilný s OpenAI fungujú bez zmien.

Modely

GET /v1/models

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

Existuje jeden model, notrack-uncensored: náš vlastný model, prevádzkovaný na našich vlastných GPU serveroch. Čokoľvek odošlete ako model, sa smeruje k nemu; používajte verejné id, aby sa vaše logy zhodovali s našimi.

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
}

Odpoveď — štandardný formát, s reálnym počtom tokenov v usage (to je to, za čo sa platí):

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

Váš systémový prompt riadi konverzáciu. Na začiatok pridávame presne jeden riadok — identitu modelu (že je to notrack-uncensored, vytvorený spoločnosťou NoTrack) — a nič iné: žiadne pravidlá, žiadny filter tém. Vaša systémová správa nasleduje po ňom a rozhoduje o persóne, štýle a všetkom ostatnom. Jedinou výnimkou je Politika obsahu.

Streaming

Nastavte "stream": true a čítajte server-sent events presne ako pri OpenAI. Posledný fragment obsahuje usage (vždy ho zahrnieme, bez ohľadu na to, či žiadate stream_options), potom 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]

Parametre

PolePoznámky
messagesPovinné. Role system, user, assistant. Zatiaľ iba text — obrazové časti sú odmietnuté.
modelPoužite notrack-uncensored.
streamtrue pre SSE. stream_options.include_usage je vždy zapnuté.
max_tokensLimit na completion. Prompt + completion sa musí zmestiť do okna 100,000 tokenov.
temperature, top_p, stop, presence_penalty, frequency_penalty, seed, nOdovzdáva sa modelu ako v OpenAI. Ak neodošlete temperature, použijeme 0.85, rovnako ako náš chat. n > 1 zvyšuje náklady na output.
tools, tool_choicePodporované: auto, none, required, alebo pomenovaná funkcia. Odpoveď obsahuje tool_calls a finish_reason: "tool_calls"; výsledok odošlite späť ako správu role: "tool". Ak sú prítomné nástroje, streamovaná odpoveď prichádza ako jeden fragment na volanie, nie token po tokene.
response_format{"type": "json_object"} je podporované (v prompte uveďte, aký JSON chcete). json_schema a zastarané pole functions nie sú.

Limity a hlavičky odpovede

LimitHodnotaPri prekročení
Súbežné požiadavky na kľúč8429 concurrency
Požiadavky za minútu na kľúč300429 rate_limit
Kontextové okno (prompt + completion)100,000 tokenov400 context_limit — skráťte históriu a skúste znova
Denný limit výdavkov na kľúč (voliteľné)nastavené vami na stránke kľúčov402 key_daily_cap do 00:00 UTC

Skúšobné kľúče (pred prvým dobitím): súbežných požiadaviek — 2, požiadaviek za minútu — 60. Po prvom dobití získa kľúč plné limity: 8 a 300.

Každá úspešná odpoveď obsahuje:

HlavičkaVýznam
X-Request-IdUveďte ho pri písaní na podporu; je to jediná informácia, ktorú o požiadavke uchovávame.
X-NoTrack-Balance-USDVáš kredit pred bola táto požiadavka zúčtovaná, v dolároch.
X-RateLimit-Limit-RequestsPočet požiadaviek za minútu povolený pre tento kľúč.
X-RateLimit-Limit-ConcurrencyPočet paralelných požiadaviek povolený pre tento kľúč.
X-NoTrack-Content-FlagIba pri zamietnutí obsahu: minor_in_sexual_context alebo child_safety.

Chyby

Chyby sú JSON so stabilným type; message je určený pre ľudí a môže sa meniť.

{ "error": { "type": "no_credit", "message": "no credit left on this account — top up at notrack.ai/api-keys" } }
HTTPtypeČo robiť
400bodyNeplatný JSON alebo chýba messages.
400context_limitPrompt je príliš dlhý pre okno 100,000 tokenov. Odstráňte staršie kolá.
400content_policy + X-NoTrack-Content-Flag: minor_in_sexual_contextScéna sa čita ako sexuálna a postava ako neplnoletá. Urobte postavy jednoznačne dospelými a odošlite znova; nefakturuje sa.
401auth, invalid_key, key_revoked, key_expiredOpravte alebo nahraďte kľúč.
402no_creditZostatok je nulový. Dobite; požiadavky sa obnovia okamžite.
402key_daily_capTento kľúč dosiahol denný strop, ktorý ste nastavili. Zvýšte ho alebo počkajte do 00:00 UTC.
403content_policy + X-NoTrack-Content-Flag: child_safetyZamietnuté a nefakturované. Pozrite Politika obsahu.
429rate_limit, concurrencySpomaľte a skúste znova; rešpektujte obe hlavičky X-RateLimit-*.
502upstreamModel neodpovedal. Skúste znova s odstupom; nefakturuje sa.
503billing, safetyJedna z našich závislostí je nedostupná. Skúste znova o niekoľko sekúnd; nefakturuje sa.

Fakturácia

Predplatený kredit, účtovaný za token na základe reálneho usage každej odpovede: $0.15 za 1M vstupných tokenov, $0.50 za 1M výstupných tokenov. Input je všetko, čo odošlete (systémový prompt, história, nová správa); output je to, čo napíše model.

Persona — čistý model alebo charakter NoTrack

Každý kľúč má štýl, vybraný na stránke kľúčov a prepínateľný kedykoľvek:

Požiadavka môže prepísať nastavenie kľúča, buď pomocou poľa, alebo prípony názvu modelu (pre klientov, ktorí môžu nastaviť iba názov modelu):

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

Názvy persón: notrack (jednoduchý charakter), concise, detailed, creative (tie isté varianty, ktoré ponúka chat), bare. Hlavička odpovede X-NoTrack-Persona udáva, ktorá sa použila.

Politika obsahu

Nepridávame žiadny systémový prompt a nespúšťame žiadny filter tém. Fikcia pre dospelých, temné témy, silný jazyk, násilie v fikcii — model odpovedá presne tak, ako je napísané. Jedno pravidlo je vynútené v kóde a nemôže sa vypnúť: čokoľvek sexuálne s účasťou neplnoletej osoby je zamietnuté.

Opakované 403 na kľúči vedú k zatvoreniu kľúča, následne účtu. Celý text je v Politike prijateľného používania.

Súkromie

Prompty a odpovede sa nezapisujú na disk — ani gateway, ani servery modelu. Čo uchovávame na požiadavku, je id požiadavky, id kľúča, počet tokenov a cena, pretože to tvorí faktúru. Bezpečnostné zamietnutia sa zaznamenávajú podľa kategórie, bez textu. Žiadny externý poskytovateľ modelu nikdy nevidí vašu prevádzku: model beží na našich vlastných GPU serveroch.

Klienti a SDK

Webová stránka NoTrack a aplikácia NoTrack sú náš vlastný chat — nemajú pole na API kľúč a nikdy ho nebudú mať. Kľúč je určený pre iných programy: vložte ho do jedného z klientov nižšie, alebo do vlastného kódu.

Python

from openai import OpenAI
client = OpenAI(base_url="https://api.notrack.ai/v1", api_key="sk-notrack-…")
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.notrack.ai/v1", apiKey: process.env.NOTRACK_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.notrack.ai/v1 → Custom API Key → Connect → Model notrack-uncensored. Streaming zapnutý. Udržujte veľkosť kontextu na alebo pod 100,000 tokenov.

Chatbox

Settings → Model Provider → Add → Add Custom Provider, režim OpenAI API Compatible → vložte základnú URL a kľúč, potom pridajte notrack-uncensored ako model.

NextChat

Settings → zapnite Custom Endpoint (kompatibilné s OpenAI) → základná URL a kľúč, potom napíšte názov modelu do poľa modelu.

Cherry Studio

Settings → Model Providers → Add Provider → napíšte OpenAI → základná URL a kľúč, potom „Add model“ → notrack-uncensored.

LobeChat

Settings → AI Service Provider → OpenAI → zapnite custom API endpoint, vložte základnú URL a kľúč, a pridajte model do zoznamu modelov.

Niečo iné

LangChain, LlamaIndex, Open WebUI, Continue, nastavenia proxy JanitorAI, curl — akýkoľvek klient s možnosťou „OpenAI-compatible“ alebo „custom base URL“.

Znenie menu vyššie sa medzi verziami aplikácie líši — ak sa označenie presne nezhoduje, hľadajte nastavenie, ktoré spomína „custom“, „OpenAI-compatible“, alebo „base URL“.

Ak sa klient nepripojí

Kľúče

Otázky alebo id požiadavky na preverenie: podpora · [email protected].