Integrálja az uncensored API-t gyorsan
Kezdje el az uncensored AI API használatát perceken belül azáltal, hogy meglévő OpenAI-kompatibilis kliensét az alap URL-re mutatja. Ez a gyors kezdő útmutató tartalmazza a hitelesítést, a chat completions-t, a streamelést és az eszköz hívást konkrét példákkal.
Hitelesítés és base URL
Igen, azonnal hitelesíthetsz a dashboardon megadott base URL segítségével. Szolgáltatásunk standard API kulcs fejléceket használ, amelyek kompatibilisek bármelyik OpenAI SDK-val. A kulcsodat azonnal megkapod Google vagy e-mail regisztráció után. A kezdeti beállításhoz nem szükséges telefonszám.
Állítsa be a base_url a https://api.isgrokuncensored.com/v1. Adja át a kulcsát a Authorization header. A rendszer hitelesíti a hitelesítő adatokat a tokenek feldolgozása előtt. A 401-es hiba érvénytelen vagy hiányzó kulcsra utal. Ellenőrizze a műszerfalat, ha a kulcs nem működik.
Chat completions végpont
Küldj egy POST kérést a /v1/chat/completions szövegválaszok kérésére. A végpont elfogadja a szabványos üzenettömböket, és generált szöveget ad vissza. Nem támogat képeket, hangot vagy beágyazásokat. Használja a modellsazonosítót uncensored az összes kéréshez. Ez biztosítja, hogy a megfelelő nyílt forráskódú modellt használod.
A bemeneti tokenek ára $0.15 millió tokenenként, a kimeneti tokeneké pedig $0.50 millió tokenenként. Az előre fizetett hitel csak a tényleges felhasználás után merül fel. A hibák és a visszautasítások nem merítik a keretét. Kérésenként legfeljebb 8 MB testet küldhet. Ez a limit a legtöbb szabványos szöveges interakciót lefedi.
A streamelt válaszok és a token használat
Engedélyezze a streamelést úgy, hogy stream a true a kérésben. Server-Sent Events (SSE) formátumban kapsz valós idejű token kézbesítést. A végleges darab tartalmazza a teljes token-felhasználási statisztikát. Ez lehetővé teszi a költségek valós idejű nyomon követését. Elengedhetetlen reszponzív chat felületek építéséhez.
Elemzze az SSE adatokat a felhasználói felület fokozatos frissítéséhez. A modell folyamatosan generál szöveget, amíg a kontextusablak megtelik, vagy egy leállítási szekvencia aktiválódik. A kimenet maximuma 16,000 token kérésenként. Meg kell adnia max_tokens az alapértelmezett 2 048 token túllépéséhez. Ez megakadályozza a váratlan számlázást hosszú válaszok esetén.
Function calling és JSON mód
Használja a tools paraméter a funkcióhívási képességek engedélyezésére. Határozza meg eszközsémáját a kérelem törzsében. A modell strukturált argumentumokat ad vissza funkcióihoz. Ez zökkenőmentesen működik a szabványos OpenAI-kompatibilis kliensekkel. JSON kimenetet is kikényszeríthet response_format. Ez hasznos a strukturált adatok feldolgozásához.
Beállítás response_format a {"type": "json_object"} tiszta JSON kérésére. Ez a mód letiltja a beszélgetési kitöltő szövegeket. Ideális programozott integrációkhoz. Kombinálhatja az eszközöket és a JSON módot összetett munkafolyamatokhoz. Az API a parsingot belsőleg kezeli. Önnek csak a kimeneti struktúra érvényesítésére van szüksége.
Modell paraméterek: hőmérséklet és top_p
Beállítás temperature a véletlenszerűség vezérlését. Magasabb értékek kreatívabb kimeneteket eredményeznek. Az alacsonyabb értékek meghatározottabbá teszik a válaszokat. Az alapértelmezett érték általában 1,0. 0 és 2 között állíthatja be. Használja top_p nukleáris mintavételezéshez. Ez korlátozza a figyelembe vett tokenek valószínűségi tömegét. A hőmérséklettel együtt működik a kimeneti minőség finomhangolásához.
További támogatott paraméterek: stop szekvenciák, seed a reprodukálhatósághoz, és az olyan büntetéseket, mint presence_penalty. Ezek a generálási folyamat finomhangolását teszik lehetővé. Kísérletezhet különböző kombinációkkal. Az API tiszteletben tartja az összes szabványos OpenAI paramétert. Ez biztosítja a könnyű migrálást más szolgáltatóktól. Teszteljen különböző értékeket, hogy megtalálja a legjobb illeszkedést az eseteihez.
Korlátok, hibák és kontextus ablak
A kontextusablak 100 000 tokent tesz lehetővé. Ez magában foglalja a prompt és a kiegészítés tokenjeit is. Nagy dokumentumokat küldhetsz elemzésre. A sebességkorlátok kulcsonként percenként 300 kérést tesznek lehetővé. A párhuzamosság 8 egyidejű kérésre van korlátozva. Ezeket a korlátokat meghaladó kérések 429-es hibát adnak vissza. Próbáld újra exponenciális backoff-pal.
Kezeld gracefully a hibákat a kódodban. A 402-es hiba azt jelenti, hogy az előre fizetett hitel kimerült. Töltsd fel kriptovalutával a szolgáltatás folytatásához. A 401-es hiba hitelesítési problémát jelez. Ellenőrizd a kulcs érvényességét. Az API nem számít fel díjat a validációs hibák miatt bekövetkező sikertelen kérésekért. Ez védi a egyenlegedet a véletlenszerű csúcsoktól.
cURL
curl https://api.isgrokuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return the current UTC timestamp"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.isgrokuncensored.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgrokuncensored.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);Streamelés
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)Gyakran ismételt kérdések
Mi az alap URL az uncensored AI API-hoz?
Az alap URL: HTTPS://api.isgrokuncensored.com/v1. Ezt be kell állítania az OpenAI-kompatibilis SDK konfigurációjában. Az alapértelmezett OpenAI végpontot helyettesíti. Ez biztosítja, hogy a kérések a mi szervereinkre kerüljenek. Az URL támogatja a streamelő és nem streamelő kéréseket is. Használja minden chat completionhez.
Hogyan kezelje a streamelt válaszokat az uncensored LLM-mel?
Állítsa be a stream paramétert true értékre a kérésben. Server-Sent Events (SSE) formátumban kap részleges szöveget. Elemezze minden darabot a felület frissítéséhez. Az utolsó darab tartalmazza a token-használati adatokat. Ez lehetővé teszi a generált szöveg valós idejű megjelenítését. Hatékó nagy válaszok esetén.
Mi történik, ha túllépem a sebességkorlátot?
429-es státuskódot kapsz. Az API percenként 300 kérést engedélyez kulcsonként. A párhuzamosság 8 egyidejű kérésre korlátozott. Implementálj exponenciális backoffot az ügyféloldalon. Ez megakadályozza a szerver túlterhelését. Próbáld újra a kérést egy rövid késés után. Az API nem számít fel díjat a sebességkorlátozott kérésekért, ha azok érvényesítési hibát okoznak.
Szerezze meg API-kulcsát most
Jelentkezz be, másold ki a kulcsodat, és frissítsd a saját base URL-edet. Ennyi kell csak a konfiguráláshoz.