Dokumentace API & Quickstart

Ověření & základní URL

Začněte každý požadavek nastavením klienta na HTTPS://api.uncensoredia.com/v1 a připojením vašeho klíče. Autorizace používá standardní Bearer schéma, takže jednoduše vložíte token, který jste obdrželi po registraci přes Google nebo e-mail. Endpoint je plně API kompatibilní s openai kompatibilní, což znamená, že stačí vyměnit base_url a API klíč ve stávající konfiguraci. Nemusíte spravovat složité vrstvy směrování ani proxy hlavičky. Stačí zajistit, aby váš Authorization hlavička obsahuje váš unikátní token. Toto nastavení zaručuje, že vaše požadavky dorazí na vyhrazený model bez omezení bez jakéhokoli mezilehlého filtrování. Pokud dostanete 401 chybu, ověřte, že je váš klíč aktivní a správně naformátovaný.

Endpoint Chat Completions

Pošlete zprávy do POST /v1/chat/completions pro přijímání textových odpovědí z modelu bez omezení. Tento jediný endpoint zpracovává všechny vaše potřeby generování, od jednoduchých promptů po složité víceotáčkové konverzace. Délku a náhodnost výstupu můžete ovládat pomocí parametrů, jako jsou max_tokens, temperature, a top_p. Model podporuje masivní 100 000 tokenů okno kontextu, které vám umožňuje načíst rozsáhlou dokumentaci nebo dlouhé historie konverzací. Můžete odeslat až 16 000 tokenů v odpovědi. Pokud vynecháte max_tokens, výchozí limit je 2 048 tokenů. Tento endpoint nepodporuje generování obrázků nebo audia. Je striktně text do, text ven. Použijte následující příkaz curl k okamžitému otestování vašeho připojení.

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python pro komunikaci s API s minimálními změnami kódu. Stačí přepsat base_url a api_key v konfiguraci klienta. Tento přístup zajišťuje, že vaše stávající logika pro zpracování odpovědí, chyb a opakování zůstane nedotčena. Knihovna automaticky zpracovává JSON serializaci a streamování, pokud ji povolíte. Tato metoda je ideální pro backendové služby nebo skripty, které potřebují zpracovávat velké objemy textu. Uncensored model reaguje na standardní požadavky na dokončení chatu bez nutnosti vlastní logiky parsování. Nakonfigurujte svého klienta jednou a používejte jej po celou dobu vaší aplikace. Zde je, jak inicializovat klienta a odeslat základní požadavek.

Nastavení SDK Node.js

Integrujte API do svých JavaScriptových nebo TypeScriptových aplikací pomocí @anthropic-ai/sdk nebo oficiální openai balíček. Nastavte baseURL na náš endpoint a zadejte svůj API klíč. To vám umožní používat známé metody, jako chat.completions.create() přímo. SDK zpracovává HTTP požadavky a parzuje JSON odpovědi za vás. Chyby jako 402 (nedostatek kreditu) nebo 429 (limit rychlosti) ve vaší aplikační logice. Toto nastavení je ideální pro webové servery, boty nebo jakékolib prostředí Node.js. Model bez cenzury funguje bezproblémově se standardním formátem požadavku. Nakonfigurujte svého klienta tak, aby byl kompatibilní s očekáváními API.

Streamované odpovědi

Povolit doručování tokenů v reálném čase nastavením stream: true ve vaší žádosti. API vrací stream Server-Sent Events (SSE), což vám umožňuje zobrazovat text, jak je generován. To zlepšuje uživatelskou zkušenost pro chatová rozhraní a snižuje vnímanou latenci. Každý blok obsahuje částečnou odpověď a poslední blok zahrnuje statistiky využití tokenů. Tyto bloky můžete zpracovávat postupně a vytvářet tak kompletní odpověď. Tato funkce je zásadní pro aplikace, které vyžadují okamžitou zpětnou vazbu. Uncensored model podporuje streamování pro všechny typy žádostí. Zpracovávejte události proudu, abyste efektivně aktualizovali uživatelské rozhraní. Použijte tento kód k implementaci streamování ve vašem klientovi.

Limity rychlosti & Limity kontextu

API vynucuje přísné limity pro zajištění stabilního výkonu pro všechny uživatele. Můžete odeslat až 300 požadavků za minutu per key and have 8 souběžných požadavků aktivní kdykoli. Maximální velikost těla požadavku je 8 MB. Pokud tyto limity překročíte, obdržíte 429 kód stavu. Ujistěte se, že zpracováváte opakování s exponenciálním zpomalením, abyste se vyhnuli opakovanému překročení těchto limitů. Okno kontextu je 100 000 tokenů, ale maximální výstup je 16 000 tokenů. Pokud potřebujete více výstupu, upravte max_tokens parametr. Chyby jako 401 (neplatný klíč) a 402 (žádný kredit) jsou okamžité a nespotřebovávají vaše tokenové kvóty. Řiďte svou kvótu pečlivě, abyste předešli přerušení služby při úkolech s vysokým objemem generování.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredia.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredia.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streamování

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)