Dolphin AI API Quickstart

Basis-URL & Authenticatie

Begin met het instellen van de basis-URL en API-sleutel in je clientconfiguratie. Alle verzoeken worden geauthenticeerd via de Authorization header met je unieke sleutel. Onze dienst fungeert als onafhankelijke provider voor de openrouter dolphin AI modelvariant, wat betekent dat je geen account op OpenRouter nodig hebt om dit endpoint te gebruiken. Haal je key op uit het dashboard en voeg deze toe aan je environment variables.

• Basis-URL: https://api.openrouterdolphinai.com/v1
• Header: Authorization: Bearer YOUR_API_KEY

Deze opstelling werkt met elke standaard OpenAI SDK omdat we hun exacte endpointstructuur imiteren. Je communiceert alleen met het chat-completions endpoint, wat je integratie eenvoudig en gericht op tekstgeneratie houdt.

Eerste verzoek

Verstuur je eerste bericht om tekst te genereren met de eenvoudige POST methode. De model-ID is altijd uncensored, wat ervoor zorgt dat je de specifieke uncensored variant krijgt die is afgestemd op onbeperkte dialoog. Je hoeft geen complexe routing parameters op te geven omdat we dit enkele model direct hosten.

Gebruik de volgende curl-opdracht om uw verbinding onmiddellijk te testen:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

Als u een JSON-antwoord met inhoud ontvangt, is uw sleutel actief en worden credits correct afgeschreven. Fouten zoals 401 duiden op een ongeldige sleutel, terwijl 402 betekent dat u moet bijbetalen via crypto. Deze directe aanpak voorkomt de variabiliteit van multi-model routers.

Python SDK Integratie

Integreer snel met de officiële OpenAI Python-bibliotheek door deze te wijzen naar onze base URL. Hiermee kun je bekende methoden zoals chat.completions.create() zonder dat je de volledige logica hoeft te herschrijven. De bibliotheek verwerkt de serialisatie automatisch, zodat je je kunt concentreren op promptontwerp in plaats van HTTP-details.

Configureer de client met je basis-URL en sleutel:

Copyfrom openai import OpenAI

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

Onthoud dat ons contextvenster 100,000 tokens omvat, dus je kunt aanzienlijke gespreksgeschiedenis doorgeven. De SDK zal de tokenisatie en verzending efficiënt afhandelen, zodat je prompts het model bereiken zonder onnodige overhead of formatteringsfouten.

Node SDK-gebruik

Node-ontwikkelaars kunnen dezelfde resultaten bereiken met behulp van de openai npm package. Net als de Python-versie moet je de standaard basis-URL overschrijven om naar onze speciale servers te verwijzen. Dit zorgt ervoor dat je verzoeken direct naar het ongekende model gaan zonder te maken te krijgen met de limieten van derden of routeringsvertragingen.

Initialiseer de client met het juiste eindpunt:

Copyimport OpenAI from "openai";

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

Dit patroon werkt zowel voor synchronische aanroepen als voor async/await-patronen. Je kunt responsen streamen of de JSON-modus direct binnen dezelfde functieaanroep aanvragen, wat je flexibiliteit biedt voor verschillende applicatie-architecturen zonder je core-authenticatie-instelling te wijzigen.

Streaming-responsen

Real-time tekstgeneratie inschakelen door stream: true in je request parameters. De API retourneert een Server-Sent Events (SSE) stream, waardoor je tokens kunt weergeven zodra ze worden gegenereerd. Dit vermindert de waargenomen latentie voor gebruikers, waardoor de ervaring veel sneller aanvoelt dan wachten op een volledig antwoord.

Verwerk de stream om de uiteindelijke tekst op te bouwen:

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)

Elke chunk bevat tokenverbruiksgegevens in het laatste deel, zodat je kosten nauwkeurig kunt bijhouden. Streamen is ideaal voor chatinterfaces waar directe feedback de gebruikersbetrokkenheid verbetert. Je kunt het stream op elk moment stoppen als de gebruiker een nieuw bericht stuurt, waardoor credits worden bespaard bij gedeeltelijke responsen.

Limieten, Fouten & Context

Begrijp de technische grenzen om onverwachte onderbrekingen in je applicatie te voorkomen. Onze API handhaaft een contextvenster van 100.000 tokens per verzoek, zowel voor prompt als completion. Als je de limiet van 16.000 tokens voor output overschrijdt, stopt de generatie, dus stel max_tokens overeenkomstig om kosten te beheersen.

Veelgemaakte HTTP-statuscodes zijn onder andere 401 voor ongeldige sleutels, 402 voor onvoldoende tegoed en 429 voor rate limits. Je bent beperkt tot 300 verzoeken per minuut per sleutel. Deze beperkingen zorgen voor eerlijk gebruik door alle gebruikers. Gebruik de 429 fout om exponentiële backoff in je clientcode te implementeren, zodat de werking tijdens piekverkeersperiodes soepel verloopt.