Documentație API & Quickstart

Autentificare & URL de Bază

Începe fiecare cerere indicând clientul tău către HTTPS://api.uncensoredia.com/v1 și atașarea cheii tale. Autorizare folosește standardul Bearer scheme, așa că pur și simplu lipești tokenul pe care l-ai primit după înregistrarea cu Google sau email. Endpoint-ul este complet API compatibilă openai conform, ceea ce înseamnă că trebuie doar să înlocuiești URL-ul de bază și cheia API în configurația existentă. Nu trebuie să gestionezi straturi complexe de rutare sau anteturi proxy. Asigură-te doar că Authorization header conține tokenul tău unic. Această configurare garantează că solicitările tale ajung la modelul dedicat fără cenzură, fără filtrare intermediară. Dacă primești un 401 eroare, verificați dacă cheia dvs. este activă și formatată corect.

Endpoint Completări Chat

Trimite mesaje către POST /v1/chat/completions pentru a primi răspunsuri text de la modelul fără cenzură. Acest singur endpoint gestionează toate nevoile tale de generare, de la prompturi simple la conversații complexe în mai multe tururi. Poți controla lungimea și aleatorietatea output-ului folosind parametri precum max_tokens, temperature, și top_p. Modelul suportă un masiv 100.000 de tokeni fereastră de context, permițându-ți să introduci documentație extensivă sau istorice de conversații lungi. Poți trimite până la 16,000 de tokeni în răspuns. Dacă omiti max_tokens, limita implicită este de 2.048 de tokeni. Acest endpoint nu suportă generarea de imagini sau audio. Este strict text input, text output. Folosește următoarea comandă curl pentru a-ți testa conexiunea imediat.

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI pentru a interacționa cu API-ul cu modificări minime de cod. Trebuie doar să suprascrii base_url și api_key în configurația clientului. Această abordare asigură că logica existentă pentru gestionarea răspunsurilor, erorilor și reîncercărilor rămâne intactă. Biblioteca gestionează automat serializarea JSON și streaming-ul dacă o activați. Această metodă este ideală pentru serviciile backend sau scripturile care trebuie să proceseze volume mari de text. Modelul uncensored răspunde la solicitările standard de completare chat fără a necesita logică de analiză personalizată. Configurați clientul o dată și utilizați-l în întreaga aplicație. Iată cum se inițializează clientul și se trimite o solicitare de bază.

Configurare SDK Node.js

Integrează API în aplicațiile tale JavaScript sau TypeScript folosind @anthropic-ai/sdk sau oficial openai pachet. Setează baseURL către endpoint-ul nostru și furnizează cheia ta API. Acest lucru îți permite să folosești metode familiare precum chat.completions.create() direct. SDK-ul gestionează cererile HTTP și analizează răspunsurile JSON pentru dvs. Puteți gestiona ușor erori precum 402 (credit insuficient) sau 429 (limita de rată) în logica aplicației tale. Această configurație este perfectă pentru servere web, boturi sau orice mediu Node.js. Modelul fără cenzură funcționează perfect cu formatul standard de solicitare. Configurează clientul pentru a te asigura de compatibilitatea cu așteptările API.

Răspunsuri în streaming

Activează livrarea de token-uri în timp real setând stream: true în cererea ta. API-ul returnează un flux de Evenimente Trimise de Server (SSE), permițându-vă să afișați textul pe măsură ce se generează. Acest lucru îmbunătățește experiența utilizatorului pentru interfețele de chat și reduce latența percepută. Fiecare fragment conține un răspuns parțial, iar ultimul fragment include statisticile de utilizare a tokenilor. Puteți procesa aceste fragmente incremental pentru a construi răspunsul complet. Această caracteristică este esențială pentru aplicațiile care necesită feedback imediat. Modelul uncensored suportă streaming-ul pentru toate tipurile de cereri. Gestionați evenimentele fluxului pentru a actualiza interfața grafică eficient. Utilizați acest cod pentru a implementa streaming-ul în clientul dvs.

Limite de rată și limite de context

API impune limite stricte pentru a asigura o performanță stabilă pentru toți utilizatorii. Puteți trimite până la 300 de solicitări pe minut per cheie și au 8 cereri simultane active în orice moment. Dimensiunea maximă a corpului solicitării este de 8 MB. Dacă depășești aceste limite, vei primi un 429 cod de status. Asigură-te că gestionezi reîncercările cu backoff exponențial pentru a evita atingerea acestor limite în mod repetat. Fereastra de context este de 100,000 de tokeni, dar ieșirea maximă este de 16,000 de tokeni. Dacă ai nevoie de mai multă ieșire, ajustează max_tokens parametru. Erori precum 401 (cheie invalidă) și 402 (fără credit) sunt imediate și nu consumă alocarea de tokenuri. Gestionează-ți cu atenție cota pentru a evita întreruperile serviciului în timpul sarcinilor de generare cu volum mare.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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