Instalace a konfigurace
Začněte instalací oficiálního SDK pro váš jazyk. Klient vyžaduje pouze váš klíč API a správnou základní URL pro směrování požadavků na naše servery. Toto nastavení funguje s jakýmikoli standardními klienty kompatibilními s OpenAI.
Nastavte proměnné prostředí nebo je předejděte přímo do konstruktoru klienta. Nemusíte spravovat komplexní logiku směrování ani přepínat mezi více modely. Jeden model uncensored zpracovává všechny požadavky.
- Nainstalujte balíček pomocí správce balíčků.
- Získejte API klíč z panelu.
- Směřujte klienta na endpoint API.
Vytvoření prvního požadavku
Odešlete požadavek POST na koncový bod chat completions s ID modelu nastaveným na "uncensored". To vrátí přímou textovou odpověď z modelu, která obchází standardní filtry obsahu. Můžete odesílat jednoduché prompty nebo složité systémové instrukce.
API přijímá standardní parametry jako temperature a top_p. Pomocí následujícího příkazu cURL okamžitě ověřte připojení a kvalitu odpovědi.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'Tato odpověď potvrzuje, že je model aktivní a připraven pro produkční provoz.
Zvládání streamovaných odpovědí
Povolte streamování nastavením parametru stream na true. API vrací stream server-sent events (SSE), který dodává tokeny, jak jsou generovány. To výrazně snižuje vnímanou latenci pro koncové uživatele.
Parsovejte části SSE pro aktualizaci uživatelského rozhraní v reálném čase. Poslední část zahrnuje celkové využití tokenů pro požadavek. Tento přístup je zásadní pro chatová rozhraní, kde uživatelé očekávají okamžitou zpětnou vazbu.
stream = 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)Ujistěte se, že váš klient správně zpracuje událost ukončení streamu.
Použití nástrojů a volání funkcí
Definujte nástroje v těle žádosti, abyste umožnili modelu výstupovat strukturovaná volání funkcí. Předáte definice nástrojů v poli tools a specifikujte tool_choice pro automatický výběr. Model vrací volání funkcí v obsahu odpovědi.
Parsovejte argumenty funkce a proveďte je ve vašem kódu. Poté výsledky předajte modelu v dalším požadavku. Tento cyklus umožňuje složité vícekrokové pracovní postupy bez externí logiky pro parsování.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);Vždy validujte schéma výstupu před provedením.
Správa tokenů a limitů
Okno kontextu podporuje 100 000 tokenů pro prompt i dokončení dohromady. Každá žádost může vrátit až 16 000 tokenů, nebo 2 048, pokud je vynechán parametr max_tokens. Sledujte své využití pomocí počtu tokenů v odpovědi.
Omezení rychlosti umožňují 300 požadavků za minutu a 8 souběžných požadavků na klíč. Překročení těchto limitů spustí chybu 429. Udržujte svůj klíč unikátní pro každý účet, abyste se vyhnuli sdílení limitů.
Chyby jako 401 indikují neplatný klíč, zatímco 402 znamená, že potřebujete více kreditu. Odmítnutí kvůli drobným porušením obsahu je zdarma a nespotřebovává tokeny.
Zpracování chyb a řešení problémů
Zvládněte chyty HTTP plynule v logice vaší aplikace. Stav 401 znamená, že váš API klíč je nesprávný nebo vypršel. Zkontrolujte na dashboardu, zda je klíč aktivní.
Stav 402 znamená nedostatek předplacených kreditů. Dobijte pomocí USDT nebo USDC a obnovte službu. Chyba 429 signalizuje, že jste překročili limit rychlosti. Počkejte a zkuste to znovu s exponenciálním zpomalováním.
Neplatná těla požadavků vracejí chybu 400. Ověřte, zda struktura vašeho JSON odpovídá specifikaci API. Tyto chyby jsou zdarma a neodečítají se z vašeho zůstatku.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)