MiniMax api: Quickstart en SDK Gids

Authenticatie en basis-URL

Gebruik de verstrekte API-sleutel en wijs je client naar de toegewijde basis-URL. Het eindpunt voor het genereren van antwoorden is https://api.minimaxaiapi.com/v1/chat/completions. Je voert de sleutel in de Authorization header als Bearer-token. Dit werkt met elke standaard OpenAI SDK omdat we hetzelfde protocol volgen.

• Headernaam: Authorization
• Headerwaarde: Bearer YOUR_API_KEY
• Basis-URL: https://api.minimaxaiapi.com/v1

Geen complexe setup nodig. Werk de configuratie in je bestaande project gewoon bij.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Chat Completions Endpoint

Stuur een POST-verzoek naar het chat-completies-eindpunt om een tekstantwoord te krijgen. De modelidentificatie is uncensored. Je moet een messages-array opnemen met je gespreksgeschiedenis. Het systeem verwerkt de input en retourneert gegenereerde tekst op basis van je prompt.

Dit endpoint behandelt alle tekstgeneratie. Het ondersteunt geen embeddings, audio of video. Je kunt antwoorden streamen of wachten op de volledige blok. Het model verwerkt context tot 100.000 tokens in totaal.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.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 en Token-gebruik

Activeer streaming door stream: true in je verzoek. De API retourneert Server-Sent Events (SSE) voor elke gegenereerde token. Dit stelt realtime weergave van de uitvoer mogelijk. Tokenverbruiksstatistieken zijn opgenomen in het laatste chunk van de stream. Dit helpt je om kosten nauwkeurig te volgen zonder elke individuele token te parseren.

Streaming vermindert de waargenomen latentie voor lange antwoorden. Het is ideaal voor chatinterfaces en dynamische contentgeneratie. Je kunt de stream vroegtijdig stoppen als de gebruiker de generatie onderbreekt.

Copyimport OpenAI from "openai";

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

Function Calling en JSON-modus

Gebruik de tools parameter om functievermogen in te schakelen. Definieer je functies in het request body en laat het model kiezen welke het moet aanroepen. De tool_choice parameter laat je een specifieke functie forceren of automatisch selecteren. Voor strikte JSON-uitvoer stel je response_format naar {"type": "json_object"}. Dit zorgt ervoor dat het antwoord geldige JSON is.

Function calling is nuttig voor het extraheren van gestructureerde data of het triggeren van acties. JSON-modus is perfect voor API-integraties die voorspelbare formaten vereisen. Combineer beide voor robuuste applicatielogica.

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)

Modelparameters en beperkingen

Pas het generatiegedrag aan met standaardparameters zoals temperature, top_p, en stop. Het maximale contextvenster is 100.000 tokens, inclusief de prompt en de completion. De maximale uitvoer per verzoek is 16.000 tokens. Als je niet instelt max_tokens, de limiet is standaard 2.048 tokens.

Gebruik seed voor reproduceerbare resultaten. Stel presence_penalty en frequency_penalty om herhaling te bepalen. Deze parameters geven je fijne controle over de creativiteit en consistentie van het model. Test altijd met je specifieke use case om de juiste balans te vinden.

Rate Limits en fouten

De API handhaaft een limiet van 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel. Als u deze limieten overschrijdt, ontvangt u een 429-fout. Een 401-fout geeft een ongeldige of ontbrekende API-sleutel aan. Een 402-fout betekent dat uw voorgeladen tegoed op is.

Fouten verbruiken niet uw tegoed. U kunt mislukte verzoeken zonder boete opnieuw proberen. De grootte van de request body is beperkt tot 8 MB. Beheer uw concurrency zorgvuldig om throttling te voorkomen. Monitor uw gebruik via het laatste chunk van streaming-antwoorden.