Dolphin obegränsad API Dokumentation

Förutsättningar och miljöinställningar

Börja med att säkerställa att din miljö har nödvändiga beroenden installerade innan du gör några förfrågningar. Du behöver en aktiv API-nyckel från vår dashboard och en stödd körningstid som Python eller Node.js. Vårt API kräver att du skickar förfrågningar till en specifik bas-URL istället för standard OpenAI-slutpunkten.

Spara din API-nyckel säkert och lagra den i en miljövariabel. Detta förhindrar att den exponeras i ditt kodarkiv. Du kan generera en ny nyckel omedelbart efter att ha registrerat dig med Google eller e-post.

Du behöver inte konfigurera komplex routning eller välja specifika modeller. Slutpunkten serverar en enda opåverkad stor språkmodell designad för direkt textutmatning.

Installera den officiella OpenAI-SDK:n

Installera det officiella SDK-paketet för att hantera autentisering och begäransformatering automatiskt. Detta bibliotek stöder både Python- och Node.js-miljöer med konsekventa gränssnitt.

För Python-användare, kör standardkommandot pip install för att lägga till biblioteket i ditt virtuella miljö. Node.js-utvecklare bör använda npm för att installera motsvarande paket.

SDK:n hanterar JSON-payload-strukturen åt dig, så att du bara behöver fokusera på prompt-innehållet och parametrar som temperaturen eller top_p.

Du kan verifiera installationen genom att importera biblioteket i ditt skript eller modul. Detta säkerställer att klienten är redo att ansluta till våra servrar.

Konfigurera bas-URL och API-nyckel

Pek SDK-klienten mot vår specifika bas-URL för att styra förfrågningar till vår obegränsade infrastruktur. Använd https://api.dolphinuncensored.com/v1 som din slutpunkt.

Ställ in din API-nyckel i auktoriseringshuvudet eller klientkonfigurationsobjektet. Klienten bifogar denna nyckel automatiskt till varje förfrågan.

Se till att du anger modell-ID:t som "uncensored" i din konfiguration. Detta säger åt servern vilken modellversion som ska användas för din generering.

Att göra din första chatkomplettering

Skicka ett enkelt meddelande för att verifiera anslutning och få ett svar. Detta bekräftar att din nyckel är giltig och att slutpunkten är nåbar.

Använd chat-completions-slutpunkten med ett systemprompt och ett användarmeddelande. Svaret innehåller den genererade texten i content-fältet.

Förstå strömning och tokenanvändning

Aktivera strömning för att ta emot tokens när de genereras istället för att vänta på hela svaret. Detta förbättrar upplevd latens för långa utdata.

API:et returnerar användningsstatistik i den sista delen av strömmen. Du kan spåra inmatnings- och utmatningstokenantal för faktureringsgenomskinlighet.

Ställ in stream-parametern till true i din request-body. Iterera igenom chunkarna för att bygga din slutliga text eller bearbeta den i realtid.

Hantera fel och avslag

Hantera HTTP 401-fel genom att verifiera att din API-nyckel är korrekt och inte har löpt ut. Ett 402-fel indikerar otillräckligt förbetalt kredit; ladda upp via krypto för att fortsätta.

En 429-status betyder att du har nått hastighetsgränsen på 300 förfrågningar per minut. Vänta kort innan du försöker igen eller minska din parallellitet.

Modellen vägrar begäranden som involverar sexuellt innehåll med minderåriga, vilket är en hård gräns. Andra kontroversiella eller vuxna ämnen tillåts generellt. Fel och avslag förbrukar inte 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);

Strömning

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)