Mukenetsu AI API Snelstartgids

Basisconfiguratie en base URL

Mukenetsu AI is ontworpen als een OpenAI-compatible REST API. Hierdoor kun je bestaande OpenAI-clients en SDK's met minimale aanpassingen gebruiken. Gebruik de volgende base URL voor communicatie met de API.

https://api.mukenetsuapi.com/v1

In tegenstelling tot andere LLM-diensten hoef je geen complexe endpointkeuzes te maken of extra configuraties uit te voeren. We bieden slechts één chat-completie endpoint en een endpoint voor modellijsten. Deze eenvoudige structuur versnelt de ontwikkeling.

Je API-sleutel is direct beschikbaar na het aanmelden met je e-mailadres en wachtwoord op de API-sleutel ophalen-pagina. Er is geen actie op het dashboard nodig. Bovendien hechten we waarde aan privacy; je promptgegevens worden niet gebruikt voor modeltraining.

Authenticatie en API-sleutel

Toegang tot de API vereist authenticatie via de header Authorization: Bearer <API_KEY>. Gebruik de API-sleutel die bij het aanmaken van je account is gegenereerd. Aan elk account is één API-sleutel gekoppeld, maar je kunt deze op elk moment opnieuw genereren. Let op: bij het opnieuw genereren wordt de vorige sleutel ongeldig.

Bij een authenticatiefout krijg je meestal een 401 (Unauthorized) of 402 (Payment Required) respons. Een 401 geeft aan dat de sleutel onjuist of ongeldig is; een 402 betekent dat je accounttegoed ontoereikend is. Credits zijn prepaid en kunnen worden opgewaardeerd met cryptovaluta (USDT, USDC) vanaf $10.

Chat-completie endpoint

Het belangrijkste endpoint voor tekstgeneratie is POST /v1/chat/completions. Door een verzoek naar dit endpoint te sturen, kun je tekst genereren inclusief gesprekscontext en systeem prompts. Geef als model-ID uncensored op. Dit is een eigen open-weight model, anders dan de modellen van OpenAI's GPT of andere leveranciers.

Het volgende voorbeeld toont hoe je basis tekstgeneratie uitvoert met curl. De vereiste parameters zijn de model-ID, de berichten en optioneel de inschakeling van streaming.

コピーcurl https://api.mukenetsuapi.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."}]
  }'

Dit endpoint biedt geen functies zoals embeddings, beeldgeneratie of spraakconversie. Het is specifiek gericht op pure tekstcompletie en -generatie.

Streaming (SSE)

Wil je gegenereerde tekst realtime ontvangen, gebruik dan de streamingmodus. Door "stream": true in je verzoek op te nemen, stuurt de server data sequentieel in SSE-formaat. Hierdoor kun je gebruikers al tekst tonen voordat de generatie voltooid is.

Gebruik je de Python OpenAI SDK of een Node.js client library? Dan wordt streaming automatisch afgehandeld door de optie stream=True op te geven. De event handlers ontvangen chunks per token.

コピーfrom openai import OpenAI

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

Streaming is een belangrijke functie om de gebruikerservaring te verbeteren bij lange antwoorden of interactieve toepassingen. Als de verbreek echter tijdens streaming wordt verbroken, ontvang je geen verdere gebeurtenissen meer.

Tools/functieaanroepen

De Mukenetsu AI API ondersteunt tool (functie) calls. Dit maakt koppelingen met externe API's en databases eenvoudiger. Voeg het veld tools en de parameter tool_choice toe aan de request body om het model een specifieke functie uit te laten voeren.

Het model beslist of het een functie aanroept of normale tekst retourneert. Na voltooiing van de aanroep kun je het resultaat van de functie toevoegen aan messages en dit aan het model doorgeven voor een meer gedetailleerd antwoord.

コピーimport OpenAI from "openai";

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

Deze functie is vooral nuttig voor agent-applicaties en automatisering van complexe taken. Omdat we de OpenAI-compatible indeling hanteren, kun je bestaande logica voor tool calls direct hergebruiken.

Rate limits en beperkingen

Er gelden de volgende beperkingen voor API-gebruik: maximaal 300 verzoeken per minuut en een maximale request body-grootte van 8 MB. Overschrijding resulteert in een 429 (Too Many Requests) fout. Het contextvenster bedraagt 100.000 tokens (totaal van prompt + gegenereerde tekst). Voor langere gesprekken of documenten moet je ze in delen versturen.

Volg bij het ontvangen van streaming respons de volgende gebeurtenisstroom.

コピー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)

Sexuele inhoud met minderjarigen wordt streng beperkt conform de wet. Andere wettelijke volwasseneninhoud, fictie, security research en controversiële onderwerpen worden echter zonder censuur gegenereerd.