Dolphin unfiltered API Dokumentation

Forudsætninger og miljøopsætning

Start med at sikre, at dit miljø har de nødvendige afhængigheder installeret, før du sender nogen anmodninger. Du vil have brug for en aktiv API-nøgle fra vores dashboard og et understøttet kørselsmiljø som Python eller Node.js. Vores API kræver, at du sender anmodninger til en specifik base-URL i stedet for standard OpenAI-endpointet.

Hold din API-nøgle sikker og gem den i en miljøvariabel. Dette forhindrer utilsigtet eksponering i dit kodearkiv. Du kan generere en ny nøgle øjeblikkeligt efter tilmelding med Google eller e-mail.

Du behøver ikke at konfigurere kompleks routing eller vælge specifikke modeller. Endpointet betjener én enkelt uncensored stor sprogmodel designet til direkte tekstoutput.

Installation af den Officielle OpenAI SDK

Installer den officielle SDK-pakke for automatisk at håndtere autentificering og anmodningsformatering. Denne bibliotek understøtter både Python- og Node.js-miljøer med konsistente grænseflader.

Til Python-brugere, kør den standard pip install-kommando for at tilføje biblioteket til dit virtuelle miljø. Node.js-udviklere bør bruge npm til at installere den tilsvarende pakke.

SDK'en styrer JSON-payload-strukturen for dig, så du kun skal fokusere på prompt-indhold og parametre som temperaturen eller top_p.

Du kan verificere installationen ved at importere biblioteket i dit script eller modul. Dette sikrer, at klienten er klar til at oprette forbindelse til vores servere.

Konfigurerer Base URL og API-nøgle

Peg din SDK-klient på vores specifikke base URL for at dirigere anmodninger til vores ubegrænsede infrastruktur. Brug https://api.dolphinuncensored.com/v1 som dit endpoint.

Indstil din API-nøgle i autorisationsheaderen eller klientkonfigurationsobjektet. Klienten vedhæfter automatisk denne nøgle til hver anmodning.

Sørg for, at du angiver model-ID'et som "uncensored" i din konfiguration. Dette fortæller serveren, hvilken modelversion der skal bruges til din generering.

Lav din første chat-completion

Send en simpel besked for at verificere forbindelsen og modtage et svar. Dette bekræfter, at din nøgle er gyldig, og endepunktet er nåbart.

Brug chat-completions-endpointet med et systemprompt og en brugermelding. Svaret vil indeholde den genererede tekst i content-feltet.

Forståelse af streaming og tokenforbrug

Aktivér streaming for at modtage tokens, mens de genereres, i stedet for at vente på det fulde svar. Dette forbedrer den opfattede forsinkelse for lange output.

API'en returnerer forbrugsstatistikker i det sidste chunk af streamen. Du kan spore input- og output-token-tællinger for faktureringsgennemsigtighed.

Angiv stream-parameteren til true i din request body. Iterer gennem chunks for at opbygge din endelige tekst eller behandle den i realtid.

Håndtering af fejl og afvisninger

Håndter HTTP 401-fejl ved at verificere, at din API-nøgle er korrekt og ikke er udløbet. En 402-fejl indikerer utilstrækkelig forudbetalt kredit; toppede op via krypto for at fortsætte.

En 429-status betyder, at du har ramt hastighedsgrænsen på 300 anmodninger i minuttet. Vent kort, før du prøver igen, eller reducer din samtidighed.

Modellen afvisker anmodninger, der involverer seksuelt indhold med mindreårig, hvilket er en hard grænse. Andre kontroversielle eller voksne emner er generelt tilladt. Fejl og afvisninger forbruger ikke din tokenkredit.

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)