Dolphin fără cenzură API Documentație

Precondiții și configurarea mediului

Începe prin a te asigura că mediul tău are dependențele necesare instalate înainte de a face orice solicitare. Vei avea nevoie de o cheie API activă din panoul nostru de control și de un runtime suportat, cum ar fi Python sau Node.js. API-ul nostru necesită să trimiți solicitări către un URL de bază specific, în loc de endpoint-ul implicit OpenAI.

Păstrați cheia API în siguranță și stocați-o într-o variabilă de mediu. Acest lucru previne expunerea accidentală în depozitul de cod. Puteți genera o cheie nouă instantaneu după înregistrare cu Google sau email.

Nu trebuie să configurezi rutare complexă sau să selectezi modele specifice. Endpoint-ul servește un singur model mare de limbaj uncensored, conceput pentru output de text direct.

Instalarea SDK-ului oficial OpenAI

Instalează pachetul SDK oficial pentru a gestiona automat autentificarea și formatarea cererilor. Această librărie suportă atât mediile Python, cât și Node.js cu interfețe consistente.

Pentru utilizatorii Python, rulează comanda standard pip install pentru a adăuga biblioteca în mediul tău virtual. Dezvoltatorii Node.js ar trebui să folosească npm pentru a instala pachetul echivalent.

SDK-ul gestionează structura payload-ului JSON pentru tine, așa că trebuie doar să te concentrezi pe conținutul promptului și pe parametri precum temperatura sau top_p.

Poți verifica instalarea importând biblioteca în scriptul sau modulul tău. Acest lucru asigură că clientul este gata să se conecteze la serverele noastre.

Configurarea URL-ului de bază și a cheii API

Indreptați clientul SDK către URL-ul de bază specific pentru a direcționa cererile către infrastructura noastră fără cenzură. Utilizați https://api.dolphinuncensored.com/v1 ca endpoint-ul tău.

Configurați cheia API în antetul de autorizare sau în obiectul de configurare al clientului. Clientul va atașa această cheie la fiecare solicitare automat.

Asigură-te că specifici ID-ul modelului ca "uncensored" în configurația ta. Acest lucru îi spune serverului ce versiune de model să folosească pentru generarea ta.

Realizarea Primei Tale Completări de Chat

Trimiteți un mesaj simplu pentru a verifica conectivitatea și a primi un răspuns. Acest lucru confirmă că cheia dumneavoastră este validă și că endpoint-ul este accesibil.

Folosește endpointul chat-completions cu un prompt de sistem și un mesaj de utilizator. Răspunsul va conține textul generat în câmpul content.

Înțelegerea streaming-ului și a utilizării tokenilor

Activați streaming-ul pentru a primi tokenii pe măsură ce sunt generați în loc să aștepți răspunsul complet. Acest lucru îmbunătățește latența percepută pentru output-urile lungi.

API-ul returnează statisticile de utilizare în ultimul fragment al fluxului. Puteți urmări numărul de tokeni de intrare și ieșire pentru transparența facturării.

Setează parametrul stream la true în corpul solicitării. Iterează prin bucăți pentru a construi textul final sau pentru a-l procesa în timp real.

Gestionarea erorilor și a refuzurilor

Gestionați erorile HTTP 401 verificând dacă cheia API este corectă și nu a expirat. O eroare 402 indică credit preplătit insuficient; reîncărcați prin criptomonede pentru a continua.

Un status 429 înseamnă că ai atins limita de rată de 300 de cereri pe minut. Așteaptă puțin înainte de a reîncerca sau reduce concurența.

Modelul refuză solicitările care implică conținut sexual cu minori, care este o limită strictă. Alte subiecte controversate sau adulte sunt, în general, permise. Erorile și refuzurile nu îți consumă creditul de tokeni.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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