Documentație API Uncensoredă

Quickstart: trimiteți prima solicitare

API-ul Venice AI este un serviciu compatibil cu OpenAI. Plătești per token pentru generarea de text fără filtre de conținut. Trimite o cerere POST către endpoint-ul de completări chat cu cheia ta API. Modelul procesează promptul tău și returnează textul direct.

Începeți prin a vă autentifica cu cheia. Apoi definiți ID-ul modelului ca "uncensored". Specificați array-ul de mesaje cu un rol și conținut. Serverul răspunde cu text generat. Acest lucru funcționează cu orice client HTTP standard sau SDK. Obțineți text brut, fără suprasarcină de formatare suplimentară. Erorile returnează JSON cu un cod de eroare. Utilizați această cale rapidă pentru a vă verifica configurația înainte de a construi aplicații complexe.

Autentificare și URL de bază

Autentificarea utilizează o singură cheie API transmisă în antet. URL-ul de bază este HTTPS://api.unzensierte.cc/v1. Acest URL funcționează cu SDK-urile oficiale OpenAI prin setarea parametrului base_url. Cheia dumneavoastră identifică contul și urmărește utilizarea tokenilor. Generați o cheie pe pagina Obțineți cheie API. Aceasta apare imediat după înregistrare prin Google sau email. Utilizați această cheie în fiecare solicitare. Cheile invalide returnează un eroare 401. Cheile expirate sau cu credit insuficient returnează 402.

Păstrați-vă cheia în siguranță. O singură cheie activă pe cont. O cheie nouă înlocuiește cea veche. Nu este necesar un număr de telefon pentru înregistrare. Cheia API este singura acreditare necesară pentru acces.

Endpoint Completări Chat

Endpoint-ul principal este POST /v1/chat/completions. Acceptă payload-uri JSON cu model, mesaje și parametri. ID-ul modelului este "uncensored". Mesajele necesită un rol și un șir de conținut. Sistemul răspunde cu textul generat în array-ul choices. Puteți seta temperatura, top_p și secvențele de oprire. Acești parametri controlează creativitatea și lungimea outputului. API-ul returnează utilizarea de tokeni în răspuns. Erorile includ un mesaj și un tip. Utilizați acest endpoint pentru toate sarcinile de generare de text. Este singurul endpoint de text disponibil. Nu există aici embedding-uri sau generare de imagini.

Utilizare și răspunsuri în flux

Activați fluxul de date setând stream la true. API-ul trimite Evenimente trimise de server (SSE). Fiecare fragment conține text parțial. Fragmentul final include datele de utilizare a tokenilor. Acest lucru permite afișarea în timp real a textului generat. Stocați fragmentele în aplicația dumneavoastră. Combinați-le pentru a forma răspunsul complet. Fluxul de date reduce latența percepută pentru ieșirile lungi. Utilizați acest lucru pentru interfețe de chat sau procesarea datelor live. Obiectul de utilizare apare doar în ultimul fragment. Urmăriți tokenii de intrare și ieșire pentru facturare. Erorile în timpul fluxului de date returnează totuși obiectul de eroare într-un fragment.

Function calling și modul JSON

Utilizează apelarea de funcții pentru a integra instrumente externe. Definește instrumentele în corpul cererii. Modelul returnează apeluri de instrumente cu argumente. Analizează aceste argumente pentru a-ți executa funcțiile. Setează tool_choice la auto sau la nume de funcții specifice. Modul JSON forțează ieșirea să fie JSON valid. Setează response_format la json_object. Acest lucru asigură date structurate pentru analiză. Utilizează aceste funcții pentru fluxuri de lucru automatizate. Combină-le pentru comportamente complexe de agenți. Modelul suportă formatele standard de instrumente OpenAI. Verifică dacă definițiile instrumentelor tale se potrivesc cu schema așteptată.

Limite și gestionarea erorilor

Limitările de rată sunt de 300 de cereri pe minut per cheie. Concurența este limitată la 8 cereri simultane. Corpurile cererii trebuie să fie sub 8 MB. Erorile includ coduri specifice, cum ar fi 401 pentru chei invalide. 402 indică credit preplătit insuficient. 429 semnalează depășirea limitei de rată. Fereastra de context este de 100,000 de tokeni în total. Outputul maxim este de 16,000 de tokeni per cerere. Erorile returnează JSON cu detalii despre eroare. Gestionează reîncercările pentru erorile 429. Verifică soldul de credit înainte de utilizarea intensă. Rambursările nu sunt disponibile pentru creditul consumat.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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