Base URL en authenticatie
Stuur je OpenAI-compatibele client naar de base URL van de Mimo API. Je ontvangt direct na het aanmelden met Google of e-mail een API-sleutel. Voeg deze sleutel toe aan de standaard Authorization-header. De model-ID is uncensored, een open-weight model dat is afgestemd op minder weigeringen bij wettelijke volwassen inhoud.
In tegenstelling tot abonnementsdiensten is de facturatie prepaid via crypto. Fouten verbruiken geen tegoed. Je kunt de verbinding controleren door modellen op te lijsten of een eenvoudig tekstverzoek te sturen. Houd je sleutel veilig; één sleutel per account vervangt de vorige als je een nieuwe genereert.
Standaard Chat-completies Endpoint
Stuur een standaard POST verzoek naar het chat-completies endpoint. Stel het model in op uncensored en lever je berichten in het vereiste array-formaat. De API retourneert tekstoutput op basis van je prompt. Je kunt parameters aanpassen zoals temperature of top_p om de creativiteit te sturen.
curl https://api.mimoapi.top/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 verwerkt tekst-in, tekst-uit interacties. Het ondersteunt geen embeddings, afbeeldingen of fine-tuning. Als je deze functies nodig hebt, moet je een andere service gebruiken. Het contextvenster staat 100.000 tokens toe in totaal voor prompt en antwoord samen.
Python SDK-integratie
Gebruik de officiële OpenAI Python library om met de API te communiceren. Overschrijf de base URL zodat deze naar de Mimo API endpoint wijst. Zo kun je dezelfde SDK-methoden gebruiken die je ook voor GPT-4 of andere modellen gebruikt. Stel de API-sleutel en het doelmodel in je clientconfiguratie in.
from openai import OpenAI
client = OpenAI(base_url="https://api.mimoapi.top/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)Deze aanpak zorgt ervoor dat je code draagbaar blijft. Als je van provider wisselt, verander je alleen de base URL en de sleutel. De Python SDK verwerkt serialisatie en retries automatisch. Je kunt ook parameters instellen zoals seed voor deterministische outputs.
Node SDK-integratie
Installeer het OpenAI Node.js package en configureer de base URL. Voeg je API-sleutel toe aan het configuratieobject. De client stuurt verzoeken naar de endpoint van het ongecensureerde model. Dit werkt met zowel CommonJS- als ES-module imports.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mimoapi.top/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);Node-ontwikkelaars kunnen dezelfde asynchrone patronen gebruiken die ze gebruiken met andere OpenAI-compatible diensten. De SDK verwerkt streamparsering en JSON-codering. Je kunt de max_tokens instellen om de outputlengte te bepalen, met een standaard van 2.048 als niet gespecificeerd.
Streaming antwoorden (SSE)
Schakel streaming in door stream: true in te stellen in je verzoek. De API retourneert Server-Sent Events (SSE) met gedeeltelijke tokens. Hierdoor kun je output progressief aan gebruikers tonen. Tokengebruikstatistieken verschijnen in de laatste chunk van de stream.
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)Streaming vermindert de waargenomen latentie bij lange antwoorden. Je moet de stream events afhandelen in je clientcode. De API garandeert geen exacte tokenaantallen tijdens streaming, maar de laatste chunk bevat accurate gebruiksdata. Dit is handig voor transparantie in facturatie.
Rate limits, fouten en JSON-modus
De API handhaaft een limiet van 300 verzoeken per minuut per sleutel en staat 8 gelijktijdige verzoeken toe. Als je dit overschrijdt, ontvang je een 429 fout. Een 401 fout geeft aan dat de sleutel ongeldig of verlopen is. Prepaid tegoed wordt alleen in rekening gebracht voor echt tokengebruik; fouten en afwijzingen zijn gratis.
Voor gestructureerde output gebruik je JSON-modus door response_format in te stellen op json_object. Dit dwingt het model om geldige JSON te retourneren. Dit is nuttig voor function calling of data-extractie. Het contextvenster ondersteunt maximaal 32.000 tokens output per verzoek.
