GitHub Uncensored AI API Referencia
Integrálja az uncensored LLM-t alkalmazásaiba egy szabványos OpenAI-kompatibilis végponttal. Azonnali szöveggenerálást kap tartalom szűrők nélkül, előre fizetett kriptó számlázással és 100,000 tokenes kontextus ablakkal.
Hitelesítés & Base URL
Az API bearer tokent igényel minden kéréshez. Ezt a kulcsot azonnal generálhatja az irányítópulton keresztül Google-fiókkal vagy e-mail hitelesítő adatokkal. Létrehozása után a kulcs hitelesíti előre fizetett fiókját a hosztolt modell ellen.
Állítsd a base URL-t közvetlenül az API-kapuhoz. Ez biztosítja, hogy minden kérés a megfelelő uncensored modell szerverre irányuljon.
Használja a szabványos Authorization fejlécet Bearer sémával. Cserélje ki a helyőrzőt egyedi kulcs sztringre.
Base Konfiguráció
- Base URL:
https://api.githubuncensoredai.com/v1 - Auth fejléc:
Authorization: Bearer YOUR_API_KEY - Modell ID:
uncensored
curl https://api.githubuncensoredai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
}'
Chat Completions végpont
Szövegadatok küldése a chat-kiegészítések végpontra, és generált szöveg fogadása válaszként. A rendszer üzenetlistát fogadad, amelyek szerepei például user vagy assistant. A prompt előzményei alapján kiegészítést ad vissza.
Ez a végpont szabványos párbeszéd-folyamatokat kezel. Több fordulót küldhet, és a modell megőrzi a kontextust a limitig. Nem támogat képeket, hangot vagy videó bemenetet. A válasz formátuma szabványos JSON.
Győződjön meg arról, hogy a payload tartalmazza a modell azonosítót. A rendszer kegyesen figyelmen kívül hagyja az ismeretlen mezőket. A hibák specifikus kódokat adnak vissza hitelesítési hiba vagy hitelkeret kifogyása esetén.
from openai import OpenAI
client = OpenAI(base_url="https://api.githubuncensoredai.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)
Streamelési válaszok
A streamelés engedélyezéséhez állítsa a stream flaget true értékre. Az API egy sor Server-Sent Events formátumban ad vissza adatot, egyetlen JSON objektum helyett. Minden esemény egy chunkot tartalmaz a generált szövegből.
Ez a megközelítés csökkenti a hosszú válaszok észlelt késleltetését. A szöveg megjelenítését már a generálás közben elkezdheted a felhasználók számára. Az utolsó darab tartalmazza a token-felhasználási statisztikákat a számlázáshoz.
Kezelje a streamet hatékonyan a kliens kódban. Zárja be a kapcsolatot, amikor a stream véget ér, vagy hiba lép fel. Ez a módszer jól működik valós idejű chat felületekhez.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.githubuncensoredai.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);
Funkcióhívás & JSON Mode
A modell támogatja a strukturált kimenetet függvényhíváson keresztül. Definiáljon eszközöket a kérésben névvel, leírással és paraméter sémákkal. A modell kiválasztja a megfelelő eszközt és generálja az argumentumokat.
Használjon JSON módot a szigorú séma-megfeleléshez. Állítsa be a válasz formátumát json_object-ra az érvényes JSON kényszerítéséhez. Ez hasznos adatok elemzéséhez vagy kódrészletek generálásához.
Kombinálja a function callingt a streameléssel az interaktív élményekhez. A modell több eszközt is meghívhat sorozatban. Érvényesítse a kimeneti sémát a függvények végrehajtása előtt az alkalmazás logikájában.
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)
Paraméterek & Korlátok
Generálási viszony szabályozása a temperature és top_p paraméterekkel. Állítsa be ezeket az értékeket a kreativitás és a determinizmus egyensúlyának megőrzéséhez. Az alapértelmezett beállítások a legtöbb általános célhoz megfelelőek.
Tartsd be a kéréskorlátokat a hibák elkerülése érdekében. Kulcsonként percenként 300 kérést küldhetsz. A párhuzamos kérések kulcsonként nyolcban vannak korlátozva. A maximális kéréstörzs mérete 8 MB.
A kontextus ablak 100,000 tokenre terjed. Ez magában foglalja a prompt és a kiegészítés tokeneket. A kimenet 16,000 tokenre van korlátozva kérésenként. Ezeknek a limitnek a túllépése hibakódot ad vissza.
Token használat és számlázás
A számlázás előre fizetett és a tényleges tokenhasználaton alapul. A bemeneti tokenek millió után $0.15-öt, a kimeneti tokenek millió után $0.50-t költenek. A hibák és a visszautasítások nem merítik a hitelet.
A hitel nem jár le. A feltöltések kizárólag kriptovalutával feldolgozhatók. Nagyobb befizetések esetén bónusz hitelt kap. A rendszer pontosan nyomon követi a felhasználást minden API-kulcs esetén.
Kövesse nyomon az egyenlegét a műszerfalon. Ha a hitelek elfogynak, a kérések egy specifikus hibakóddal sikertelenek lesznek. Azonnali pénzeszköz hozzáadása a szolgáltatás folytatásához jóváhagyásra várás nélkül.
Gyakori kérdések
Hogyan kezelje a hitelesítési hibákat?
Ha 401-es hibát kap, az API-kulcsa érvénytelen vagy lejárt. Ellenőrizze a műszerfalon, hogy a kulcs aktív-e. Szükség esetén generáljon újra egy kulcsot. Győződjön meg arról, hogy a helyes base URL-t és fejlécformátumot használja.
Mi történik, ha elfogynak a hitelezési egységek?
A kérések 402 hibát adnak vissza, amely elégtelen alapokat jelez. Ezekben a sikertelen kísérletekben nem kerülnek felszámításra tokenek. Töltse fel a kriptoegyenlegét, hogy azonnal folytathassa a szolgáltatást. A kreditek nem járnak le, így bármikor tölthet fel pénzt.
Az API sebességkorlátozott?
Igen, percenként 300 kérésre és kulcsonként 8 párhuzamos kérésre vagy korlátozva. Ezek túllépése 429-es hibát eredményez. Streamelés használatával csökkentheted a hosszú válaszokhoz szükséges kérések számát. Kövesd nyomon a felhasználásodat a throttling elkerülése érdekében.
Generálja meg a kulcsát másodpercek alatt
Regisztrálj, szerezz kulcsot, és frissítsd a base URL-t. Kész.