Uncenzúrált API gyors kezdési útmutató
Csatlakoztassa ügyfelét hosztolt, OpenAI-kompatibilis API-jához az alap URL és az API-kulcs segítségével. Ez az útmutató az alapvető végpontokat, az adatfolyam-küldést (streaming) és a paramétereket tárgyalja a gyors integráció érdekében.
Hitelesítés és Base URL
Kezdje az SDK irányításával az alap URL-hez, és adja át a kulcsot az authorization fejlécben. Közvetlen, egyetlen modellre épülő szolgáltatást biztosítunk proxy irányítási díjak nélkül. Használja a szabványos Authorization: Bearer sémát a kérések hitelesítésére. Kulcsát azonnal generálja a regisztráció után Google-fiókkal vagy e-maillel. Győződjön meg arról, hogy a helyettesítő kulcsot a kezelőfelületen megjelenő kulcscsal cserélje ki. Az alap URL https://api.uncensoredmodelsollama.com/v1. Ez a végpont támogatja a szabványos OpenAI-kompatibilis klienseket, lehetővé téve a szolgáltató váltását az alkalmazás logikájának átírása nélkül. Tartsa biztonságban a kulcsát, mivel az hozzáférést biztosít az előre fizetett hitel egyenlegéhez.
Chat Completions végpont
Szövegkérések küldése ide /v1/chat/completions endpoint a válaszok generálására. Ez az endpoint kezeli a szabványos beszélgetési előzményeket és rendszerüzeneteket. Meg kell adnia a modell azonosítót mint uncensored a kérés törzsében. Az API JSON formátumú válaszokat ad vissza, amelyek tartalmazzák a generált szöveget és a tokenfelhasználási statisztikákat. A hibák, mint például a elégtelen kredit vagy érvénytelen kulcs, megfelelő HTTP státuskódokkal térnek vissza. Használd ezt a végpontot minden szabványos szöveggenerálási feladathoz. Nem támogatja az embeddingeket, képeket vagy finomhangolást. Tartsd a payloadodat 8 MB alatt a megbízható feldolgozás érdekében. A modell a bemeneti és kimeneti tokeneket egy megosztott kontextusablakon belül dolgozza fel.
Streamelési válaszok
A streamelés engedélyezéséhez állítsa a stream paramétert true-ra a kérésben. Az API Server-Sent Events (SSE) formátumban ad vissza szöveg incremental darabokat. Ez a megközelítés csökkenti az észlelt késleltetést a hosszú kimeneteket váró felhasználók számára. A tokenfelhasználási információt a stream utolsó darabjában kapja meg. Implementáljon egy stream kezelőt az ügyféloldalon ezeknek az eseményeknek a hatékony feldolgozásához. A streamelés ideális chat felületekhez és valós idejű alkalmazásokhoz. Győződjön meg róla, hogy az ügyfélkönyvtár támogatja az SSE parselést a folyamatos adatfolyam helyes kezeléséhez. A teljes kontextusablak 100,000 token marad streamelési módtól függetlenül.
Függvényhívás é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 funkcióit a kérelem törzsében, hogy lehetővé tegye a modell számára a strukturált adatok visszaadását. Állítsa response_format a {"type": "json_object"} a szigorú JSON kimenethez. Ez a funkció hasznos adatok kinyeréséhez vagy strukturált payloadok generálásához. A modell támogatja az eszközválasztási paramétereket a függvényhívás viselkedésének vezérléséhez. Használja ezeket a funkciókat az API integrálásához automatizált munkafolyamatokba. Győződjön meg róla, hogy a függvénydefiníciói megfelelnek a vártnak az input sémának a megbízható eredmények érdekében. Az API a szabványos OpenAI formátumban adja vissza az eszközhívásokat a könnyű feldolgozás érdekében.
Paraméterek és sorkorlátok
Állítsd be a generálási viselkedést a következő paraméterekkel: temperature, top_p, és seed. Állítsa be max_tokens a kimeneti hosszának korlátozására, alapértelmezés szerint 2 048-ra, ha meg nem adja. Az API percenkénti 300 kérésre vonatkozó sebességkorlátot alkalmaz kulcsonként. A párhuzamos kérések kulcsonként 8-ra vannak korlátozva. Ha túllépi ezeket a korlátokat, az API 429 státuskódot ad vissza. A kérések a tényleges tokenfelhasználás alapján kerülnek számlázásra, a hibák és elutasítások ingyenesek. A hitel nem jár le, az előre fizetett összegek átláthatóak. Kezelje kulcsait gondosan, mivel minden fiók csak egy aktív kulcot támogat egyszerre.
Korlátok, hibák és kontextus
A kontextusablak 100 000 token támogatását biztosítja a kombinált bemenet és kimenet esetén. A 8 MB-os törzsméret-korlátot meghaladó kérések sikertelenek lesznek. A gyakori hibák között szerepel a 401 az érvénytelen kulcsok, és a 402 a elégtelen hitel esetén. Kezelje ezeket a hibákat gracefully az alkalmazás logikájában. Az API visszautasítja a kiskorúakkal kapcsolatos szexuális tartalmat tartalmazó kéréseket, függetlenül a többi beállítástól. A többi tartalom cenzúrázatlan marad jogszerű felnőtt felhasználás esetén. Kövesse nyomon a tokenfelhasználást a váratlan költségek elkerülése érdekében. Az előre fizetett hitelrendszer biztosítja, hogy csak a felhasznált mennyiség után fizessen. Nincs előfizetési díj vagy rejtett költség az integrációjában.
cURL
curl https://api.uncensoredmodelsollama.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List all available models in the ollama library."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredmodelsollama.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.uncensoredmodelsollama.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 uncensored modellek ollama base URL-je?
Az alap URL: HTTPS://api.uncensoredmodelsollama.com/v1. Használd ezt a végpontot bármely OpenAI-kompatibilis SDK-val a base_url konfiguráció frissítésével. Ez az URL közvetlenül szolgálja ki a egyetlen uncensored modellt proxy irányítás nélkül.
Hogyan kezelje a streamelt válaszokat Pythonban?
Állítsa be a stream paramétert true értékre a kérésben. Az API Server-Sent Events formátumban ad vissza fokozatos szövegdarabokat. Feldolgozza ezeket az eseményeket az SDK stream kezelőjével a valós idejű kimenet megjelenítéséhez. A token-használati adatok a stream végső darabjában állnak rendelkezésre.
Mi történik, ha túllépem a sebességkorlátot?
Az API 429 státuskódot ad vissza, ha meghaladja a percenkénti 300 kérést vagy a 8 párhuzamos kérést. A kulcs aktív marad, de a további kérések addig sikertelenek lesznek, amíg a sebességi ablak újraindul. Figyelje a felhasználást az alkalmazás munkafolyamatának megszakadásának elkerülése érdekében.
Szerezze meg a kulcsát egy lépésben.
Regisztrálj, másold ki a kulcsot, frissítsd az alap URL-t. Elkészült.