hu ▾

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.

Kezdj most