MiniMax api: Snabbstart och SDK-guide

Autentisering och bas-URL

Använd den tillhandahållna API-nyckeln och peka din klient mot den dedikerade bas-URL:n. Slutpunkten för att generera svar är https://api.minimaxaiapi.com/v1/chat/completions. Du skickar nyckeln i Authorization header som ett bearer-token. Detta fungerar med alla standard OpenAI SDK:er eftersom vi följer samma protokoll.

• Huvudnamn: Authorization
• Huvudvärde: Bearer YOUR_API_KEY
• Bas-URL: https://api.minimaxaiapi.com/v1

Ingen komplex konfiguration behövs. Uppdatera bara konfigurationen i ditt befintliga projekt.

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"}]
  }'

Slutpunkt för chattkomplettering

Skicka en POST-begäran till chat-completions-slutpunkten för att få ett text-svar. Modellspecifikationen är uncensored. Du måste inkludera en messages-array med din konversationshistorik. Systemet bearbetar inmatningen och returnerar genererad text baserat på din prompt.

Denna slutpunkt hanterar all textgenerering. Den stöder inte embeddingar, ljud eller video. Du kan strömma svar eller vänta på hela blocket. Modellen hanterar kontext upp till 100,000 tokens totalt.

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 och Tokenanvändning

Aktivera strömning genom att ställa in stream: true i ditt begäran. API:t returnerar Server-Sent Events (SSE) för varje genererad token. Detta möjliggör realtidsvisning av utdata. Tokenanvändningsstatistik ingår i den sista chunken av strömmen. Detta hjälper dig att spåra kostnader noggrant utan att parsning varje enskild token.

Streaming minskar den upplevda latensen för långa svar. Det är idealiskt för chattgränssnitt och dynamisk innehållsgenerering. Du kan stoppa strömmen i förtid om användaren avbryter genereringen.

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);

Funktionsanrop och JSON-läge

Använd den tools parameter för att aktivera funktionsanrop. Definiera dina funktioner i begärandekroppen och låt modellen välja vilken som ska anropas. The tool_choice parametern låter dig tvinga en specifik funktion eller auto-välj. För strikt JSON-utmatning, ställ in response_format för {"type": "json_object"}. Detta säkerställer att svaret är giltig JSON.

Funktionssamling är användbart för att extrahera strukturerad data eller utlösa åtgärder. JSON-läge är perfekt för API-integrationer som kräver förutsägbara format. Kombinera båda för robust applikationslogik.

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)

Modellparametrar och begränsningar

Justera genereringsbeteende med standardparametrar som temperature, top_p, och stop. Det maximala kontextfönstret är 100,000 tokens inklusive prompt och slutförande. Det maximala utdata per begäran är 16,000 tokens. Om du inte ställer in max_tokens, gränsen är standardinställd till 2 048 tokens.

Använd seed för reproducerbara resultat. Ställ in presence_penalty och frequency_penalty för att styra repetition. Dessa parametrar ger dig finjusterad kontroll över modellens kreativitet och konsekvens. Testa alltid med ditt specifika användningsfall för att hitta rätt balans.

Begränsningar för begäranderänta och fel

API:et begränsar till 300 förfrågningar per minut och 8 samtidiga förfrågningar per nyckel. Om du överskrider dessa gränser får du ett 429-fel. Ett 401-fel indikerar en ogiltig eller saknad API-nyckel. Ett 402-fel betyder att ditt förbetala kredit är slut.

Fel äter inte upp ditt kredit. Du kan försöka misslyckade begäran igen utan straff. Storleken på begärans kropp är begränsad till 8 MB. Hantera din konkurrens noggrant för att undvika throttling. Övervaka din användning via den sista biten av strömmade svar.