NL ▾
API-sleutel aanvragen

Snelstart voor Ollama NSFW-gebruikers

Krijg je eerste respons in minuten door elke OpenAI-compatibele SDK te wijzen naar onze gehoste endpoint. Deze snelstart behandelt authenticatie, basis chat, streaming en function calling met ons ongecensureerde model.

Vereisten en Authenticatie

Je hebt een API-sleutel en de base URL nodig om te beginnen. Meld je aan op de API-sleutel verkrijgen-pagina met Google of e-mail. Je sleutel verschijnt direct; voor de gratis proeftegoed is geen creditcard nodig. De base URL is https://api.ollamansfw.com/v1. Stel dit in in je omgeving of SDK-configuratie. De model-ID is uncensored. Het is een open-weight model dat op onze servers draait, en verschilt van GPT of andere leveranciersmodellen.

Je eerste verzoek

Stuur een standaard chat-completion verzoek. De API verwacht een messages-array met een role en content. Gebruik curl om de connectiviteit te testen. Vervang YOUR_API_KEY door je daadwerkelijke sleutel. De response retourneert de gegenereerde tekst in choices[0].message.content. Als je een 401 krijgt, controleer dan je sleutel. Een 402 betekent dat je credit nodig hebt.

Python SDK-integratie

Gebruik het officiële openai Python-pakket. Installeer het via pip. Configureer de client met de aangepaste basis-URL en API-sleutel. Dit zorgt voor compatibiliteit met onze endpoint. De onderstaande code toont een eenvoudige tekstgeneratie. Het verwerkt het verzoek en drukt het resultaat af. Foutafhandeling moet HTTP-uitzonderingen vangen. Deze aanpak werkt voor elke OpenAI-compatibele client.

Node.js SDK-integratie

Installeer het openai Node.js-pakket. Stel de base URL en API-sleutel in bij de client-initialisatie. De structuur lijkt op het Python-voorbeeld. Geef de model-ID uncensored door. De response bevat de completion-gegevens. Gebruik async/await voor schone code. Deze methode is ideaal voor server-side applicaties of CLI-tools die directe API-toegang nodig hebben.

Streamingresponsen

Schakel streaming in door stream: true in te stellen. De API retourneert een server-sent events (SSE)-stream. Elke chunk bevat gedeeltelijke tekst. De laatste chunk bevat token-gebruiksstatistieken. Dit vermindert de waargenomen latentie voor lange responsen. Behandel streamfouten soepel. De SDK's bieden ingebouwde stream-iterators. Verwerk elke chunk om de UI in realtime bij te werken.

Limieten, Fouten en Context

Het contextvenster is 100,000 tokens in totaal. De output kan tot het einde van het venster lopen. Rate limits zijn 300 verzoeken per minuut. Gelijktijdige verzoeken zijn beperkt tot 8 per sleutel. Verzoeklichamen moeten onder 8 MB blijven. Veelvoorkomende fouten: 401 (ongeldige sleutel), 402 (onvoldoende tegoed), 429 (rate limit). Fouten verbruiken geen tegoed. Weigeringen voor onwettige inhoud zijn gratis. Tegoed vervalt nooit.

cURL

curl https://api.ollamansfw.com/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

from openai import OpenAI

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

Node.js

import OpenAI from "openai";

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

ja — server-sent events; het laatste deel bevat het tokenverbruik

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)

API-specificaties

Alle echte limieten en functies van de API op één plek — controleer ze voordat je opwaardeert.

OnderdeelWaarde
API-formaatOpenAI-compatibel: elke OpenAI-SDK werkt — vervang alleen base URL en sleutel
EndpointsPOST /v1/chat/completions · GET /v1/models
AuthenticatieAuthorization: Bearer YOUR_KEY
Model-IDuncensored
Base URLhttps://api.ollamansfw.com/v1
Max. uitvoertot de rest van het venster van 100.000 tokens; max_tokens optioneel (geen aparte limiet)
Contextvenster100.000 tokens (invoer + uitvoer)
Parameterstemperature, top_p, stop, seed, presence_penalty, frequency_penalty
JSON-modusresponse_format: {"type": "json_object"}
Function callingja — tools, tool_choice; antwoorden bevatten tool_calls, ook bij streaming; resultaten als role: tool
Streamingja — server-sent events; het laatste deel bevat het tokenverbruik
ResponsheadersX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Rate limit300 verzoeken per minuut per sleutel
Verzoekgroottetot 8 MB
Gelijktijdige verzoekentot 8 tegelijk per sleutel
OpwaarderenUSDT (TRC20) of USDC (Base), elk heel bedrag van $20 tot $500
Afrekeningprepaid tegoed op basis van echt verbruik; fouten en weigeringen zijn gratis
Bonus+5% vanaf $50, +10% vanaf $100, +15% vanaf $200
Geldigheidbetaald tegoed verloopt niet, geen abonnement
Gratis proeftegoed$0,50 voor 7 dagen, zonder kaart · Proefsleutel: 2 parallelle verzoeken, 60 per minuut; volledige limieten (8 en 300) na eerste opwaardering
Prijs$0,15 per 1 mln invoertokens · $0,50 per 1 mln uitvoertokens
InloggenGoogle of e-mail en wachtwoord
Inhoudinhoud voor volwassenen toegestaan; seksuele inhoud met minderjarigen wordt geweigerd
Sleutelséén actieve sleutel per account; een nieuwe vervangt de oude

Foutcodes

Fouten komen als JSON met een vaste type; mislukte of geweigerde verzoeken kosten niets.

CodeTypeBetekenis
400bad_requestongeldige JSON, lege berichten, verkeerde parameter of context te lang
401missing_key · invalid_key · key_revokedsleutel ontbreekt, is onjuist of is vervangen
402no_creditgeen tegoed — waardeer op en ga direct verder
403content_blockedseksuele inhoud met minderjarigen — geweigerd, niet gerekend
404not_foundonbekend endpoint
413request_too_largebody groter dan 8 MB
429rate_limited · concurrencymeer dan 300/min of 8 tegelijk — wacht en probeer opnieuw
503upstream_busymodel bezet — probeer het over enkele seconden opnieuw

Vragen en antwoorden

Is dit de officiële Ollama API?

Nee, dit is een onafhankelijke gehoste API. We serveren ons eigen ongecensureerde model via een OpenAI-compatibele endpoint. Het is niet gelieerd aan Ollama, hoewel het vergelijkbare conventies gebruikt.

Hoe laad ik tegoed op?

Laad op met USDT (TRC20) of USDC (Base). Het minimumbedrag is $20. Bonussen gelden voor hogere stortingen. Tegoed wordt berekend op basis van werkelijk token-gebruik. Fouten en weigeringen zijn gratis.

Wat is de grootte van het contextvenster?

Het totale contextvenster is 100,000 tokens voor prompt en voltooiing samen. Als max_tokens niet is ingesteld, kan de respons tot het einde van het venster lopen.