MiniMax API: eerste verzoek in vijf minuten

OpenAI SDK installeren

Installeer eerst de officiële OpenAI SDK voor je voorkeurstaal. De bibliotheek verwerkt verzoeken en streaming automatisch. Zorg dat je Python 3.8+ of Node.js 18+ hebt geïnstalleerd. Voer pip install openai uit voor Python of npm install openai voor Node. De SDK vereenvoudigt interactie met het /v1/chat/completions endpoint. Het beheert headers, retries en SSE-parsing zodat jij je kunt concentreren op de prompt. Dit werkt omdat onze API de OpenAI chat-completies standaard volgt. Je hebt geen aangepaste clientbibliotheek nodig. Standaard SDK-methoden komen direct overeen met onze endpoints. Dit vermindert integratietijd en benut bestaande ontwikkelaarskennis.

Basis-URL & sleutel configureren

Stel je API-sleutel en basis-URL in je omgevingsvariabelen in. Onze basis-URL is https://api.minimaxapikey.com/v1. Hiermee kun je standaard OpenAI-clients zonder aanpassingen gebruiken. Maak een account aan om je sleutel te genereren. De sleutel wordt direct na de registratie getoond. Er is geen kaart nodig voor het proeftegoed. Bewaar de sleutel veilig. Geef deze door als een header of omgevingsvariabele. De SDK gebruikt standaard OPENAI_API_KEY. Je kunt de basis-URL overschrijven om naar onze servers te verwijzen. Dit zorgt ervoor dat alle verzoeken naar het ongecensureerde model gaan. Controleer of je sleutel werkt met een eenvoudige ping. Deze stap voorkomt authenticatiefouten later.

Een basis chat-completie sturen

Dien je eerste verzoek in om tekst te genereren. Gebruik de methode POST op /v1/chat/completions. Geef het model op als uncensored. Geef een berichtarray door met een user prompt. De API retourneert een completion token. Dit is de kernfunctie voor tekstgeneratie. Het ondersteunt een contextvenster van 100k. Je kunt lange prompts of gespreksgeschiedenis sturen. Het antwoord bevat de gegenereerde tekst en tokenverbruik. Dit is ideaal voor creatief schrijven of onbeperkte dialogen. Zorg ervoor dat de inhoud wettelijk is. Het model weigert geen volwassen onderwerpen. Het blokkeert alleen seksuele inhoud met minderjarigen. Begin eenvoudig om de verbinding te verifiëren.

Streaming (SSE) inschakelen

Schakel streaming in voor realtime output. Stel de parameter stream in op true. De API retourneert serververzonden gebeurtenissen (SSE). Elke chunk bevat een deel van de respons. Dit vermindert de waargenomen latentie. Gebruikers zien tekst verschijnen terwijl deze wordt gegenereerd. De SDK verwerkt het parseren van chunks automatisch. Je kunt tekst incrementeel weergeven in een UI. Dit is cruciaal voor chatinterfaces. Streaming werkt met alle modelresponsen. Het heeft geen invloed op het tellen van tokens. Elke chunk bevat aan het einde gebruikgegevens. Gebruik dit voor een betere gebruikerservaring. Het voelt responsiever aan dan wachten op de volledige respons. Configureer je client om chunks correct te bufferen.

Tool/function calling gebruiken

Ondersteun gestructureerde outputs met function calling. Definieer tools in het request body. Het model kan functies aanroepen op basis van de prompt. Dit maakt integratie met externe systemen mogelijk. Stuur tool-definities en gebruikersberichten mee. De respons bevat een tool call object. Voer de functie uit en lever de resultaten terug. Dit werkt met standaard OpenAI SDKs. Het stelt je in staat complexe workflows te bouwen. Je kunt agents of assistenten bouwen. Het model behoudt de context over meerdere calls heen. Dit is krachtig voor automatisering. Zorg dat je tool-definities nauwkeurig zijn. De API verwerkt de routing van tool-uitvoer. Het houdt het gesprek coherent. Gebruik dit voor dynamische contentgeneratie.

Beschikbare modellen controleren

Controleer de modellijst via GET /v1/models. Dit endpoint retourneert beschikbare modellen. Onze API biedt één model aan: uncensored. Het is een open-weight model. Het is geen GPT, Claude of Gemini. De respons bevestigt de model-ID. Gebruik dit om clientconfiguraties te debuggen. Zorg dat je code het juiste model target. Het endpoint is snel en betrouwbaar. Het retourneert JSON-gegevens. Je kunt deze parseren voor UI-weergaven. Het bevestigt dat je API-sleutel geldig is. Gebruik dit voor geautomatiseerde health checks. Het maakt deel uit van de standaard OpenAI-specificatie. Er is geen extra configuratie nodig. Dit zorgt voor compatibiliteit met bestaande tools.

cURL

Copycurl https://api.minimaxapikey.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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)