Rychlý start: integrace během minut

1. Nainstalujte své SDK

Začněte instalací oficiální knihovny pro váš jazyk. Většina vývojářů preferuje standardní balíček, protože odpovídá rozhraní, které již znají. Spusťte pip install openai pro Python nebo npm install openai pro Node.js. K zpracování všech požadavků potřebujete pouze jedno SDK.

2. Nastavte svou základní URL

Nakonfigurujte klienta tak, aby ukazoval na náš konkrétní endpoint. Musíte přepsat výchozí základní URL, aby se provoz správně směroval. Použijte https://api.unsencoredai.com/v1 jako vaši základní URL. Předajte svůj API klíč v Authorization hlavička. Toto nastavení funguje s jakýmkoli standardním klientem kompatibilním s OpenAI.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Pošlete svou první žádost

Standardní požadavek na dokončení chatu pro generování textu. ID modelu je uncensored. Můžete odesílat systémové prompty k řízení chování. API vrací přímou textovou odpověď. Použijte níže uvedený příkaz curl k okamžitému otestování připojení. Zkontrolujte svou odpověď na choices pole.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Zpracování streamovaných odpovědí

Povolte streamování pro nižší latenci a výstup v reálném čase. Nastavte stream: true ve vaší žádosti. API odesílá chunky prostřednictvím Server-Sent Events. Můžete zpracovávat každý token ihned po jeho příchodu. Je to ideální pro chatová rozhraní nebo scénáře roleplay. Poslední chunk obsahuje statistiky využití.

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)

5. Konfigurace parametrů

Upravit temperature, top_p, a stop sekvence. Tyto ovládací prvky ovlivňují kreativitu a délku výstupu. Můžete také použít response_format pro režim JSON. Okno kontextu podporuje celkem 100,000 tokenů. Max výstup je 16,000 tokenů na požadavek. Vyladěte tato nastavení pro váš konkrétní případ použití.

6. Limity, chyby a kontext

Chyby zpracovávejte elegantně pomocí standardních stavových kódů HTTP. Chyba 401 znamená, že váš API klíč je neplatný. Chyba 402 indikuje nedostatek předplaceného kreditu. Chyba 429 signalizuje, že jste dosáhli limitu 300 požadavků za minutu. Váš kontextový okno má 100 000 tokenů. Požadavky větší než 8 MB mohou selhat. Refundace kreditu se nevydávají, ale chyby jsou zdarma.