Dolphin ongecensureerd API Documentatie

Vereisten en omgevingconfiguratie

Begin met het controleren of je omgeving de benodigde afhankelijkheden heeft geïnstalleerd voordat je verzoeken verstuurt. Je hebt een actieve API-sleutel van ons dashboard en een ondersteunde runtime nodig, zoals Python of Node.js. Onze API vereist dat je verzoeken verstuurt naar een specifieke basis-URL in plaats van het standaard OpenAI-eindpunt.

Bewaar uw API-sleutel veilig en sla deze op in een omgevingsvariabele. Dit voorkomt per ongeluk blootstellen in uw code repository. U kunt direct na het aanmelden met Google of e-mail een nieuwe sleutel genereren.

Je hoeft geen complexe routing te configureren of specifieke modellen te selecteren. Het endpoint bedient één enkele uncensored large language model ontworpen voor directe tekstuitvoer.

De officiële OpenAI SDK installeren

Installeer het officiële SDK-pakket om authenticatie en requestopmaak automatisch af te handelen. Deze bibliotheek ondersteunt zowel Python- als Node.js-omgevingen met consistente interfaces.

Voor Python-gebruikers voer je de standaard pip install-opdracht uit om de bibliotheek aan je virtuele omgeving toe te voegen. Node.js-ontwikkelaars moeten npm gebruiken om het equivalente pakket te installeren.

De SDK beheert de JSON-payloadstructuur voor je, zodat je je alleen hoeft te concentreren op de promptinhoud en parameters zoals temperatuur of top_p.

U kunt de installatie verifiëren door de bibliotheek te importeren in uw script of module. Dit zorgt ervoor dat de client klaar is om verbinding te maken met onze servers.

Basis-URL en API-sleutel configureren

Wijs uw SDK-client naar onze specifieke basis-URL om verzoeken naar onze ongefilterde infrastructuur te routeren. Gebruik https://api.dolphinuncensored.com/v1 als je eindpunt.

Stel je API-sleutel in in de autorisatieheader of clientconfiguratieobject. De client voegt deze sleutel automatisch aan elk verzoek toe.

Zorg ervoor dat je de model-ID specificeert als "uncensored" in je configuratie. Dit vertelt de server welke modelversie te gebruiken voor je generatie.

Je eerste chat voltooiing maken

Stuur een eenvoudig bericht om de connectiviteit te verifiëren en een respons te ontvangen. Dit bevestigt dat je sleutel geldig is en het endpoint bereikbaar is.

Gebruik het chat-completions-eindpunt met een systeemprompt en een gebruikersbericht. Het antwoord bevat de gegenereerde tekst in het veld content.

Streamen en tokengebruik begrijpen

Schakel streaming in om tokens te ontvangen zodra ze gegenereerd worden in plaats van te wachten op de volledige reactie. Dit verbetert de waargenomen latentie voor lange outputs.

De API retourneert verbruiksstatistieken in het laatste chunk van de stream. Je kunt het aantal input- en outputtokens bijhouden voor transparante facturatie.

Stel de stream-parameter in op true in je request body. Itereer door de chunks om je definitieve tekst op te bouwen of verwerk deze realtime.

Afhandeling van fouten en weigeringen

Afhandelen van HTTP 401-fouten door te controleren of je API-sleutel correct is en niet verlopen. Een 402-fout geeft aan dat er onvoldoende vooruitbetaald krediet is; laad op via crypto om door te gaan.

Een 429-status betekent dat je de limiet van 300 verzoeken per minuut hebt bereikt. Wacht kort voordat je het opnieuw probeert of vermindere je gelijktijdige verbindingen.

Het model weigert verzoeken die seksuele content met minderjarigen betreffen, wat een harde limiet is. Andere controversiële of volwassen onderwerpen zijn over het algemeen toegestaan. Fouten en weigeringen verbruiken je token tegoed niet.

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)