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
| Pole | Poznámky |
|---|---|
messages | Povinné. Role system, user, assistant. Zatiaľ iba text — obrazové časti sú odmietnuté. |
model | Použite notrack-uncensored. |
stream | true pre SSE. stream_options.include_usage je vždy zapnuté. |
max_tokens | Limit na completion. Prompt + completion sa musí zmestiť do okna 100,000 tokenov. |
temperature, top_p, stop, presence_penalty, frequency_penalty, seed, n | Odovzdá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_choice | Podporované: 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
| Limit | Hodnota | Pri prekročení |
|---|---|---|
| Súbežné požiadavky na kľúč | 8 | 429 concurrency |
| Požiadavky za minútu na kľúč | 300 | 429 rate_limit |
| Kontextové okno (prompt + completion) | 100,000 tokenov | 400 context_limit — skráťte históriu a skúste znova |
| Denný limit výdavkov na kľúč (voliteľné) | nastavené vami na stránke kľúčov | 402 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čka | Význam |
|---|---|
X-Request-Id | Uveďte ho pri písaní na podporu; je to jediná informácia, ktorú o požiadavke uchovávame. |
X-NoTrack-Balance-USD | Váš kredit pred bola táto požiadavka zúčtovaná, v dolároch. |
X-RateLimit-Limit-Requests | Počet požiadaviek za minútu povolený pre tento kľúč. |
X-RateLimit-Limit-Concurrency | Počet paralelných požiadaviek povolený pre tento kľúč. |
X-NoTrack-Content-Flag | Iba 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" } }
| HTTP | type | Čo robiť |
|---|---|---|
| 400 | body | Neplatný JSON alebo chýba messages. |
| 400 | context_limit | Prompt je príliš dlhý pre okno 100,000 tokenov. Odstráňte staršie kolá. |
| 400 | content_policy + X-NoTrack-Content-Flag: minor_in_sexual_context | Scéna sa čita ako sexuálna a postava ako neplnoletá. Urobte postavy jednoznačne dospelými a odošlite znova; nefakturuje sa. |
| 401 | auth, invalid_key, key_revoked, key_expired | Opravte alebo nahraďte kľúč. |
| 402 | no_credit | Zostatok je nulový. Dobite; požiadavky sa obnovia okamžite. |
| 402 | key_daily_cap | Tento kľúč dosiahol denný strop, ktorý ste nastavili. Zvýšte ho alebo počkajte do 00:00 UTC. |
| 403 | content_policy + X-NoTrack-Content-Flag: child_safety | Zamietnuté a nefakturované. Pozrite Politika obsahu. |
| 429 | rate_limit, concurrency | Spomaľte a skúste znova; rešpektujte obe hlavičky X-RateLimit-*. |
| 502 | upstream | Model neodpovedal. Skúste znova s odstupom; nefakturuje sa. |
| 503 | billing, safety | Jedna 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.
- Váš prvý kľúč obsahuje $0.50 bezplatného kreditu, platného 7 dní — dosť na integráciu a testovanie. Na vytvorenie kľúča je potrebný potvrdený e-mail (tam prichádza upozornenie „kredit sa míňa“). Platený kredit nikdy nevyprší.
- Kredit nevyprší, nejde o predplatné a nič sa neobnovuje samo. Dobite kartou alebo v USDT/USDC na stránke kľúčov.
- Za zamietnuté požiadavky (
4xx) ani neúspešné (5xx) sa nič neúčtuje. Požiadavka sa účtuje jedenkrát, po odpovedi, na základe jejX-Request-Id. - Zostatok sa minie →
402 no_credit, kým nedobijete. Nastavte denný strop na každom kľúči, aby unikutý kľúč nemohol vyčerpať účet. - Kredity sa nevracajú, pokiaľ nemôžeme poskytnúť našu službu; nikdy nevyprší a môžu byť uplatnené na plán. Pozri Kredity a vrátenie platieb.
Persona — čistý model alebo charakter NoTrack
Každý kľúč má štýl, vybraný na stránke kľúčov a prepínateľný kedykoľvek:
- Čistá (predvolené) — váš systémový prompt je celý prompt. Pridáme jeden riadok identity a nič iné.
- Persona NoTrack — charakter a štýl chatu na notrack.ai: priamy, nefiltrovaný, bez moralizovania, odpovedá v jazyku používateľa. Rovnaký model, rovnaká cena, rovnaká politika obsahu; mení sa iba prompt pred vašimi správami. Vaša vlastná systémová správa naďalej nasleduje po ňom a môže ho upraviť.
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é.
403 child_safety— požiadavka smerovala k sexuálnemu obsahu s účasťou dieťaťa. Zamietnuté, nefakturované, zaznamenané ako bezpečnostný incident.400 minor_in_sexual_context— scéna je sexuálna a postava sa javí ako mladšia ako 18 rokov (uvedený vek, školské prostredie, rámcovanie „dievča/chlapec“). Nejde o zákaz: urobte vek a rámcovanie jednoznačne dospelými a odošlite znova.
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í
- 401 / „invalid API key“ — kľúč nikdy nedorazil. Overte, že klient odosiela
Authorization: Bearer sk-notrack-…s celým kľúčom, vrátane prefixu. - 404 / neznámy endpoint — klienti sa líšia v tom, či
/v1pridávajú sami. Akhttps://api.notrack.ai/v1vracia 404, skúste ako základnú URLhttps://api.notrack.ai(alebo naopak). - „The Responses API is not supported yet“ — niektorí novší klienti štandardne používajú Responses API od OpenAI. Podporujeme iba Chat Completions; prepnite klienta do tohto režimu.
- Prázdny zoznam modelov — niektorí klienti ho naplnia iba po overení platného kľúča. Napíšte
notrack-uncensoredmanuálne. - V klientovi Ollama / llama.cpp sa nič nestane — tie hovoria svojím vlastným protokolom, nekompatibilným s OpenAI. Použite namiesto toho jedného z klientov vyššie.
Kľúče
- Až 20 aktívnych kľúčov na účet. Dajte každej aplikácii vlastný kľúč a vlastný denný strop.
- Voliteľný dátum expirácie; zrušenie kľúča ho okamžite zastaví a nemôže sa vrátiť späť — vydajte namiesto toho nový.
- Stránka kľúčov zobrazuje výdavky za kľúč, posledné použitie a 30-dňové súčty účtu.
Otázky alebo id požiadavky na preverenie: podpora · [email protected].