Quickstart: integrați în câteva minute

1. Instalează-ți SDK-ul

Începe prin a instala biblioteca oficială pentru limbajul tău. Majoritatea dezvoltatorilor preferă pachetul standard deoarece se potrivește cu interfața pe care o cunosc deja. Rulează pip install openai pentru Python sau npm install openai pentru Node.js. Ai nevoie de un singur SDK pentru a gestiona toate cererile.

2. Setează URL-ul de bază

Configurați clientul să indice către endpoint-ul nostru specific. Trebuie să suprascrieți URL-ul de bază implicit pentru a direcționa traficul corect. Utiliza https://api.unsencoredai.com/v1 ca URL-ul tău de bază. Transmite-ți cheia API în Authorization header. Această configurare funcționează cu orice client compatibil OpenAI standard.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Trimiteți prima solicitare

Trimiteți o solicitare standard de completare a chat-ului pentru a genera text. ID-ul modelului este uncensored. Puteți trimite prompturi de sistem pentru a ghida comportamentul. API-ul returnează un răspuns text direct. Utilizați comanda curl de mai jos pentru a testa conectivitatea imediat. Verificați răspunsul pentru choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Gestionează răspunsurile în streaming

Activați streaming-ul pentru latență redusă și ieșiri în timp real. Setează stream: true în cererea ta. API-ul trimite fragmente prin Server-Sent Events. Poți procesa fiecare token pe măsură ce ajunge. Acest lucru este ideal pentru interfețe de chat sau scenarii de joc de rol. Fragmentul final conține statistici de utilizare.

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)

5. Configurați parametrii

Ajustați temperature, top_p, și stop secvențe. Aceste controale influențează creativitatea și lungimea ieșirii. Poți folosi și response_format pentru modul JSON. Fereastra de context suportă 100,000 tokeni în total. Ieșirea maximă este de 16,000 tokeni per cerere. Ajustează aceste setări pentru cazul tău specific de utilizare.

6. Limitări, erori și context

Gestionați erorile cu grijă folosind coduri de status HTTP standard. O eroare 401 înseamnă că cheia API este nevalidă. O eroare 402 indică credit preplătit insuficient. O eroare 429 semnalează că ai atins limita de 300 de cereri pe minut. Fereastra contextului tău este de 100.000 de tokeni. Cererile peste 8 MB pot eșua. Rambursările nu sunt emise pentru credit, dar erorile sunt gratuite.