API Documentatie

Basis-URL en authenticatie

De API is actief op https://api.ollamaapidoc.com/v1. Je authenticeert met een Bearer-token in de Authorization header. Genereer je sleutel direct via Google of e-mail op het dashboard. Geen telefoonnummer vereist. De sleutel werkt met standaard OpenAI SDK's door de basis-URL in te stellen.

Je Eerste Verzoek

Stuur een POST-verzoek naar /v1/chat/completions met de model-ID uncensored. Dit endpoint verwerkt tekstinput en tekstoutput. Het ondersteunt streaming, JSON-modus en function calling. Je kunt de verbinding testen zonder tegoed uit te geven door eerst het models-endpoint te controleren.

Copycurl https://api.ollamaapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all installed models"}]
  }'

De respons retourneert standaard OpenAI-indeling. Fouten retourneren passende HTTP-codes. Controleer de body voor error details als er iets misgaat. Streaming-antwoorden gebruiken Server-Sent Events.

Python SDK Integratie

Installeer de officiële OpenAI bibliotheek. Configureer de client met je basis-URL en API-sleutel. Roep het chat-completions-eindpunt aan. De code blijft identiek aan standaard OpenAI-gebruik. Dit zorgt voor een eenvoudige migratie voor bestaande projecten. Je kunt parameters zoals temperatuur en top_p direct aanpassen in de aanroep.

Copyfrom openai import OpenAI

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

Verwerk uitzonderingen voor snelheidslimieten of ongeldige sleutels. De bibliotheek streamt tokens als u stream op true zet. Deze aanpak houdt uw codebase schoon en compatibel.

Node.js SDK-instelling

Gebruik de openai npm package. Initialiseer de client met de aangepaste basis-URL. Geef je API-sleutel door. De syntaxis lijkt op het Python-voorbeeld. Deze consistentie vermindert de foutopzoektijd. Je kunt meerdere berichten sturen in een conversatiegeschiedenis-array.

Copyimport OpenAI from "openai";

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

Parseer de respons zorgvuldig. De API retourneert gestructureerde JSON. Foutafhandeling is cruciaal voor productie-applicaties. Vang netwerkfouten en API-specifieke fouten afzonderlijk af. Dit zorgt ervoor dat uw app responsief blijft tijdens hoog verkeer.

Streaming en JSON Mode

Schakel streamen in door de stream parameter naar true. De API verzendt tokens via Server-Sent Events. Je ontvangt gedeeltelijke responsen in real-time. Dit verbetert de gebruikerservaring voor lange outputs. Je kunt ook JSON-uitvoer afdwingen met response_format. Dit is nuttig voor gestructureerde gegevensextractie.

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 werkt vergelijkbaar. Definieer tools in je verzoek. Het model retourneert toolaanroepen. Parse deze aanroepen in je code. Voer ze uit en voer resultaten terug naar het model. Deze lus maakt complexe workflows mogelijk.

Limieten, fouten en context

Het contextvenster is 100.000 tokens. Maximaal uitvoer is 16.000 tokens per verzoek. Fouten omvatten 401 voor ongeldige sleutels en 402 voor onvoldoende krediet. Snelheidslimieten zijn maximaal 300 verzoeken per minuut. Verwerk deze soepel in je app. De API gebruikt je prompts nooit voor training. Privacy wordt gewaarborgd. Krediet verloopt niet.