OpenRouter dolphin API-snelstartgids

Basis-URL en authenticatie

De base URL voor alle verzoeken is https://api.openrouterdolphin.com/v1. Je authenticeert door je API-sleutel mee te sturen in de Authorization

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

Authenticatie is streng. We ondersteunen niet meerdere sleutels per account. Het genereren van een nieuwe sleutel maakt de vorige direct ongeldig. Dit zorgt voor een duidelijk gebruiksbijhouding voor je voorgebetaalde tegoeden.

Eindpunt: POST /v1/chat/completions

Stuur tekstgegevens om antwoorden te genereren met behulp van de uncensored model. Dit endpoint verwerkt alle standaard chat-completies. Je definieert het model, berichten en parameters in de request-body.

Copyfrom openai import OpenAI

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

De API retourneert een standaard JSON-object met de gegenereerde tekst. Het ondersteunt geen embeddings, afbeeldingen of audio. Richt je op tekstgeneratieworkflows. Het model reageert op prompts zonder filtering van wettelijke volwassen of controversiële onderwerpen.

Eindpunt: GET /v1/models

Haal beschikbare modellen op via een eenvoudig GET-verzoek. Dit eindpunt bevestigt de model-ID die je moet gebruiken.

Copyimport OpenAI from "openai";

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

De respons geeft de uncensored model. Gebruik deze exacte ID in je completion-verzoeken. De API levert alleen dit enkele model. Er is geen routing- of modelselectielogica. Je communiceert direct met onze dedicated uncensored LLM-instantie.

Streaming en gebruiksgegevens

Activeer streaming door stream: true. De API retourneert chunks via Server-Sent Events (SSE). Elke chunk bevat een deel van de antwoordtekst.

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)

De laatste chunk bevat de volledige statistieken over tokengebruik. Je betaalt strikt voor de gegenereerde uitvoertokens. Fouten en weigeringen brengen geen kosten met zich mee. Deze structuur stelt je in staat om responsen in realtime te renderen in je applicaties.

Parameters: Temperature, Top P en Tools

Reguleer het generatiegedrag met standaardparameters. Stel temperature voor willekeur en top_p voor nucleus sampling. Schakel functaanroepen in door een tools array.

Gebruik response_format met {"type": "json_object"} voor strikte JSON-output. Je kunt ook seed voor reproduceerbaarheid. De API ondersteunt presence_penalty en frequency_penalty voor het verfijnen van woordgebruik. Deze parameters werken exact zoals in standaard OpenAI-clients.

Rate Limits en verzoekgrootte

Elke API-sleutel staat 300 verzoeken per minuut toe. Je kunt maximaal 8 gelijktijdige verzoeken uitvoeren. De maximale grootte van de request body is 8 MB. Het contextvenster ondersteunt 100,000 tokens voor input en output samen.

Maximale uitvoer per verzoek is 16.000 tokens. Als je max_tokens niet instelt max_tokens, de standaardwaarde is 2.048 tokens. Het overschrijden van deze limieten resulteert in een 429-fout. Plan je batching-strategie daarop. Credits vervallen nooit, dus je kunt gebruik accumuleren over tijd zonder druk.