Dokumentace API

Základní URL a ověření

Základní URL pro všechny požadavky je HTTPS://api.aiobliterated.com/v1. Pro autentizaci potřebujete API klíč. Vygenerujte jej registrací přes Google nebo e-mail a heslo na stránce Získat API klíč. Klíč předávejte v hlavičce Authorization jako Bearer token. Každý požadavek vyžaduje tuto hlavičku pro identifikaci vašeho účtu a sledování využití.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

Váš první požadavek

Odeslat POST požadavek na /v1/chat/completions pro generování textu. Nastavte model na „uncensored“ a zahrňte svůj systémový prompt. API vrátí odpověď modelu v poli content. Toto je standardní formát používaný většinou klientů LLM.

Copyfrom openai import OpenAI

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

Použití Node SDK

Nainstalujte oficiální SDK OpenAI pro Node.js. Nakonfigurujte ho svým API klíčem a základní URL. Zavolejte metodu chat.completions.create se svými zprávami. SDK automaticky řeší serializaci a streamování.

Copyimport OpenAI from "openai";

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

Streamované odpovědi

Povolte streamování nastavením stream na true ve vašem požadavku. API vrací stream Server-Sent Events. Každá událost obsahuje částečný chunk odpovědi. To umožňuje zobrazovat text, jak je generován, což zlepšuje uživatelský zážitek.

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)

Okno kontextu a limity

Model podporuje kontextové okno o velikosti 100 000 tokenů. To zahrnuje jak prompt, tak dokončení. Můžete nastavit maximální výstup na 16 000 tokenů na požadavek. Pokud nezadáte max_tokens, limit je 2 048 tokenů. To zajišťuje předvídatelné náklady a výkon.

Zpracování chyb a limity

Sledujte kódy stavu HTTP pro chyby. Odpověď 401 znamená, že váš API klíč je neplatný. Odpověď 402 indikuje nedostatečný kredit. Odpověď 429 signalizuje, že jste překročili limit rychlosti 300 požadavků za minutu. Tyto chyby ošetřujte v aplikaci elegantně, abyste udrželi spolehlivost.