Ollama végpont API dokumentáció
Kezdje el a fejlesztést uncensored LLM API-junkal másodpercek alatt. Ez az útmutató az alap URL-t, az autentikációt és az SDK-integrációt tárgyalja az OpenAI-kompatibilis API munkafolyamataihoz.
Base URL és Hitelesítés
Használja a megadott alap URL-címet és egy API-kulcsot minden kéréshez. Az endpoint https://api.ollamaendpoint.com/v1Hitelesítés fejlec Bearer tokenként. Ezt a kulcsot azonnal megkapja Google-fiókkal vagy e-mail címmel történő bejelentkezés után. A kulcs egyedi minden fiókhoz, és felváltja az összes korábbi aktív kulcsot.
Első kérés
Küldjön egy szabványos chat completion kérést szöveggeneráláshoz. A modell azonosítója uncensored és elfogadja ugyanazokat a paramétereket, mint a szabványos OpenAI kliensek. Ez működik NSFW LLM feladatokhoz vagy korlátlan tartalomgeneráláshoz.
- Módszer: POST
- Végpont:
/v1/chat/completions - Modell:
uncensored
curl https://api.ollamaendpoint.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Get the local ip address of this machine"}]
}'
A sikeres válasz a generált szöveget adja vissza a choices tömbben. Ellenőrizze a usage mező a token számok megtekintéséhez.
Python SDK Integráció
Telepítse a hivatalos OpenAI könyvtárat, és állítsa be a bázis URL-csontot. Ez lehetővé teszi az uncensored ollama modell használatát jól ismert Python kóddal. Állítsa be a base_url és api_key az ügyfél inicializálása előtt. A kód kompatibilis marad a meglévő OpenAI SDK-kkal.
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamaendpoint.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)
Hívd meg a chat.completions.create módszer, ahogy a GPT esetén is tenné. A válasz struktúrája megfelel a szabványos elvárásoknak. Streamelhet vagy teljes válaszokat kaphat.
Node SDK integráció
Használja a Node.js OpenAI csomagot az API-val való kapcsolathoz. Konfigurálja a klienst a saját alap URL-lel és API-kulcsával. Ez a megközelítés server-oldali alkalmazásokhoz vagy edge függvényekhez működik. A csomag automatikusan kezeli a szerializálást és az újrapróbálkozást.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ollamaendpoint.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);
Hívjd meg a completion végpontot a prompttal. A könyvtár egy Promise-t ad vissza, amely a válaszobjektumra oldódik fel. Kezeld a hibákat a szabványos HTTP státuskódok szerint.
Streamelési válaszok SSE-vel
Engedélyezze a streamelést úgy, hogy stream: true a kérésben. A szerver Server-Sent Events (SSE) streamet ad vissza. Minden töredék részleges szöveget és token-használati adatokat tartalmaz. Az utolsó töredék tartalmazza a teljes használati statisztikát a számlázás számára. Ez csökkenti az érzékelt késleltetést a hosszú kimenetek esetén.
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)
Halmozd össze a darabok tartalmi részeit a teljes válasz visszaállításához. Feldolgozd a hibákat, ahogy azok megérkeznek a streamben. Az utolsó darab megerősíti a token számát a előre fizetett egyenlegedhez.
Sebességkorlátok és korlátok
Minden API-kulcs percenként 300 kérésre és 8 egyidejű kérésre képes. A maximális kérés törzsének mérete 8 MB. A kontextusablak 100,000 token, prompt és completion együtt. A kimeneti korlátok 16,000 token kérésenként. A hibák és elutasítások nem fogyasztanak hitelt. A 401-es hiba azt jelenti, hogy a kulcs érvénytelen. A 402-es hiba elégtelen előre fizetett hitelt jelez. A 429-es hiba azt jelenti, hogy elérte a sebességkorlátot. Állítsa be az egyidejűséget a korlátok betartásához.
GYIK
Mi az alap URL az ollama végponthoz?
Az alap URL: HTTPS://api.ollamaendpoint.com/v1. Használd ezt az összes API-híváshoz. Kompatibilis a szabványos OpenAI kliensekkel.
Hogyan kezelje a streamelt válaszokat?
Állítsa be a stream paramétert true értékre. Az API Server-Sent Events formátumban ad vissza adatot. Feldolgozza minden darabot a végső szöveg összeállításához. Az utolsó darab tartalmazza a felhasználási adatokat.
Mi történik, ha sebességkorlátba ütközöm?
429-es státuskódot kapsz. A korlát kulcsonként percenként 300 kérés. Csökkentsd a párhuzamosságot, vagy várj a próbálkozás előtt. A párhuzamos kérések száma 8-ra van korlátova.
Szerezze be az API-kulcsát
Jelentkezz be, szerezz kulcsot, és irányíts az új base URL-re. Kész.