Dokumentace API

Autentizace a základní URL

API vyžaduje platný API klíč pro autentizaci. Tento klíč obdržíte okamžitě po zaregistrování přes Google nebo e-mailovou adresu. Předložte jej v Authorization hlavička jako Bearer token. Základní URL je https://api.topuncensored.com/v1. Tato URL funguje s jakýmkoli SDK kompatibilním s OpenAI nebo knihovnou klientů.

• Použijte hlavičku: Authorization: Bearer YOUR_API_KEY
• Nastavte základní URL svého klienta na poskytnutý endpoint.

Toto nastavení zajišťuje, že můžete měnit knihovny bez změny základní logiky.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Chat Completions

Odesílejte textové prompty na /v1/chat/completions endpoint. ID modelu je uncensored. Tento endpoint zpracovává standardní formátování zpráv. Vrací textové odpovědi přímo. Nejsou zde žádné další vrstvy ani obaly. Ovládáte kontextové okno o velikosti 100 000 tokenů. Požadavky do velikosti 8 MB fungují spolehlivě. Použijte jej pro přímé generování textu.

Strukturujte svůj požadavek s promptem system a zprávou user. Model odpovídá bez filtrování zákonného obsahu pro dospělé. Chyby jako chybějící klíče vracejí 401. Došli kredity? Dostanete chybu 402. To jsou jasné signály.

Streamované odpovědi

Povolte streamování nastavením stream: true. Získáváte bloky textu, jak jsou generovány. To snižuje vnímanou latenci u dlouhých výstupů. Poslední blok obsahuje data o využití tokenů. Použijte je pro zobrazení v reálném čase nebo postupné vykreslování. Je to efektivní pro aplikace s vysokým objemem dat.

Parsovejte každý kus pro sestavení konečné odpovědi. Tato metoda plynule zpracovává velké výstupy. API podporuje standardní Server-Sent Events. Toto je doporučený přístup pro interaktivní aplikace.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.topuncensored.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)

Volání nástrojů a režim JSON

Používejte volání funkcí pro strukturované interakce. Definujte nástroje ve svém požadavku. Model vrací strukturované argumenty. Nastavte response_format na {"type": "json_object"} pro přísný výstup JSON. To zajišťuje předvídatelné formáty dat. Kombinujte tyto funkce pro robustní integrace. Získáte přesnou kontrolu nad strukturou výstupu.

Volání nástrojů funguje se standardním schématem OpenAI. Režim JSON vynucuje platný JSON. Použijte je pro integrace API nebo extrakci dat. Tato flexibilita podporuje složité pracovní postupy.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.topuncensored.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);

Parametry a limity

Upravit temperature, top_p, a stop sekvence. Nastavte max_tokens na 16 000. Výchozí hodnota je 2 048, pokud je vynecháno. Ovládejte opakování pomocí presence_penalty a frequency_penalty. Použijte seed pro deterministické výstupy. Tyto parametry jemně ladí kvalitu generování. Máte plnou kontrolu nad stylem výstupu.

Limity rychlosti jsou 300 požadavků za minutu. Současný počet požadavků je omezen na 8. Tyto limity zajišťují stabilní výkon. Sledujte své využití přes ovládací panel. Upravte parametry pro optimalizaci pro váš konkrétní případ použití.

Chyby a kontextové okno

Chyby zpracovávejte elegantně. 401 znamená neplatný klíč. 402 indikuje nedostatek kreditu. 429 signalizuje limity rychlosti. Kontextové okno má celkem 100 000 tokenů. Výstup max. 16 000 tokenů. S tokeny nakládejte rozumně. Chyby nespotřebovávají kredit. To šetří peníze při ladění. Pro statistiky využití použijte poslední chunk.

Sledujte využití tokenů. Vyhněte se překročení limitů rychlosti. Opakujte pokus s exponenciálním zpožděním. To zajišťuje spolehlivý provoz. API je navrženo pro robustnost. Řešte chyby jako součást běžného toku.

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)