Dolphin AI API Quickstart

Authenticatie en basis-URL

Je API-sleutel verifieert elk verzoek. Gebruik de basis-URL https://api.dolphinaimodels.com/v1 voor alle eindpunten. Het systeem vereist een geldige sleutel in de Authorization header. Zonder dit mislukken requests direct.

Genereer je sleutel via het dashboard. Je ontvangt één actieve sleutel per account. Vervang je oude sleutel als je een nieuwe genereert. De sleutel geeft direct toegang tot het ongecensureerde model.

Een Chat Completion Request versturen

Stuur een POST-verzoek naar /v1/chat/completions. De model-ID is uncensored. Dit endpoint accepteert tekstinput en retourneert tekstoutput. Je kunt parameters aanpassen zoals temperatuur en top_p.

Hier is een basis cURL-voorbeeld om aan de slag te gaan:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

Python SDK Integratie

Gebruik de officiële OpenAI Python-bibliotheek. Wijs deze naar onze basis-URL. Geef je API-sleutel op. De codestructuur komt overeen met standaard OpenAI-gebruik. Dit zorgt voor een eenvoudige migratie voor bestaande projecten.

Configureer de client met deze waarden:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinaimodels.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 SDK-configuratie

Initialiseer de Node.js-client op dezelfde manier. Stel de basis-URL en API-sleutel in. De SDK handelt serialisatie automatisch af. Deze aanpak werkt zowel voor server-side als client-side applicaties.

Voorbeeldconfiguratie:

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinaimodels.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);

Stream-antwoorden verwerken

Activeer streaming door stream: true. De API retourneert Server-Sent Events (SSE). Elk chunk bevat gedeeltelijke tekst. Het laatste chunk bevat tokengebruiksgegevens. Dit vermindert de waargenomen latentie voor gebruikers.

Stream de respons:

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)

Limieten en fouten begrijpen

Het contextvenster is 100.000 tokens. Dit omvat prompt en voltooiing. Maximaal uitvoer is 16.000 tokens per verzoek. Fouten retourneren standaard HTTP-codes. 401 geeft een ongeldige sleutel aan. 402 betekent onvoldoende tegoed. 429 signaleert rate limiting.

Je bent beperkt tot 300 verzoeken per minuut. Concurrentie is beperkt tot 8 gelijktijdige verzoeken. Houd request bodies onder de 8 MB. Deze limieten zorgen voor stabiele prestaties voor je workload.