Eerste verzoek in vijf minuten

Basis-URL & Authenticatie

Wijs je OpenAI SDK of een andere compatibele client naar onze basis-URL. Je hebt geen specifieke bibliotheek nodig; elke tool die een standaard API-sleutel accepteert, werkt hier. Haal je sleutel op in het dashboard na het inloggen met Google of e-mail. De sleutel wordt direct weergegeven en is het enige vereiste referentiemateriaal voor alle verzoeken.

Stel de basis-URL in op https://api.ollamaapi.top/v1. Gebruik de model-ID uncensored voor alle chatcompleties. Dit model is open-weight, getuned voor minder weigeringen en verschilt van modellen van grote leveranciers. Het is geen GPT, Claude of een ander propriëtair model. Authenticatie verloopt uitsluitend via de Bearer-token header.

Eerste verzoek

Stuur een standaard chatcompletion-verzoek om de connectiviteit te testen. Het endpoint accepteert JSON-payloads met messages, model en optionele parameters zoals temperature of max_tokens. De model-ID is altijd uncensored. Antwoorden retourneren gestructureerde JSON inclusief de inhoud van de assistent en tokenverbruiksmetrics.

Als het verzoek slaagt, ontvang je een 200 OK-antwoord. Als de authenticatie faalt, krijg je een 401-fout. Als je geen tegoed hebt, krijg je een 402-fout. Deze fouten zijn gratis, dus je betaalt alleen voor succesvol tokengebruik. Gebruik dit voorbeeld om je configuratie te verifiëren voordat je het in je applicatie integreert.

Copycurl https://api.ollamaapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

Gebruik de officiële OpenAI Python-bibliotheek of een andere compatibele client. Initialiseer de client met je basis-URL en API-sleutel. Stel het model in op uncensored. Geef je berichten door als een lijst met dictionaries met role en content. De bibliotheek verwerkt serialisatie en responsparsering automatisch.

Streaming responses worden ondersteund via de parameter stream. Hiermee kun je tokens verwerken terwijl ze worden gegenereerd, wat nuttig is voor lange uitvoeren of realtime UI-updates. De laatste chunk bevat het totale tokenverbruik voor facturering. Zorg dat je uitzonderingen afhandelt, omdat netwerkfouten geen kosten met zich meebrengen.

Copyfrom openai import OpenAI

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

Installeer het openai npm-pakket of gebruik een fetch-gebaseerde wrapper. Configureer de client met de basis-URL https://api.ollamaapi.top/v1 en je API-sleutel. De model-ID blijft uncensored. Geef de request body mee met messages en optionele instellingen zoals top_p of seed.

Node.js-gebruikers kunnen async/await-patronen gebruiken voor schone code. Het responsobject bevat choices, usage en id. Je kunt het bericht van de assistent extraheren uit de eerste keuze. Foutafhandeling moet rekening houden met rate limits (429) en onvoldoende tegoed (402). Deze fouten verbruiken geen tokens, dus je prepaid tegoed blijft intact totdat een succesvol antwoord is gegenereerd.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapi.top/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 antwoorden

Schakel streaming in door stream: true in je verzoek in te stellen. De API retourneert een Server-Sent Events (SSE)-stream. Elke chunk bevat gedeeltelijke inhoud, waardoor je tokens kunt weergeven terwijl ze worden gegenereerd. Dit vermindert de waargenomen latentie voor gebruikers en verbetert de ervaring bij het genereren van lange teksten.

De laatste chunk in de stream bevat de volledige tokenverbruiksgegevens. Je kunt dit gebruiken om het verbruik in realtime te volgen. Houd er rekening mee dat streaming het prijsmodel niet verandert; je betaalt nog steeds per 1M input- en outputtokens. Fouten tijdens streaming zijn ook gratis. Als de verbinding verbroken raakt, kun je het verzoek hervatten of opnieuw starten zonder boete.

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, fouten & context

Het contextvenster is in totaal 100.000 tokens, inclusief zowel prompt als completion. De maximale uitvoer per verzoek is 32.000 tokens (2.048 als max_tokens niet is ingesteld). Als je het contextvenster overschrijdt, faalt het verzoek. Fouten zijn 401 voor ongeldige sleutels, 402 voor onvoldoende tegoed en 429 voor rate limits. Het rate limit is 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel. Request bodies zijn beperkt tot 8 MB. Fouten zijn gratis, wat betekent dat je niet betaalt voor mislukte verzoeken of afwijzingen. Het tegoed verloopt nooit en er is geen abonnement nodig.