Integrare pas cu pas a API-ului LLM uncensored.com

Precondiții: SDK și configurarea mediului

Instalează SDK-ul limbajului tău preferat pentru a comunica cu endpoint-ul. Majoritatea dezvoltatorilor folosesc SDK-ul oficial OpenAI pentru Python, Node.js sau Go. Acest lucru funcționează deoarece API-ul urmează schema standard de completări chat OpenAI.

Asigură-te că mediul tău are Python 3.8+ sau Node.js 18+. Instalează pachetul prin pip sau npm. Vei avea nevoie de o cheie API din panoul de control. Nu este necesar un număr de telefon pentru înregistrare.

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

Păstrează cheia ta API într-o variabilă de mediu. Acest lucru previne expunerea accidentală în controlul versiunilor. Cheia oferă acces la modelul uncensored.

Configurarea URL-ului de bază

Indreptați clientul SDK către URL-ul de bază corect. Acesta este cel mai critic pas pentru o integrare reușită. URL-ul de bază implicit OpenAI nu va funcționa pentru acest serviciu.

Stabilește URL-ul de bază la HTTPS://api.uncensoredaicom.com/v1. Acest lucru direcționează cererile către infrastructura LLM uncensored. ID-ul modelului pe care trebuie să îl trimiți este "uncensored". Este un model open-weight, ajustat pentru refuzuri minime.

Verificați conexiunea apelând endpoint-ul models. Acest lucru confirmă că acreditările și URL-ul de bază sunt corecte. Un răspuns cu succes returnează ID-ul modelului și tipul de obiect.

Autentificare și Configurare Antet

Transmiteți cheia API în antetul Authorization. Utilizați schema Bearer pentru toate solicitările. Acest antent autentifică contul dumneavoastră cu credit preplătit.

Stabilește antetul ca: Authorization: Bearer YOUR_API_KEY. SDK-ul gestionează acest lucru automat dacă transmiți cheia către constructorul clientului. Asigură-te că nu sunt incluse spații albe suplimentare. Cheile invalide returnează o eroare 401 Unauthorized.

Primești o singură cheie activă per cont. Generarea unei chei noi invalidează pe cea anterioară. Acest lucru simplifică rotirea cheilor și gestionarea securității. Păstrează-ți cheia în siguranță în mediul tău de implementare.

Trimiterea unei cereri standard de chat

Trimiteți o cerere POST către /v1/chat/completions. Trimite mesajele ca un array de obiecte cu role și content. Sistemul suportă rolurile user, assistant și system.

Structură exemplu: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API returnează un text complet. Fereastra de context are 100,000 de tokeni în total. Ieșirea maximă este de 16,000 de tokeni per solicitare.

Erorile și refuzurile nu consumă credit. Acest lucru vă protejează soldul preplătit. Setează temperature și top_p pentru control. Valorile implicite funcționează pentru majoritatea cazurilor de utilizare.

Activarea streaming-ului pentru ieșiri în timp real

Setează stream: true în corpul cererii tale. Acest lucru activează Evenimente trimise de server (SSE). Tokenii ajung incremental în loc să aștepți completarea completă.

Analizați fluxul SSE pentru a afișa textul în timp real. Fragmentul final conține statisticile de utilizare a tokenilor. Aceasta permite o facturare precisă. Streaming-ul reduce latența percepută pentru utilizatorii finali.

Gestionați întreruperile de rețea în mod elegant. Reconectați-vă dacă fluxul se întrerupe. API-ul non-cenzurat suportă streaming stabil. Monitorizați starea conexiunii. Utilizați acest lucru pentru interfețe de chat sau generare de lungă durată.

Utilizând Tool-uri și Function Calling

Definește instrumentele în corpul cererii. Trimite o listă de scheme de funcții. Modelul poate apela aceste funcții în funcție de intenția utilizatorului. Acest lucru permite un comportament de tip agent.

Specifică tool_choice pentru a controla selectarea funcției. Folosește auto pentru detectare automată. API-ul suportă definiții standard de instrumente. Analizează argumentele apelului de funcție din răspuns.

Implementați execuția funcției în codul dvs. Trimiteți rezultatul înapoi ca mesaj. Modelul continuă conversația. Acest lucru permite fluxuri de lucru complexe. Testarea asigură o analiză precisă a argumentelor.

Gestionarea răspunsurilor în mod JSON

Setează response_format: {"type": "json_object"}. Acest lucru forțează modelul să producă JSON valid. Folosește acest lucru pentru extragerea datelor structurate. Previne erorile de răspuns malformed.

Analizați șirul JSON din codul dumneavoastră. Gestionați erorile potențiale de analiză. Modul JSON îmbunătățește fiabilitatea pentru integrările API. Este ideal pentru fluxurile de lucru de procesare a datelor.

Combină modul JSON cu prompturile de sistem. Ghidează modelul să producă scheme specifice. Acest lucru asigură un format constant. Validează ieșirea înainte de a o folosi. Acest lucru reduce erorile downstream.

Monitorizarea limitelor și a erorilor

Respectați limitele de rată. Aveți voie la 300 de solicitări pe minut per cheie. Maxim 8 solicitări concurente. Dimensiunea corpului solicitării este limitată la 8 MB.

Monitorizează codurile de status HTTP. 429 indică depășirea limitei de rată. 400 indică o cerere greșită. 500 indică o eroare de server. Implementează backoff exponențial pentru reîncercări. Acest lucru previne copleșirea API.

Urmărește utilizarea tokenilor în ultimul fragment de flux continuu. Acest lucru ajută la gestionarea creditului preplătit. Erorile nu consumă tokeni. Acest lucru îți protejează soldul. Monitorizarea regulată asigură un funcționare fluidă.

Calcularea costurilor și a utilizării tokenilor

Tarifele sunt transparente și preplătite. Tokenii de intrare costă $0.15 per milion. Tokenii de ieșire costă $0.50 per milion. Creditul nu expiră niciodată. Nu se aplică taxe lunare.

Reîncarcă doar cu criptomonede. USDT (TRC20) sau USDC (Base). Sumele variază de la 20 $ la 500 $. Creditul bonus se aplică pentru reîncărcări mai mari. +5% de la 50 $, +10% de la 100 $, +15% de la 200 $.

Calculați costurile înainte de utilizarea intensă. Estimați numărul de tokeni pentru prompturile dvs. Acest lucru ajută la bugetarea eficientă. Erorile sunt gratuite. Rambursările nu sunt emise, dar greșelile sunt corectate. Utilizați panoul de control pentru a urmări cheltuielile.