Snelstart voor Minicpm-gebruikers

Base URL en Authenticatie

Voor gebruik van deze API heb je een API-sleutel en de juiste base URL nodig. Onze service is volledig compatibel met de standaard OpenAI-clientbibliotheken. Je hoeft geen nieuwe afhankelijkheden te installeren of een nieuwe SDK te leren. Wijs je bestaande client eenvoudig naar onze endpoint.

Genereer een sleutel op de API-sleutel ophalen pagina. Je kunt inloggen met Google of een e-mail en wachtwoord gebruiken. De sleutel wordt direct weergegeven. Bewaar deze veilig. Elk verzoek moet deze sleutel bevatten in de Authorization header.

De base URL voor alle verzoeken is: https://api.minicpm.cc/v1. Deze URL verwerkt chatcompleties, modellijsten en streaming-responses. Er zijn geen aparte endpoints voor embeddings of vision. Dit is een tekst-API.

Eerste Verzoek

Stuur een standaard chatcompletie-verzoek om tekst te genereren. De model-ID is altijd uncensored. Dit model is een open-weight large language model dat is afgestemd op het geven van antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik. Het is geen GPT, Claude of een model van een andere leverancier.

Stel het model veld in op uncensored. Geef je berichten op in het standaard array formaat. De API retourneert een tekst reactie. Je kunt de output lengte beheren met max_tokens. Als je dit niet instelt, is de standaard max output 2.048 tokens.

Python SDK Integratie

Gebruik de officiële OpenAI Python library om met de API te communiceren. Je hoeft alleen de base URL en API-sleutel te configureren. De rest van de library werkt zoals verwacht. Dit omvat ondersteuning voor streaming, function calling en JSON-modus.

Installeer de library met pip install openai. Initialiseer de client met je base URL en sleutel. Stuur berichten naar de chat completions endpoint. Het response object bevat de gegenereerde tekst, token usage en finish reason. Je kunt deze velden direct in je Python code benaderen.

Node SDK Integratie

De Node.js SDK werkt identiek aan de Python versie. Installeer het package en configureer de base URL. De client behandelt authenticatie en request formatting automatisch. Hierdoor kun je de API snel integreren in je backend services.

Geef de base URL en API-sleutel mee aan de OpenAI client constructor. Gebruik de chat.completions.create methode. De response structuur komt overeen met de OpenAI standaard. Je kunt fouten afhandelen, token usage controleren en de content verwerken. Deze aanpak zorgt voor compatibiliteit met bestaande codebases die al OpenAI gebruiken.

Streaming Reacties

Schakel streaming in door stream: true in te stellen in je verzoek. De API retourneert een reeks Server-Sent Events (SSE). Elk event bevat een chunk van de reactie. Hiermee kun je tekst direct aan de gebruiker tonen terwijl deze wordt gegenereerd.

De laatste chunk bevat de token usage statistieken. Dit is handig voor het bijhouden van kosten. Streaming vermindert de perceived latency voor gebruikers. Het wordt aanbevolen voor chat interfaces. Je kunt de events in je client code parseren om de finale response te bouwen of tokens in real time weer te geven.

Limieten, Fouten en Context

Het model ondersteunt een contextvenster van 100.000 tokens. Dit omvat zowel de prompt als de completion. De maximale output per verzoek is 32.000 tokens. Je kunt de max_tokens parameter aanpassen om dit te beheren.

Rate limits zijn ingesteld op 300 verzoeken per minuut per sleutel. Je kunt 8 gelijktijdige verzoeken hebben. De request body moet kleiner zijn dan 8 MB. Als de sleutel ongeldig is, ontvang je een 401-fout. Als je geen tegoed hebt, ontvang je een 402-fout. Als je het rate limit overschrijdt, ontvang je een 429-fout. Fouten en refusals verbruiken geen tegoed.

cURL

Copycurl https://api.minicpm.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Streaming

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)

2026-050