Quickstart: Integrați API Uncensored

Precondiții: SDK și configurarea mediului

Instalează SDK-ul oficial pentru limbajul tău. Suportăm orice openai client compatibil. Serviciul nostru acționează ca un înlocuitor drop-in pentru integrările standard OpenAI.

Configurați variabila de mediu imediat. Acest lucru evită codarea hardcoded a credențialelor în fișierele sursă. Cheia API identifică contul dvs. și urmărește utilizarea.

Folosește versiunea din biblioteca standard. Majoritatea dezvoltatorilor au deja aceste pachete instalate. Dacă nu, adaugă pachetul la dependențele proiectului tău.

Autentificare: Setarea cheii API

Transmiteți cheia prin Authorization header. Necesitam un token Bearer pentru fiecare solicitare. Această metodă este standard pentru toate endpoint-urile compatibile OpenAI.

Generează-ți cheia din panoul de control. Primești o singură cheie activă per cont. Înlocuirea acesteia invalidează instantaneu cheia anterioară.

Mențineți cheia în siguranță. Nu o expuneți în codul client-side. Endpoint-ul nostru validează acreditările înainte de a procesa tokenii.

Punct final: POST /v1/chat/completions

Trimiteți promptul către endpoint-ul chat. Utilizați model câmp setat la uncensored. Acest lucru asigură că cererea este redirecționată către modelul nostru specific.

Răspunsuri în streaming prin SSE

Activați streaming-ul setând stream: true. Primești fragmente pe măsură ce sunt generate. Acest lucru reduce latența percepută pentru ieșiri lungi.

Analizați formatul Server-Sent Events. Fiecare fragment conține text parțial. Agregați aceste fragmente pentru a reconstrui răspunsul complet.

Monitorizați utilizarea tokenilor în ultimul fragment. Ultimul eveniment include statistici complete de utilizare. Acest lucru vă ajută să urmăriți costurile cu precizie.

Apelarea funcțiilor și utilizarea instrumentelor

Definește instrumentele în corpul cererii. Modelul returnează argumente structurate. Analizează aceste argumente în logica aplicației tale.

Suportă definiții standard de instrumente. Folosește tool_choice pentru a forța un comportament specific. Acest lucru funcționează cu orice SDK compatibil cu OpenAI.

Validați formatul de ieșire. Asigurați-vă că codul dvs. gestionează argumentele lipsă în mod elegant. Modelul poate omite câmpuri dacă nu sunt necesare.

Mod JSON și Ieșiri Structurate

Setează response_format pentru json_objectModelul returnează JSON strict formatat. Acest lucru elimină erorile de analiză pentru datele structurate.

Definește schema clar. Modelul urmează instrucțiunile tale cu precizie. Folosește acest lucru pentru extragerea de date sau generarea de configurații.

Gestionați erorile de parsare JSON. Structurile invalide apar încă ocazional. Implementați logica de fallback pentru aplicații robuste.

Gestionarea erorilor și limitele de rată

Gestionați codurile de stare HTTP în mod adecvat. Un 401 eroare înseamnă că cheia dvs. este invalidă. O 402 eroare indică credit insuficient. O 429 eroare semnalează limitarea ratei.

Respectă limita de 300 de solicitări pe minut. Poți trimite 8 solicitări concurente. Depășirea acestor limite returnează o eroare 429. Așteaptă înainte de a reîncerca.

Fereastra de context este de 100.000 de tokeni. Aceasta include atât intrarea, cât și ieșirea. Gestionează-ți bugetul de tokeni cu atenție. Ieșirea maximă este de 16.000 de tokeni per cerere. Erorile nu consumă credit.

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)