da ▾

Ollama endpoint API-dokumentation

Kom i gang med at bygge med den ukensurerede LLM API på få sekunder. Denne guide dækker base-URL, autentificering og SDK-integration til dine OpenAI-kompatible API-arbejdsgange.

Base URL og autentificering

Brug den angivne base URL og en API-nøgle til hver anmodning. Endpointet er https://api.ollamaendpoint.com/v1Autorisation header som en Bearer-token. Du genererer denne nøgle straks efter login med Google eller e-mail. Nøglen er unik for hver konto og erstatter enhver tidligere aktiv nøgle.

Første anmodning

Send en standard chat-completion for at generere tekst. Model-ID er uncensored and accepts the same parameters as standard OpenAI clients. This works for NSFW LLM tasks or unrestricted content generation.

  • Metode: POST
  • Endpoint: /v1/chat/completions
  • Model: uncensored
curl https://api.ollamaendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Get the local ip address of this machine"}]
  }'

Et succesfuldt svar returnerer den genererede tekst i choices array. Tjek de usage felt til at se token-tællinger.

Python SDK-integration

Installer den officielle OpenAI-bibliotek og konfigurer base URL. Dette giver dig mulighed for at bruge den uncensored ollama-model med velkendt Python-kode. Indstil base_url og api_key før klientinitialisering. Koden forbliver kompatibel med eksisterende OpenAI SDK'er.

from openai import OpenAI

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

Kald chat.completions.create Metode præcis som du ville for GPT. Svarstrukturen matcher standardforventninger. Du kan streame eller få fulde svar.

Node SDK-integration

Brug Node.js OpenAI-pakken til at interagere med API'et. Konfigurer klienten med den tilpassede base URL og din API-nøgle. Denne tilgang fungerer til server-side applikationer eller edge-funktioner. Pakken håndterer automatisk serialisering og gentagelser.

import OpenAI from "openai";

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

Kald completion-endpointet med din prompt. Biblioteket returnerer et promise, der opløses til response-objektet. Håndter fejl i overensstemmelse med standard HTTP-statuskoder.

Streaming-svar med SSE

Aktivér streaming ved at indstille stream: true i din anmodning. Serveren returnerer en stream af Server-Sent Events (SSE). Hver chunk indeholder delvis tekst og tokenforbrugsdata. Den sidste chunk indeholder de fulde forbrugsstatistikker til fakturering. Dette reducerer den opfattede forsinkelse for lange output.

stream = 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)

Ophob indholdsdelene fra hver chunk for at rekonstruere det fulde svar. Behandle fejl, mens de ankommer i streamen. Den sidste chunk bekræfter tokenantallet til din forudbetalede kredit.

Rate Limits og Begrænsninger

Hver API-nøgle understøtter 300 anmodninger i minuttet og 8 samtidige anmodninger. Den maksimale størrelse for anmodningskroppen er 8 MB. Context-vinduet er 100,000 tokens for prompt og completion tilsammen. Outputgrænser er 16,000 tokens pr. anmodning. Fejl og afslag forbruger ikke kredit. En 401-fejl betyder, at din nøgle er ugyldig. En 402-fejl indikerer utilstrækkelig forudbetalt kredit. En 429-fejl betyder, at du har ramt hastighedsgrænsen. Juster din konkurrenceevne for at holde dig inden for grænserne.

FAQ

Hvad er basis-URL til ollama endepunkt?

Den basale URL er HTTPS://api.ollamaendpoint.com/v1. Brug dette til alle API-opkald. Det er kompatibelt med standard OpenAI-klienter.

Hvordan håndterer jeg streaming-svar?

Indstil stream-parameteren til true. API'et returnerer Server-Sent Events. Behver chunk for at opbygge den endelige tekst. Den sidste chunk indeholder forbrugsdata.

Hvad sker der, hvis jeg rammer en hastedsbegrænsning?

Du modtager en 429-statuskode. Grænsen er 300 anmodninger i minuttet per nøgle. Reducer din konkurrence eller vent, før du prøver igen. Samtidige anmodninger er begrænset til 8.

Hent din API-nøgle

Tilmeld dig, få nøglen, og peg på den nye base-URL. Færdig.

Start nu