Rychlý start: Integrujte API Uncensored

Požadavky a instalace SDK

API vyžaduje platnou knihovnu SDK a platný klíč. Nainstalujte knihovnu pro preferovaný jazyk přes pip nebo npm. Podporujeme standardní klientské knihovny OpenAI, které automaticky zpracovávají autentizaci a parsování JSON.

Ujistěte se, že máte nainstalovaný Python 3.8+ nebo Node.js 18+. SDK spravují za vás poolování připojení a logiku opakování. To výrazně snižuje množství boilerplate kódu.

Copyfrom openai import OpenAI

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

Konfigurace základní URL a API klíče

Nasměrujte klienta na naši konkrétní koncovou adresu. Použijte základní URL uvedenou v ovládacím panelu. Předložte svůj API klíč v hlavičce Authorization. To zajišťuje, že požadavky směřují přímo do infrastruktury bez omezení.

Nepoužívejte výchozí URL základny OpenAI. Váš klíč selže, pokud bude směrován nesprávně. Nastavte základní URL v objektu konfigurace SDK před odesláním jakýchkoli dat.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

Odeslání vašeho prvního požadavku na Chat Completion

Pošlete požadavek POST na /v1/chat/completions. Zadejte ID modelu a pole messages. Model okamžitě odpoví textovým obsahem. Není vyžadována žádná složitá logika směrování.

"Udržte payload jednoduchý. Začněte s jedním systémovým promptem a jednou uživatelskou zprávou. Ověřte, zda struktura odpovědi odpovídá standardu OpenAI. Tím potvrdíte, že vaše integrace funguje správně."

Copyimport OpenAI from "openai";

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

Zvládání streamovaných odpovědí a používání nástrojů

Povolte streamování nastavením stream na true. API vrací chunky prostřednictvím Server-Sent Events. Každý chunk obsahuje částečný text nebo data o využití tokenů. Agregujte tyto chunky pro zobrazení výstupu v reálném čase.

Využití nástrojů je podporováno pro volání funkcí. Definujte své nástroje v požadavku. Model vrací volání nástrojů místo obyčejného textu, když je to vhodné. Parsovejte volání nástrojů a proveďte svou vlastní logiku.

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)

Chápání limitů tokenů a kontextového okna

Okno kontextu podporuje celkem 100 000 tokenů. To zahrnuje tokeny vstupu i výstupu. Nastavte max_tokens pro omezení délky odpovědi. Výchozí max výstup je 2 048 tokenů, pokud není specifikováno.

Sledujte využití tokenů v posledním bloku streamování. Chyby nespotřebovávají kredit. To umožňuje bezpečné experimentování bez finančního rizika. Plánujte strukturu promptu tak, aby se vešla do limitu.

Řešení běžných chyb

Nejprve zkontrolujte svůj API klíč. Chyba 401 naznačuje neplatný nebo expirovaný klíč. Chyba 402 znamená, že je vyčerpán váš předplacený kredit. Pokračujte dobíjením přes kryptoměny.

Chyba 429 signalizuje omezení rychlosti. Jste omezeni na 300 požadavků za minutu. Snižte svou souběžnost nebo počkejte před opakováním. Limit těla 8 MB také vyvolá chyby 400, pokud bude překročen.