API dokumentáció & Gyors kezdés

Base URL és Hitelesítés

Kezdje azzal, hogy a base URL-t erre állítja: HTTPS://api.uncensoredal.com/v1, és átadja az API kulcsot az Authorization fejlécben. Fiontonként egy aktív kulcsot kap, és egy új kulcs generálása azonnal érvényteleníti az előzőt. Ez az egyszerű beállítás bármely szabványos OpenAI-kompatibilis klienssel működik komplex routing logika nélkül.

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

A végpont szigorúan a chat completionekre szolgál, így nem kell modellek közötti irányítást kezelnie. Minden kérésben szerepelnie kell az "uncensored" modellazonosítónak, hogy biztosan a megfelelő inferencia-kiszolgálóra irányuljon. A hitelesítési hibák 401-es státuszkóddal térnek vissza, ha a kulcs hiányzik vagy érvénytelen.

Chat Completions végpont

Küldjön egy POST kérést a /v1/chat/completions végpontra az üzenettörténetével a messages tömbben. A rendszer szöveges bemenetet dolgoz fel és szöveges kimenetet ad vissza tartalmi visszautasítások nélkül jogszerű felnőtt felhasználás esetén. A payloadban meg kell adnia a modellt "uncensored" értékre a kompatibilitás biztosítása érdekében.

Copyfrom openai import OpenAI

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

A kérések a tényleges token felhasználás alapján kerülnek számlázásra, a hibák és elutasítások ingyenesek maradnak. Ez az előre fizetett modell azt jelenti, hogy csak a felhasznált mennyiség után fizet. Az endpoint támogatja a szabványos paramétereket, mint például a temperature és a top_p a kimeneti véletlenszerűség szabályozására.

Streamelési válaszok SSE-vel

Engedélyezze a streamelést úgy, hogy a kérés törzsében a stream paramétert true értékre állítja, hogy tokeneket kapjon Server-Sent Events (SSE) formájában. Minden darab token-felhasználási statisztikákat tartalmaz az utolsó darabban, lehetővé téve a költségek valós idejű nyomon követését. Ez a megközelítés csökkenti az észlelt késést hosszú generálások esetén.

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)

Használjon streamelést chat felületek építésekor, amelyeknek szöveget kell megjeleníteniük generálás közben. Az API szabványos, OpenAI-kompatibilis stream eseményeket ad vissza, megkönnyítve az integrációt meglévő UI könyvtárakkal. A streamet korábban leállíthatja, ha a felhasználó megváltoztatja a bemenetet.

Függvényhívás és JSON mód

Határozza meg az eszközöket a kérésben a függvényhívás engedélyezéséhez vagy a JSON-kimenet kikényszerítéséhez a response_format segítségével. Az API támogatja a tool_choice paramétert a modell pontos vezérléséhez abban, hogy mikor hívjon meg egy függvényt. Ez a funkció a szabványos OpenAI sémával működik, így újra felhasználhatja meglévő eszközdefinícióit.

Copyimport OpenAI from "openai";

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

A JSON mód biztosítja, hogy a kimenet érvényes JSON legyen, ami hasznos a strukturált adatok programozott feldolgozásához. Ezt kombinálhatja a temperature beállításokkal a kreativitás és a strukturális megbízhatóság egyensúlyának megőrzéséhez. Az API kezeli az eszköz végrehajtási logikát a függvényhívás részleteinek visszaadásával, hogy az Ön kódja feldolgozhassa.

Modell paraméterek konfigurációja

Konfigurálja a hőmérséklet, top_p, stop szekvenciák és seed paramétereket a generálási viselkedés vezérléséhez. A kontextusablak 100 000 token támogatását nyújtja prompt és kiegészítés kombináltan. A maximális kimenet kérésonként 16 000 tokenben van korlátozva, vagy 2048-ban, ha nem adja meg a max_tokens értéket.

Használhatsz presence_penalty és frequency_penalty paramétereket a ismétlődés csökkentésére hosszabb szövegekben. Ezek a paraméterek lehetővé teszik a modell stílusának finomhangolását a súlyok megváltoztatása nélkül. Állítsd őket fokozatosan, hogy megtaláld a megfelelő egyensúlyt a konkrét felhasználási esetedhez.

Korlátok, hibák és kontextus

A sebességkorlát percenként 300 kérésre és kulcsonként 8 párhuzamos kérésre van állítva. A kéréstörzsek mérete 8 MB-ban van korlátozva, így a nagy kontextusablakokat óvatosan kell kezelni. A hibák között szerepel a 401 érvénytelen kulcsoknál, a 402 elégtelen kreditnél és a 429 sebességkorlátnál.

A hitel nem jár le, így szüneteltetheti a felhasználást robbanásszerű igények között pénzügyi veszteség nélkül. Ha eléri a párhuzamos limitet, próbálja újra exponenciális backoff-pal. A 100,000 tokenes kontextusablak lehetővé teszi a kiterjedt előzmények kezelését, de figyelje a kimeneti korlátokat a levágás elkerülése érdekében.