MiniMax api: Quickstart og SDK-guide

Autentificering og Base URL

Brug den angivne API-nøgle og ret din klient til dedikeret base URL. Endpointet til generering af svar er https://api.minimaxaiapi.com/v1/chat/completions. Du sender nøglen i Authorization header som en bearer-token. Dette fungerer med ethvert standard OpenAI SDK, fordi vi følger den samme protokol.

• Header-navn: Authorization
• Headerværdi: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Ingen kompleks opsætning er påkrævet. Opdater blot konfigurationen i dit eksisterende 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"}]
  }'

Chat Completions Endpoint

Send en POST-anmodning til chat-completions-endepunktet for at få en tekstrespons. Modelidentifikatoren er uncensored. Du skal inkludere et messages-array med din samtalehistorik. Systemet behandler inputtet og returnerer genereret tekst baseret på din prompt.

Dette endpoint håndterer al tekstgenerering. Det understøtter ikke embeddings, lyd eller video. Du kan streame svar eller vente på den fulde blok. Modellen håndterer kontekst op til 100,000 tokens i alt.

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 og Token-forbrug

Aktivér streaming ved at indstille stream: true i din anmodning. API'et returnerer Server-Send Events (SSE) for hvert genereret token. Dette giver mulighed for realtidsvisning af outputtet. Tokenforbrugsstatistikker er inkluderet i den sidste chunk af streamen. Dette hjælper dig med at spore omkostninger præcist uden at analysere hvert enkelt token.

Streaming reducerer opfattet latens til lange svar. Det er ideelt til chatgrænseflader og dynamisk indholdsgenerering. Du kan stoppe streamen tidligt, hvis brugeren afbryder 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);

Function Calling og JSON-tilstand

Brug den tools parameter til at aktivere funktion-kald. Definér dine funktioner i request-kroppen og lad modellen vælge, hvilken der skal kaldes. The tool_choice parameter giver dig mulighed for at tvinge en bestemt funktion eller auto-vælge. For strengt JSON-output, indstil response_format til {"type": "json_object"}. Dette sikrer, at svaret er gyldig JSON.

Funktionskald er nyttigt til at udtrække strukturerede data eller udløse handlinger. JSON-tilstand er perfekt til API-integrationer, der kræver forudsigelige formater. Kombiner begge for 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)

Modelparametre og begrænsninger

Juster genereringsadfærd ved hjælp af standardparametre som temperature, top_p, og stop. Det maksimale kontekstvindu er på 100,000 tokens inklusive prompt og completion. Det maksimale output pr. anmodning er 16,000 tokens. Hvis du ikke indstiller max_tokens, grænsen default til 2.048 tokens.

Brug seed for reproducerbare resultater. Indstil presence_penalty og frequency_penalty til at kontrollere gentagelse. Disse parametre giver dig finjusteret kontrol over modellens kreativitet og konsistens. Test altid med dit specifikke brugstilfælde for at finde den rigtige balance.

Rate Limits og Fejl

API'en håndhæver en grænse på 300 anmodninger i minuttet og 8 samtidige anmodninger per nøgle. Hvis du overskrider disse grænser, modtager du en 429-fejl. En 401-fejl indikerer et ugyldigt eller manglende API-nøgle. En 402-fejl betyder, at din forudbetalte kredit er opbrugt.

Fejl forbruger ikke din kredit. Du kan gentage fejlede requests uden straf. Request-body-størrelsen er begrænset til 8 MB. Håndter din konkurrencefladning forsigtigt for at undgå throttling. Overvåg din brug gennem det sidste chunk af streaming-svar.