API dokumentáció cenzúratlan chat completions-hoz

Gyors beállítások: Csatlakozás Pythonban vagy JavaScriptben

Csatlakozzon az API-hoz a base URL frissítésével és az API-kulcs beállításával. A végpont elfogadja a szabványos chat-completion kéréseket, és szöveget ad vissza. Nem kell egyedi könyvtárakat telepítenie, ha az hivatalos OpenAI SDK-kat használja, mivel a felület pontosan megfelel a specifikációjuknak.

Kezdje egy egyszerű HTTP kéréssel a kapcsolódás ellenőrzéséhez. Használja az alábbi curl parancsot egy alapvető prompt küldéséhez a uncensored modell. Cseréld ki YOUR_API_KEY a műszerfalán generált kulccsal.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Python fejlesztőknek a folyamat szinte azonos. Inicializáld a klienst a kulcsoddal és a helyes alap URL-vel. Ez biztosítja, hogy minden kérés az uncensored szervereinkre irányuljon, miközben megőrzi a kompatibilitást a meglévő eszköztárral.

Copyfrom openai import OpenAI

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

A JavaScript felhasználók ugyanazt az eredményt érhetik el a Node SDK segítségével. Állítsa be a baseURL tulajdonságot a végpontunkra. Ez a megközelítés lehetővé teszi az API webkiszolgálókba vagy háttérszolgáltatásokba történő integrálását minimális kódváltoztatásokkal.

Copyimport OpenAI from "openai";

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

Hitelesítés és API-kulcs kezelés

A hitelesítés egy a fejlécben átadott egyetlen API-kulcsra támaszkodik. Adja át ezt a kulcsot a Authorization fejléc minden kéréshez. Ha a kulcs hiányzik vagy érvénytelen, az API azonnal 401-es hibát ad vissza. Ez biztosítja a előre fizetett kredit biztonságos hozzáférését.

Generálja le a kulcsát a műszerfalon. A kulcs létrehozáskor egyszer jelenik meg. Tárolja biztonságban a környezeti változókban. Ne ossza meg nyilvánosan. Minden fiók egyszerre csak egy aktív kulcsot támogat. Az új kulcs generálása azonnal érvényteleníti az előzőt.

Használja a kulcsot a kéréseiben így: Authorization: Bearer YOUR_API_KEY. Ez a szabványos fejlécformátum minden nagy SDK-val működik. Tartsa kéznél a kulcsot a gyors iterációhoz fejlesztés közben.

Chat Completions végpont paraméterei

Küldjön kéréseket a /v1/chat/completions endpoint. Tartalmazza az üzenetek tömbjét, és állítsa be a modellt uncensored. Beállíthatja a következő paramétereket: temperature és top_p a kreativitás vezérléséhez. A magasabb értékek változatosabb válaszokat eredményeznek.

Beállítás max_tokens a kimeneti hosszának korlátozására. Az alapértelmezett érték 2 048 token, ha meg nem adja. A modell 100 000 tokenes kontextus ablakot támogat prompt plusz kiegészítés esetén. Ez lehetővé teszi a hosszú beszélgetések levágás nélküli kezelését. Állítsa be presence_penalty és frequency_penalty ismétlődés csökkentésére szerepjáték-szenáriókban.

Használja a stop paraméter a generálás leállítására meghatározott kifejezéseknél. Ez segít a párbeszédstruktúra kikényszerítésében. A seed parameter ensures reproducible outputs for testing. These tools give you precise control over the model's behavior.

A streamelt válaszok és a használati adatok

Engedélyezze a streamelést úgy, hogy stream: true a kérésben. Az API szövegdarabokat ad vissza generálás közben. Ez csökkenti az észlelt késleltetést a végfelhasználók számára. Minden darab részleges szöget és metaadatokat tartalmaz.

A használati adatok az utolsó chunk-ban jelennek meg. Ez tartalmazza a bemeneti és kimeneti tokenek számát. Ellenőrizze a usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Kezelje óvatosan a stream végrehajtását. Győződjön meg arról, hogy minden darabot feldolgoz a kapcsolat bezárása előtt. Az utolsó darab tartalmazza a teljes felhasználási statisztikát. Ez az adat elengedhetetlen a költségek és a teljesítmény monitorozásához a termelési alkalmazásokban.

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)

Hibakezelés és sebességkorlátok

Az API percenként 300 kérésre és kulcsonként nyolc párhuzamos kérésre szabja a limitet. A kéréstörzs nem haladhatja meg a 8 MB-ot. A limitek túllépése 429-es hibát eredményez. Implementáljon exponenciális backoffot a átmeneti csúcsok kezeléséhez.

A gyakori hibák közé tartozik a 401 az érvénytelen kulcsokért és a 402 az elégtelen hitelért. A 402-es válasz azt jelzi, hogy az előre fizetett egyenleg kimerült. Töltse fel a fiókját a szolgáltatás folytatásához. A hibák nem fogyasztják a tokeneket, így a hiba javítása utáni újrapróbálkozás ingyenes.

Nézd meg a válasz törzsét a részletes hibauzenetekért. Az API egy JSON objektumot ad vissza hibatípussal és üzenettel. Használd ezt az információt a problémák gyors hibaelhárításához. A megfelelő hibakezelés biztosítja a zökkenőmentes élményt a felhasználók számára nagy forgalmi időszakokban.

JSON mód és függvényhívás útmutató

Használjon JSON módot a beállítással response_format a {"type": "json_object"}. Ez kényszeríti a modellt, hogy érvényes JSON-t adjon vissza. Ideális strukturált adatok kinyeréséhez vagy API-válaszokhoz. Győződj meg róla, hogy a promptod egyértelműen leírja a kívánt sémát.

A function calling lehetővé teszi, hogy a modell eszközöket hívjon meg. Határozza meg az eszközöket a kérés törzsében. A modell eszköz-hívásokat ad vissza, ha szükséges. Kezelje ezeket a hívásokat az alkalmazás logikájában. Ez lehetővé teszi a komplex, több lépéses munkafolyamatokat.

Kombinálja a JSON módot a function callinggal a robusztus integrációkhoz. Érvényesítse a JSON kimenetet a kliens oldalon. Használja a tool_choice paraméter annak vezérlésére, hogy mikor hívják meg a funkciókat. Ez a rugalmasság támogatja a különböző alkalmazásarchitektúrákat. Győződjön meg arról, hogy eszközei jól definiáltak a legjobb teljesítmény érdekében.

Modell részletek és kontextus ablak korlátok

A uncensored a modell 100 000 tokenes kontextusablakot támogat. Ez magában foglalja a bemeneti promptot és a kimeneti kiegészítést is. A kimenet maximuma 16 000 token kérésenként. Ez lehetővé teszi a kiterjedt szerepjáték-szenáriókat anélkül, hogy közbeszakadna a mondat.

A modell nyers súlyú, és a korlátlan tartalomra van hangolva. Nem utasítja el a jogi felnőtt témákat. Nem GPT, Claude vagy bármely más szolgáltató modellje. A kéréseket dedikált szervereinkön dolgozzuk fel. Ez biztosítja a konzisztens teljesítményt és az alacsony késleltetést.

Figyelje a kontextusfelhasználást, hogy maradjon a határokon belül. Az API pontosan nyomon követi a tokenfelhasználást. A hibák és a visszautasítások nem fogyasztanak tokeneket. Ez az átlátható számlázási modell segít előre jelezni a költségeket. Tervezze meg a kontextusablakait a maximális érték érdekében.