NL ▾

MiniMax API-instelling: sleutel, basis-URL en eerste verzoek

Dit is een stap-voor-stap installatiegids voor de OpenAI-compatibele API op minimaxapikey.com: account, sleutel, basis-URL, eerste verzoek. Het is een onafhankelijke service, niet de officiële API van een modelleverancier.

Bijgewerkt

Zes stralende stappen die van een sleutel naar een serverrek leiden, die het API-insteltraject vertegenwoordigen

Belangrijkste punten

  • Meld je aan met Google of e-mail en claim vervolgens $0,50 aan proeftegoed op de sleutelpagina. Er is geen creditcard nodig.
  • Basis-URL is https://api.minimaxapikey.com/v1, model ID is uncensored, authenticatie is een Bearer-sleutel.
  • Er zijn twee methoden: POST /v1/chat/completions en GET /v1/models.
  • Een 401 betekent een ongeldige sleutel, en een 429 betekent dat een limiet is bereikt, dus controleer de foutcode in de body.

Wat je instelt

Mensen zoeken naar minimax api setup en verwachten een van twee dingen: het officiële MiniMax-ontwikkelaarsplatform, of een kant-en-klaar endpoint in OpenAI-stijl. Deze pagina behandelt het tweede. De service achter minimaxapikey.com is een gehoste, OpenAI-compatibele tekst-API die één open-weight model draait, beheerd door een onafhankelijke provider. Het is niet de officiële API van MiniMax of van een ander modelvendor, en het routeert verzoeken niet over vendors heen. Als je het platform van de vendor zelf nodig hebt, gebruik dan hun site.

Wat je krijgt is simpel. Elke OpenAI SDK of client werkt zodra je de base URL en de sleutel aanpast. Er zijn twee methoden, POST /v1/chat/completions en GET /v1/models, één model ID, uncensored, en een contextvenster van 100.000 tokens dat wordt gedeeld door prompt en completion. Het verwerkt alleen tekst, dus er is geen beeld-, audio- of videogeneratie, geen embeddings en geen fine-tuning. Streaming, function calling en JSON-modus worden ondersteund.

De hele installatie duurt een paar minuten. De onderstaande stappen gaan in volgorde, en elke stap eindigt met een controle zodat je weet dat het werkt voordat je verdergaat.

Stap 1 en 2: account aanmaken en proeftegoed claimen

  1. Open de sleutelpagina. Ga naar de API-sleutelpagina en meld je aan. Je kunt Google gebruiken, of een e-mailadres en wachtwoord.
  2. Claim het proeftegoed. Na het aanmelden heeft de sleutelpagina een knop voor $0,50 aan proeftegoed. Het is één klik, heeft geen creditcard nodig, is 7 dagen geldig en is beperkt tot één per persoon.

Het proeftegoed is bewust klein. Bij $0,15 per 1M input tokens en $0,50 per 1M output tokens, dekt $0,50 een goed aantal testverzoeken. Een prompt van 1.000 tokens met een antwoord van 500 tokens kost $0,00015 voor input plus $0,00025 voor output, wat $0,0004 is. $0,50 delen door dat bedrag geeft 1.250 dergelijke verzoeken, dus je hebt veel ruimte om te experimenteren.

Houd rekening met de limieten van de proefsleutel: 2 gelijktijdige verzoeken en 60 verzoeken per minuut. Een volledige sleutel, die je krijgt zodra je hebt opgewaardeerd, staat 8 gelijktijdige verzoeken en 300 per minuut toe. Als je testlus parallel draait en je ziet 429-fouten, is dit het eerste om te controleren.

Stap 3: de sleutel aanmaken en veilig opslaan

Maak op dezelfde pagina een API-sleutel aan en kopieer deze. Behandel het als een wachtwoord. Zet het in een omgevingsvariabele of een secrets manager, nooit in een repository, een front-end bundle of een screenshot. Als een sleutel lekt, verwijder deze dan en maak een nieuwe aan.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

Server-side code moet de variabele tijdens runtime lezen. Browser-code moet de sleutel helemaal niet vasthouden: verstuur verzoeken vanuit je backend, omdat alles wat naar een browser wordt gestuurd zichtbaar is voor elke bezoeker.

Stap 4: modellen weergeven om de sleutel te bevestigen

De goedkoopste test is de models endpoint. Er wordt geen tekst gegenereerd, dus het is een schone controle van de sleutel, de URL en je netwerk.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

Je zou een JSON-lijst moeten krijgen die uncensored bevat. Als je een 401 krijgt, is de sleutel onjuist of heeft er een vreemde spatie of aanhalingsteken omheen. Als de verbinding mislukt, controleer dan of de URL eindigt op /v1 en of je https hebt gebruikt.

Stap 5: het eerste chatverzoek versturen

Nu een echte completion. De body is de standaard chat-completions structuur.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

Het antwoord bevat choices[0].message.content en een usage blok met aantallen prompt- en completion-tokens. Kijk ook naar de response headers, met curl -i. Je ziet X-Request-Id, die support kan gebruiken om je verzoek te vinden, X-Balance-USD, je resterende tegoed, en de rate limit headers X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency.

Parameters zoals temperature, top_p, stop, seed en de penalties worden doorgegeven. max_tokens is optioneel. Als je het weglaat, kan de completion het resterende deel van het venster gebruiken.

Stap 6: dezelfde aanroep vanuit een SDK

Zodra curl werkt, ga je over op de taal die je daadwerkelijk zult gebruiken. Slechts twee argumenten wijzigen ten opzichte van een standaard OpenAI-instelling.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.minimaxapikey.com/v1",
    api_key=os.environ["UNCENSORED_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.minimaxapikey.com/v1",
  apiKey: process.env.UNCENSORED_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

Voor streaming voeg je stream: true toe en lees je de server-sent events. Gebruikscijfers komen aan het einde van de stream binnen. De docs-pagina behandelt streaming, function calling en JSON-modus met response_format: {"type":"json_object"}.

Een bestaand OpenAI-project verplaatsen

Meestal werkt het project dat je wilt verbinden al met de client-bibliotheek van OpenAI. In dat geval hoef je zelden code aan te passen. De officiële SDKs lezen de omgevingsvariabelen OPENAI_API_KEY en OPENAI_BASE_URL wanneer je geen argumenten doorgeeft, dus een deploymentwijziging kan al genoeg zijn.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

De enige wijziging die overblijft is de modelnaam. Een string zoals een OpenAI model ID bestaat hier niet, dus vervang deze door uncensored, bij voorkeur via een config-waarde zodat je terug kunt schakelen. Lees vervolgens de code door voor functies die de service niet aanbiedt. Beeldgeneratie, audio, embeddings en fine-tuning zijn niet beschikbaar, omdat dit een chat-API die alleen tekst ondersteunt is. Als je app embeddings aanroept voor zoeken, heb je een andere provider nodig voor dat deel en kun je chat op deze houden.

Het helpt ook om te weten welk model het is. Het is één open-weight model, afgestemd om te antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen, en één harde limiet geldt ongeacht de instellingen: geen seksuele inhoud met minderjarigen. Prompts die voor een ander model zijn geschreven, kunnen kleine aanpassingen nodig hebben, omdat elk model anders reageert op dezelfde systeemprompt. Voer je eigen testprompts naast elkaar uit voordat je echt verkeer overschakelt.

Instellingen die je de eerste dag kunt kiezen

Een paar beslissingen zijn makkelijker te nemen bij de setup dan na de lancering. Geen van hen is moeilijk, maar elke keuze voorkomt een verrassing later.

  • Een system prompt. Zet je instructies over toon, formaat en rol in een system bericht. Houd het kort en specifiek, omdat elk verzoek het herhaalt als input tokens.
  • Een tokenlimiet. max_tokens is optioneel, maar een limiet is een goedkope veiligheidsmaatregel. Zonder limiet kan een enkel antwoord het resterende deel van het 100.000-token contextvenster gebruiken.
  • Streaming voor interactief gebruik. Stel stream: true in als iemand wacht op het antwoord. Voor batch jobs zijn gewone verzoeken eenvoudiger.
  • Een retry-regel voor 429. Behandel 429 als een signaal om te wachten, niet als een fout. Als de response Retry-After: 5 bevat, is wachten gedurende die tijd en opnieuw proberen de juiste stap.
  • Verzoekgrootte. De body limiet is 8 MB. Dat is veel meer dan een normale prompt nodig heeft, maar geplakte logs of documenten kunnen dit bereiken.

Prompts worden niet gebruikt voor training, wat belangrijk is als je interne documenten of gebruikersberichten wilt verzenden. Jij bent nog steeds verantwoordelijk voor wat je verzendt, dus vermijd het plaatsen van geheimen die het model niet nodig heeft in een prompt.

Opwaarderen na het proeftegoed

Het proeftegoed is om te controleren of alles werkt. Als je klaar bent om te bouwen, voeg prepaid tegoed toe. Er is geen abonnement: je betaalt voor gebruikte tokens, bij $0,15 per 1M input tokens en $0,50 per 1M output tokens, en tegoed verloopt nooit, dus een ongebruikt saldo verdwijnt niet aan het einde van een maand.

Elk geheel bedrag van $20 tot $500 werkt. Een $50 top-up voegt een 5% bonus toe, $100 voegt 10% toe, en $200 voegt 15% toe. Als snel voorbeeld geeft een $100 top-up met zijn 10% bonus $110 aan tegoed. Bij de 1.000-token prompt en 500-token antwoord uit stap twee kost elk verzoek $0,0004, dus $110 dekt 275.000 verzoeken. Echte prompts zijn meestal langer, dus schaal dat cijfer naar je eigen gemiddelde.

Veelgemaakte installatiefouten oplossen

SymptoomWaarschijnlijke oorzaakOplossing
401 op elke aanroepOntbrekende, verkeerd getypte of ingetrokken sleutelVerstuur Authorization: Bearer <key>, zonder extra aanhalingstekens
404 of HTML-antwoordVerkeerd pad, meestal een ontbrekende /v1Gebruik de volledige basis-URL die eindigt op /v1
Model niet gevondenEen modelnaam gekopieerd van een andere providerGebruik uncensored
429 met rate_limitedOver de limiet voor verzoeken per minuutVertraag, of laad op om van proeflimieten naar volledige limieten te gaan
429 met concurrencyTe veel verzoeken tegelijkBeperk gelijktijdige aanroepen tot 8 (2 op een proefsleutel)
429 met Retry-After: 5Tijdelijke overbelastingWacht 5 seconden en probeer opnieuw
413 of request body afgewezenVerzoek groter dan 8 MBVerkort de prompt of verdeel de taak

Als je klaar bent voor meer dan het proeftegoed, toont de prijzenpagina de top-up opties: elk geheel bedrag van $20 tot $500, betaald met crypto (USDT op TRC20, USDC op Base), met een 5% bonus vanaf $50, 10% vanaf $100 en 15% vanaf $200. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en prompts worden niet gebruikt voor training.

Vragen en antwoorden

Is dit de officiële MiniMax API?

Nee. Het is een onafhankelijke, gehoste, OpenAI-compatibele API die één open-weight model bedient, afgestemd op antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen. Het is niet de officiële API van een modelleverancier en geen router tussen leveranciers.

Heb ik een creditcard nodig om het te proberen?

Nee. Na het registreren kun je $0,50 aan gratis proeftegoed claimen met één klik op de API-sleutelpagina. Het is 7 dagen geldig en is beperkt tot één per persoon.

Wat is de modelnaam die ik moet gebruiken in verzoeken?

Gebruik uncensored. De service exposeert dit enkele model ID, en GET /v1/models zal het tonen.

Hoe voeg ik later meer tegoed toe?

Laad elk geheel bedrag van $20 tot $500 op. Bonussen gelden vanaf $50 (+5%), $100 (+10%) en $200 (+15%), en tegoed verloopt nooit.

Kan ik de OpenAI SDK gebruiken?

Ja. Stel base_url in op https://api.minimaxapikey.com/v1, gebruik je sleutel, en stuur model uncensored. Er hoeft niets anders in je code te veranderen.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen