Telepítés és konfiguráció
Kezdje a hivatalos SDK telepítésével a nyelvéhez. A kliensnek csak az API-kulcsra és a helyes base URL-re van szüksége a kérések szervereinkhez való irányításához. Ez a beállítás bármely szabványos OpenAI-kompatibilis klienssel működik.
Konfigurálja a környezeti változókat, vagy adja át őket közvetlenül az ügyfél konstruktorának. Nem kell bonyolult útválasztási logikát kezelnie, vagy több modell között váltania. Az egyetlen uncensored modell kezeli az összes kérést.
- Telepítse a csomagot a csomagkezelőjén keresztül.
- Állítsa be az API kulcsot a kezelőfelületről.
- Irányítsa a klienst az API végpontra.
Az első kérés végrehajtása
Küldjön egy POST kérést a chat completions végpontra a modellazonosító "uncensored" beállításával. Ez közvetlen szöveges választ ad a modelltől, megkerülve a szabványos tartalmi szűrőket. Egyszerű promptokat vagy összetett rendszerutasításokat is küldhet.
Az API elfogadja a szabványos paramétereket, mint például a temperature és a top_p. Használd a következő cURL parancsot a kapcsolódás és a válaszminőség azonnali ellenőrzéséhez.
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."}]
}'Ez a válasz megerősíti, hogy a modell aktív és készen áll a termelési forgalom kezelésére.
Streamelt válaszok kezelése
A streamelés engedélyezéséhez állítsa a stream paramétert true értékre. Az API server-sent events (SSE) streamet ad vissza, amely tokeneket szolgáltat generáláskor. Ez jelentősen csökkenti a végfelhasználók számára észlelt késleltést.
Elemzze az SSE blokkokat a felhasználói felület valós idejű frissítéséhez. A végső blokk tartalmazza a kérés összes tokenfelhasználását. Ez a megközelítés elengedhetetlen a chat felületekhez, ahol a felhasználók azonnali visszajelzést várnak.
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)Győződjön meg arról, hogy az ügyfél helyesen kezeli a stream végződési eseményt.
Eszközök és function calling használata
Határozza meg az eszközöket a kérésben, hogy lehetővé tegye a modell számára a strukturált kimenetet. Adja meg az eszközdefiníciókat a tools tömbben, és adja meg a tool_choice paramétert az automatikus kiválasztáshoz. A modell függvényhívásokat ad vissza a válasz tartalmában.
Elemzés a függvény argumentumait és végrehajtásuk a kódjában. Ezután adja vissza az eredményeket a modellnek egy későbbi üzenetben. Ez a ciklus lehetővé teszi a komplex többlépcsős munkafolyamatokat külső elemzési logika nélkül.
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);Mindig validálja a kimeneti sémát végrehajtás előtt.
Tokenek és korlátok kezelése
A kontextusablak 100 000 token támogatását biztosítja prompt és kiegészítés együttesen. Minden kérés maximum 16 000 token kimenetet generálhat, vagy 2 048-at, ha a max_tokens paraméter nincs megadva. Kövesse a használatát a token számok alapján a válaszban.
A sebességkorlátok percenként 300 kérelemet és 8 párhuzamos kérést tesznek lehetővé kulcsonként. Ezek túllépése 429-es hibát vált ki. Tartsa egyedi kulcsot minden fiókhoz a korlátok megosztásának elkerülése érdekében.
A 401 az érvénytelen kulcsot jelzi, míg a 402 azt jelenti, hogy több kreditre van szüksége. A minimális tartalmi megsértések miatti visszautasítások ingyenesek és nem fogyasztanak tokeneket.
Hibakezelés és hibaelhárítás
Kezelje gracefully a HTTP hibákat az alkalmazás logikájában. A 401-es státusz azt jelenti, hogy az API-kulcsa helytelen vagy lejárt. Ellenőrizze a műszerfalon, hogy a kulcs aktív-e.
A 402-es státusz a nem elegendő előre fizetett kreditet jelzi. Töltse fel a kreditjét USDT vagy USDC segítségével a szolgáltatás folytatásához. A 429-es hiba azt jelzi, hogy elérte az átfogási limitet. Várjon, és próbálja újra exponenciális backoff segítségével.
Az érvénytelen kérelemtestek 400 hibát adnak vissza. Ellenőrizd, hogy a JSON struktúrád megfelel-e az API specifikációnak. Ezek a hibák ingyenesek és nem vonnak le egyenleget.
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)