Lépésről lépésre integráció az uncensored.com LLM API-jához

Előfeltételek: SDK és környezetbeállítás

Telepítse a kívánt nyelv SDK-ját a végponttal való kommunikációhoz. A fejlesztők többsége a hivatalos OpenAI SDK-t használja Pythonhoz, Node.js-hez vagy Go-hoz. Ez azért működik, mert az API a szabványos OpenAI chat completions sémát követi.

Győződjön meg arról, hogy a környezete támogatja a Python 3.8+ vagy Node.js 18+ verziót. Telepítse a csomagot pip vagy npm segítségével. Szüksége lesz egy API-kulcsra a dashboardról. Telefonnummer regisztrációhoz nem szükséges.

• Python: pip install openai
• Node.js: npm install openai

Tárold az API kulcsot egy környezeti változóban. Ez megakadályozza a véletlen kitettséget a verziókezelésben. A kulcs hozzáférést biztosít az uncensored modellhez.

Az alap URL-cím konfigurálása

Irányítsd SDK-kliensedet a helyes bázis URL-re. Ez a legfontosabb lépés a sikeres integrációhoz. Az alapértelmezett OpenAI bázis URL nem fog működni ehhez a szolgáltatáshoz.

Állítsa be a bázis URL-t a HTTPS://api.uncensoredaicom.com/v1 értékre. Ez a kéréseket az uncensored LLM infrastruktúrára irányítja. A küldendő modell azonosító "uncensored". Ez egy nyílt súlyú modell, amely a minimális elutasításra van hangolva.

Ellenőrizze a kapcsolatot a modellek endpoint hívásával. Ez megerősíti, hogy a hitelesítő adatai és az alap URL helyesek-e. A sikeres válasz visszaadja a modell azonosítót és az objektum típust.

Hitelesítés és fejléc beállítás

Adja át API-kulcsát az Authorization fejlécben. Használja a Bearer sémát az összes kéréshez. Ez a fejléc hitelesíti az előleges kreditfiókját.

Állítsa be a fejlécet így: Authorization: Bearer YOUR_API_KEY. Az SDK automatikusan kezeli ezt, ha megadod a kulcsot a kliens konstruktorában. Győződj meg róla, hogy nincs benne extra whitespace. Az érvénytelen kulcsok 401 Unauthorized hibát adnak vissza.

Egy aktív kulcsot kap fiókonként. Egy új kulcs generálása érvényteleníti az előzőt. Ez egyszerűsíti a kulcsforgatást és a biztonsági kezelést. Tartsa biztonságban a kulcsot a telepítési környezetében.

Egy szabványos chat kérés küldése

Tegyen egy POST kérést a /v1/chat/completions végpontra. Küldje el üzeneteit role és content objektumok tömbjeként. A rendszer támogatja a user, assistant és system szerepköröket.

Példa struktúra: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. Az API szövegkiegészítést ad vissza. A kontextus ablak 100,000 token összesen. A maximális kimenet 16,000 token kérésenként.

A hibák és a visszautasítások nem fogyasztanak kreditet. Ez megvédi az előre fizetett egyenlegét. Állítsa be a temperature és top_p paramétereket a kontroll érdekében. Az alapértelmezett értékek a legtöbb felhasználási esethez működnek.

A streamelés engedélyezése a valós idejű kimenethez

Beállítás stream: true a kéréstörzsben. Ez aktiválja a Server-Sent Events (SSE) technológiát. A tokenek fokozatosan érkeznek, nem kell várni a teljes kiegészítésre.

Elemzés az SSE-folyamból a szöveg valós idejű megjelenítéséhez. A végső darab token-használati statisztikákat tartalmaz. Ez lehetővé pontos számlázási nyomon követést. A streamelés csökkenti a észlelt késleltetést a végfelhasználók számára.

Kezelje a hálózati megszakításokat gracefully. Csatlakozzon újra, ha a stream lekapcsol. Az uncensored API stabil streamelést támogat. Figyelje a kapcsolat állapotát. Használja ezt chat felületekhez vagy hosszú formájú generáláshoz.

Eszközök és funkcióhívás használata

Határozza meg az eszközöket a kérés törzsében. Adjon meg függvénysémák listáját. A modell a felhasználó szándéka alapján hívhatja ezeket a függvényeket. Ez ügyszerű viselkedést tesz lehetővé.

Specify tool_choice a függvénykiválasztás vezérléséhez. Használja auto az automatikus észleléshez. Az API támogatja a szabványos eszközdefiníciókat. Elemzd a függvényhívás argumentumait a válaszból.

Implementálja a függvényvégrehajtást a kódjában. Küldje vissza az eredményt üzenetként. A modell folytatja a beszélgetést. Ez lehetővé teszi a komplex munkafolyamatokat. A tesztelés biztosítja a pontos argumentum-feldolgozást.

JSON mód válaszok kezelése

Beállítás response_format: {"type": "json_object"}. Ez kényszeríti a modellt, hogy érvényes JSON-t adjon vissza. Használd ezt strukturált adatok kinyeréséhez. Megakadályozza a hibás válasz hibákat.

Elemzze a JSON karakterláncot a kódjában. Kezelje a lehetséges elemzési hibákat. A JSON mód növeli a megbízhatóságot az API integrációkban. Ideális adatfeldolgozási folyamatokhoz.

Kombinálja a JSON módot a system promptokkal. Irányítsa a modellt a specifikus sémák kimenetére. Ez biztosítja a konzisztens formázást. Érvényesítse a kimenetet a használata előtt. Ez csökkenti a downstream hibákat.

Monitorozási korlátok és hibák

Tartsd be a sebességkorlátokat. Kulcsonként percenként 300 kérést kapsz. Maximum 8 párhuzamos kérés. A kéréstörzs mérete 8 MB-ban korlátozott.

Figyelje az HTTP állapotkódokat. A 429 a sebességkorlát túllépését jelzi. A 400 a hibás kérést jelzi. Az 500 a kiszolgálói hibát jelzi. Implementáljon exponenciális backoffot az újrapróbálkozásokhoz. Ez megakadályozza, hogy túlterhelje az API-t.

Token használat nyomon követése az utolsó streamelt darabban. Ez segít kezelni az előre fizetett kreditet. A hibák nem fogyasztanak tokeneket. Ez védi az egyenlegét. A rendszeres figyelés biztosítja a zavartalan működést.

Költségek és tokenfelhasználás számítása

Az árazás átlátható és előrefizetett. A bemeneti tokenek ára $0,15 millióként. A kimeneti tokeneké $0,50 millióként. A kredit sosem jár le. Nincsenek havi díjak.

Töltsd fel kizárólag kriptovalutával. USDT (TRC20) vagy USDC (Base). Az összegek 20 $ és 500 $ között mozognak. A bónusz hitel nagyobb feltöltésekre érvényes. +5% 50 $-tól, +10% 100 $-tól, +15% 200 $-tól.

Számítsa ki a költségeket a nagy terhelés előtt. Becsülje meg a token számokat a promptjaihoz. Ez segít hatékonyan tervezni a költségvetést. A hibák ingyenesek. Visszatérítést nem adunk, de a hibákat kijavítjuk. Használja a műszerfalat a költések nyomon követéséhez.