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.
| Onderdeel | Waarde |
|---|---|
| API-formaat | OpenAI-compatibel: elke OpenAI-SDK werkt — vervang alleen base URL en sleutel |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Authenticatie | Authorization: Bearer YOUR_KEY |
| Model-ID | uncensored |
| Base URL | https://api.ollamansfw.com/v1 |
| Max. uitvoer | tot de rest van het venster van 100.000 tokens; max_tokens optioneel (geen aparte limiet) |
| Contextvenster | 100.000 tokens (invoer + uitvoer) |
| Parameters | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON-modus | response_format: {"type": "json_object"} |
| Function calling | ja — tools, tool_choice; antwoorden bevatten tool_calls, ook bij streaming; resultaten als role: tool |
| Streaming | ja — server-sent events; het laatste deel bevat het tokenverbruik |
| Responsheaders | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Rate limit | 300 verzoeken per minuut per sleutel |
| Verzoekgrootte | tot 8 MB |
| Gelijktijdige verzoeken | tot 8 tegelijk per sleutel |
| Opwaarderen | USDT (TRC20) of USDC (Base), elk heel bedrag van $20 tot $500 |
| Afrekening | prepaid tegoed op basis van echt verbruik; fouten en weigeringen zijn gratis |
| Bonus | +5% vanaf $50, +10% vanaf $100, +15% vanaf $200 |
| Geldigheid | betaald 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 |
| Inloggen | Google of e-mail en wachtwoord |
| Inhoud | inhoud 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.
| Code | Type | Betekenis |
|---|---|---|
400 | bad_request | ongeldige JSON, lege berichten, verkeerde parameter of context te lang |
401 | missing_key · invalid_key · key_revoked | sleutel ontbreekt, is onjuist of is vervangen |
402 | no_credit | geen tegoed — waardeer op en ga direct verder |
403 | content_blocked | seksuele inhoud met minderjarigen — geweigerd, niet gerekend |
404 | not_found | onbekend endpoint |
413 | request_too_large | body groter dan 8 MB |
429 | rate_limited · concurrency | meer dan 300/min of 8 tegelijk — wacht en probeer opnieuw |
503 | upstream_busy | model 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.