Gyors bevezetés: Integálja az uncensored API-t

Előfeltételek és SDK telepítés

Az API érvényes API-kulcsot és egy modern SDK-t igényel. Telepítse a könyvtárat a kívánt nyelvhez pip vagy npm segítségével. Támogatjuk a szabványos OpenAI klienskönyvtárakat, amelyek automatikusan kezelik a hitelesítést és a JSON feldolgozást.

Győződjön meg róla, hogy telepítve van a Python 3.8+ vagy a Node.js 18+. Az SDK-k kezelik a kapcsolati pultot és a próbálkozási logikát. Ez jelentősen csökkenti a boilerplate kódot.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ablatedmodels.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)

Az alap URL-cím és az API-kulcs konfigurálása

Irányítsd a kliensedet a saját végpontra. Használd a tárhelyben megadott base URL-t. Add meg az API kulcsodat az Authorization fejlécben. Ez biztosítja, hogy a kérések közvetlenül az uncensored infrastruktúrához érjenek.

Ne használd az alapértelmezett OpenAI alap URL-t. A kulcsod sikertelen lesz, ha helytelenül irányítják. Állítsd be az alap URL-t az SDK konfigurációs objektumban bármilyen adat küldése előtt.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

Az első chat completion kérés küldése

Küldjön egy POST kérést a /v1/chat/completions végpontra. Tartalmazza a modellazonosítót és egy messages tömböt. A modell azonnal szöveges tartalommal válaszol. Nem szükséges komplex routing logika.

Tartsa egyszerűre a payloadt. Kezdje egyetlen rendszer prompttal és egy felhasználói üzenettel. Ellenőrizze, hogy a válasz struktúrája megfelel-e az OpenAI szabványnak. Ez megerősíti, hogy az integráció megfelelően működik.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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);

Streamelt válaszok és eszközhasználat kezelése

A streamelés engedélyezéséhez állítsa a stream paramétert true értékre. Az API Server-Sent Events formátumban ad vissza darabokat. Minden chunk részleges szöveget vagy token-használati adatot tartalmaz. Aggregateálja ezeket a darabokat a valós idejű kimenet megjelenítéséhez.

A tool use támogatott a function callinghoz. Definiálja eszközeit a kérésben. A modell eszköz hívásokat ad vissza, nem pedig sima szöveget, ha megfelelő. Elemzze az eszköz hívásokat a saját logika végrehajtásához.

Copystream = 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)

A tokenkorlátok és a kontextusablak megértése

A kontextusablak 100 000 tokent tesz lehetővé. Ez magában foglalja a bemeneti és kimeneti tokeneket is. Állítsd be a max_tokens paramétert a válasz hosszának korlátozásához. Az alapértelmezett maximális kimenet 2 048 token, ha nincs megadva.

Figyelje a tokenfelhasználást az utolsó stream darabban. A hibák nem fogyasztanak kreditet. Ez lehetővé teszi a kockázatmentes kísérletezést pénzügyi kockázat nélkül. Tervezze meg a prompt struktúráját úgy, hogy a limiten belül maradjon.

Gyakori hibák hibaeltárása

Ellenőrizze először az API kulcsát. A 401-es hiba érvénytelen vagy lejárt kulcsot jelez. A 402-es hiba azt jelenti, hogy az előrefizetett kreditje elfogyott. Töltse fel kriptovalutával a folytatáshoz.

A 429-es hiba az átfogási korlátozást jelzi. Perce 300 kérésre van korlátozva. Csökkentse a párhuzamosságot, vagy várjon az újrapróbálás előtt. A 8 MB-os törzslimit is 400-as hibát vált ki, ha túllépik.