Maak de sleutel in vijf stappen
Om een Mimo API-sleutel voor deze service te krijgen, volg je deze stappen. Hiervoor heb je geen bankkaart of telefoontje nodig.
- Registreer je. Gebruik Google, of registreer je met een e-mailadres en een wachtwoord.
- Open de sleutelpagina. Ga na het registreren naar de API-sleutelpagina. Je sleutel wordt daar getoond.
- Claim het proeftegoed. Nieuwe gebruikers kunnen met één klik op die pagina $0,50 aan gratis proeftegoed claimen. Het tegoed is 7 dagen geldig, vereist geen bankkaart en is beperkt tot één per persoon.
- Kopieer de sleutel en sla deze op een veilige plek op, zoals in een wachtwoordbeheerder of een omgevingsvariabele.
- Stuur een testverzoek met het curl-commando in de volgende sectie.
De service is een gehoste, OpenAI-compatibele tekst-API. Hij draait één open-weight model van een onafhankelijke provider, afgestemd op antwoorden zonder inhoudelijke weigeringen voor wettig gebruik door volwassenen. Het is niet de officiële API van een modelleverancier. Je sleutel werkt met dat ene model, met ID uncensored, op de basis-URL https://api.mimoapi.top/v1.
Test de sleutel met één verzoek
Doe de test in een terminal voordat je de sleutel in een app integreert. Als het hier mislukt, is het probleem de sleutel of het account, en hoef je niet door je eigen code te zoeken.
export LLM_API_KEY="paste-your-key-here"
curl -i https://api.mimoapi.top/v1/chat/completions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write one sentence about keys."}],
"max_tokens": 60
}'
Een goed resultaat is een 200 statuscode en een JSON-antwoord met een choices-array. De headers bevatten X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency. De balansheader is een snelle manier om te zien wat het verzoek kost: voer het twee keer uit en vergelijk. Als je de sleutel alleen wilt bevestigen zonder geld uit te geven, roep je GET /v1/models aan met dezelfde header.
Hetzelfde verzoek in Python, met het officiële OpenAI-pakket:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one sentence about keys."}],
max_tokens=60,
)
print(resp.choices[0].message.content)Wat de proefsleutel wel en niet kan
Het proeftegoed is bedoeld voor testen, niet voor productie. Een proefsleutel staat 2 gelijktijdige verzoeken en 60 verzoeken per minuut toe, met een levensduur van 7 dagen. Een volledige sleutel, die je krijgt zodra je tegoed hebt toegevoegd, staat 8 gelijktijdige verzoeken en 300 per minuut toe. Beide delen hetzelfde model, hetzelfde contextvenster van 100.000 tokens en dezelfde functies: streaming via SSE, function calling, JSON-modus en de gebruikelijke sampling-parameters.
Hoe ver reikt $0,50? Bij $0,15 per 1M inputtokens en $0,50 per 1M outputtokens kost een verzoek met 1.000 inputtokens en 300 outputtokens 1.000 x $0,15 / 1.000.000 = $0,00015 voor input plus 300 x $0,50 / 1.000.000 = $0,00015 voor output, wat in totaal $0,0003 is. Het gratis proeftegoed dekt ongeveer 1.666 verzoeken van die grootte ($0,50 / $0,0003). Dat is genoeg om prompts te testen, een prototype te bouwen en streaming of tools te proberen.
Gebruik de proefversie voor metingen. Kies de vijf prompts die je app het vaakst zal versturen, voer ze een paar keer uit en registreer de balanswijziging. Je eindigt de week met de werkelijke kosten per verzoek en inzicht in hoe het model zich gedraagt op jouw data. Mislukte of geweigerde verzoeken worden niet in rekening gebracht.
Houd de sleutel privé
Een API-sleutel is een wachtwoord dat ook geld uitgeeft. Iedereen die hem heeft, kan verzoeken tegen je balans uitvoeren. Een paar regels voorkomen de meeste lekken:
- Omgevingsvariabelen, geen bronbestanden. Lees de sleutel met
os.environofprocess.env. Voor lokaal werk is een.env-bestand dat in.gitignorestaat prima. - Alleen server-side. Roep de API niet aan vanuit browser-JavaScript of een mobiele app, omdat iedereen de sleutel uit de pagina of het app-pakket kan lezen. Plaats een kleine server tussen je front-end en de API.
- Eén plek per sleutel. Houd de sleutel in één geheime opslag en kopieer deze daarvandaan naar elke implementatie, zodat je altijd weet waar hij staat.
- Geen sleutels in chats, tickets of screenshots. Als je om hulp vraagt, deel dan de
X-Request-Iduit het antwoord, niet de sleutel. - Vervang bij verdenking. Als je denkt dat een sleutel is gelekt, stop dan met het gebruik ervan en neem contact op met support om hem te laten vervangen.
Houd ook de X-Balance-USD-header in de gaten. Een balans die daalt terwijl je app inactief is, is het eerste teken dat iemand anders je sleutel gebruikt.
Ga verder dan het gratis proeftegoed: laad tegoed op en betaal
Wanneer het gratis proeftegoed op is, voeg tegoed toe. Elk heel bedrag van $20 tot $500 werkt. Bonussen worden automatisch toegevoegd: 5% vanaf $50, 10% vanaf $100 en 15% vanaf $200. Dus een opwaardering van $100 geeft $110 aan tegoed, en $200 geeft $230. Je kunt alleen betalen met crypto (USDT op TRC20, USDC op Base).
Er is geen abonnement. Je betaalt per token vanuit je balans, en tegoed verloopt nooit, wat geschikt is voor projecten met ongelijkmatig verkeer. De volledige prijslijst staat op de prijspagina. Prompts die via de API worden verzonden, worden niet gebruikt voor training.
Een verstandige eerste opwaardering is $20. Bij het eerder op deze pagina gebruikte verzoek van chatformaat ($0,0003 elk), dekt dat ongeveer 66.000 verzoeken. Controleer je eigen gemiddelde na een paar dagen en pas aan.
Problemen oplossen met een sleutel die niet werkt
De meeste sleutelproblemen hebben eenvoudige oorzaken.
- Authenticatiefout direct. Een teken is verloren gegaan of toegevoegd tijdens het kopiëren. Zoek naar een voorloop- of achterloopspatie, of een regeleinde. Controleer of de header
Authorization: Bearergevolgd wordt door de sleutel. - Werkt in curl, niet in je app. De app leest waarschijnlijk de omgevingsvariabele niet. Print de eerste vier tekens van de waarde die het ziet, niet de hele sleutel.
- Niet gevonden. De basis-URL is verkeerd. Deze moet
https://api.mimoapi.top/v1zijn, op hetapisubdomein. De snelstartgids bevat een lijst per client. - HTTP 429. De code
concurrencybetekent te veel verzoeken tegelijk;rate_limitedbetekent te veel per minuut. Proefsleutels raken hier eerder aan (2 tegelijk, 60 per minuut). Een 429 metRetry-After: 5betekent korte overbelasting; wacht vijf seconden. - Gratis proeftegoed ontbreekt. Het gratis proeftegoed wordt geclaimd met een klik op de sleutelpagina en is één per persoon. Het verloopt na 7 dagen.
Als niets daarvan het oplost, verzamel de X-Request-Id waarde van een mislukte respons en neem contact op met support met deze waarde. Met dit ID kan het probleem worden getraceerd zonder dat je de sleutel verstuurt.
Wat je eerst moet bouwen
Met een werkende sleutel, kies een klein project dat de functies gebruikt die je later nodig zult hebben. Een command-line chatlus leert berichtgeschiedenis. Een script dat een JSON-object retourneert met response_format leert gestructureerde output. Een functie die het model kan aanroepen leert toolgebruik. Elk duurt minder dan een uur en elk draait op het proeftegoed. Als je deze service afweegt tegen andere gehoste modellen, geeft de vergelijking in Mistral API Alternatieven de vragen weer die het waard zijn om te stellen voordat je je verbindt.
Gebruik de dienst binnen de wet en alleen voor volwassenen. Het model is afgestemd op antwoorden zonder inhoudelijke weigeringen, en dat is een functie voor fictie, roleplay en onderzoek, geen toestemming om de regels te breken: seksuele inhoud met minderjarigen is nooit toegestaan.
