Ollama API Documentatie voor Ontwikkelaars

Authenticatie en basis-URL

Gebruik https://api.ollamaendpointurl.com/v1 als je basis-URL en voeg je API-sleutel toe in de Authorization header.

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

Genereer direct je sleutel via Google of e-mail op het dashboard. Geen telefoonnummer is vereist. Deze URL werkt met elke standaard OpenAI SDK door de basis-URL te overschrijven.

Eerste verzoek

Stuur een POST-verzoek naar /v1/chat/completions met de model-ID uncensored en je berichten.

Copycurl https://api.ollamaendpointurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
  }'

Dit retourneert een JSON-antwoord met de gegenereerde tekst. Als je een 401-fout krijgt, is je API-key ongeldig. Een 402-fout geeft aan dat er onvoldoende vooruitbetaald krediet is.

Python SDK Integratie

Initialiseer de client met je sleutel en de aangepaste basis-URL om verzoeken programma-gestuurd te versturen.

Copyfrom openai import OpenAI

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

Instellen max_tokens om de lengte van de uitvoer te bepalen. Zonder deze parameter is de standaardwaarde 2.048 tokens. Het model accepteert standaardparameters zoals temperature en top_p voor het afstemmen van het generatiegedrag.

Node SDK-integratie

Configureer de Node.js-client om naar ons eindpunt te wijzen voor naadloze integratie in je scripts.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaendpointurl.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 SDK verwerkt serialisatie automatisch. Zorg ervoor dat je een recente versie van de OpenAI SDK gebruikt die aangepaste basis-URLs ondersteunt. Fouten worden gegooid als standaard API-exceptions.

Streaming-responsen

Activeer streaming door stream: true om tokens te ontvangen via Server-Sent Events (SSE).

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)

Tokenverbruiksgegevens verschijnen in de laatste chunk van de stream. Dit vermindert de waargenomen latentie voor lange uitvoeren. Het endpoint ondersteunt standaard SSE-indeling compatibel met de meeste clientbibliotheken.

Rate Limits en contextvenster

Elke API-sleutel is beperkt tot 300 verzoeken per minuut en 8 gelijktijdige verzoeken. Het contextvenster is in totaal 100,000 tokens. De maximale output per verzoek is 16,000 tokens. Verzoeken met een body groter dan 8 MB worden afgewezen. Een 429-fout geeft aan dat je de rate limit hebt bereikt. Wacht kort voordat je het opnieuw probeert. Fouten en weigeringen verbruiken geen tegoed. Tegoed vervalt nooit. Gebruik crypto om op te laden. Begin met $0.50 proeftegoed. Haal nu je sleutel op.