API Documentatie & Snelstart

Basis-URL en authenticatie

Gebruik onze basis-URL en één API-sleutel om verbinding te maken. Het eindpunt accepteert standaard headers. Vervang YOUR_API_KEY met de string uit je dashboard.

• Basis-URL: https://api.ollamaopenaicompatibleapi.com/v1
• Model-ID: uncensored

Authenticatie is afhankelijk van een bearer-token. Voer het in de Authorization header. Dit zorgt voor compatibiliteit met elke OpenAI SDK-compatible client. Je kunt direct een nieuwe sleutel genereren via Google of e-mail. Er is geen telefoonnummer nodig.

Chat Completions Endpoint

Stuur een POST-verzoek naar /v1/chat/completions. Voeg uw messages-array en modelnaam toe. De API retourneert tekstuitvoer op basis van uw prompt. Dit werkt met elke provider die standaardparameters gebruikt.

Stel de temperatuur in voor creativiteit of houd deze laag voor precisie. Je kunt ook stop-sequenties definiëren. De server verwerkt het verzoek en retourneert de voltooiing. Dit is de kerninteractie voor de meeste integraties.

Onthoud dat fouten je prepaid credit niet verbruiken. Alleen succesvolle voltooiingen worden gefactureerd. Dit beschermt je budget tijdens debugfases.

Copycurl https://api.ollamaopenaicompatibleapi.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 Linux kernel security patches from 2023"}]
  }'

Streaming-responsen via SSE

Activeer streaming door stream: true. De server stuurt chunks naarmate ze worden gegenereerd. Dit vermindert de waargenomen latentie aanzienlijk. Je ontvangt gedeeltelijke responsen in realtime.

Parseer de Server-Sent Events-stream. Het laatste blok bevat verbruiksstatistieken. Dit omvat tokenaantallen voor zowel input als output. U kunt de kosten dynamisch bijhouden tijdens de generatie.

Deze aanpak werkt goed voor chat-interfaces. Gebruikers zien tekst woord voor woord verschijnen. Het voelt responsiever aan dan wachten op de volledige respons. De API verwerkt de verbindingstabiliteit automatisch.

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)

Function Calling en JSON-modus

Definieer tools in de request body. Het model kan gestructureerde data retourneren. Gebruik response_format met {"type": "json_object"} voor strikte JSON. Dit zorgt ervoor dat de uitvoer elke keer parsebaar is.

Tooldefinities bevatten naam, beschrijving en parameters. Het model beslist welke tool aangeroepen moet worden. Je voert de functie uit en voert de resultaten terug. Dit maakt complexe agent-workflows mogelijk.

JSON-modus schakelt vrije tekstgeneratie uit. Het dwingt het model om zich aan uw schema te houden. Gebruik dit bij integratie met databases of API's. Het vermindert hallucinaties in gestructureerde velden.

Copyfrom openai import OpenAI

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

Rate Limits en verzoeklichamen

Je krijgt 300 verzoeken per minuut per sleutel. Concurrency is beperkt tot 8 gelijktijdige verzoeken. De maximale grootte van de request body is 8 MB. Dit is geschikt voor de meeste tekstgerichte toepassingen.

Contextvenster staat 100.000 tokens totaal toe. Dit omvat zowel prompt als voltooiing. Maximale uitvoer per verzoek is 16.000 tokens. Als je max_tokens, het standaardwaarde is 2.048.

Afhandelen van HTTP 429-fouten op een beheersbare manier. Ze geven aan dat je de limiet hebt bereikt. Implementeer exponentiële backoff in je clientcode. Dit voorkomt dat de server wordt overbelast tijdens pieken.

Copyimport OpenAI from "openai";

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

Authenticatiefouten en limieten

Een 401-status betekent dat je sleutel ongeldig is. Controleer op typefouten of verlopen sessies. Een 402-status geeft aan dat er onvoldoende tegoed is. Vul aan via crypto om de dienst weer te gebruiken.

Een 429-status signaleert rate limiting. Je hebt meer dan 300 verzoeken per minuut gedaan. Verminder je doorvoersnelheid of upgrade je sleutel. De API retourneert duidelijke foutmeldingen.

Krediet vervalt niet. Je kunt op elk moment bijbetalen. Minimale bijbetaling is $20. Bonuscredits zijn van toepassing bij hogere bedragen. Dit houdt je project soepel draaiend.