MiniMax API: gyors kezdés és SDK útmutató

Hitelesítés és Base URL

Használja a megadott API-kulcsot, és irányítsa a kliensét a dedikált alap URL-címre. Az endpoint a válaszok generálásához https://api.minimaxaiapi.com/v1/chat/completionsA kulcsot a Authorization fejlec Bearer tokenként. Ez bármely szabványos OpenAI SDK-val működik, mert ugyanazt a protokollt követjük.

• Fejléc neve: Authorization
• Fejléc értéke: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Nem szükséges bonyolult beállítás. Csak frissítsd a konfigurációt a meglévő projektedben.

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 végpont

Küldjön egy POST kérést a chat completions végpontra a szöveges válasz érdekében. A modell azonosítója uncensoredMeg kell adnod egy üzenetek tömböt a beszélgetési előzményeiddel együtt. A rendszer feldolgozza a bemenetet, és a promptod alapján generált szöveget ad vissza.

Ez a végpont az összes szöveggenerálást kezeli. Nem támogat embeddéseket, hangot vagy videót. Streamelheti a válaszokat vagy várhat a teljes blokkra. A modell 100,000 token teljes kontextust kezel.

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 és Token Használat

Engedélyezze a streamelést úgy, hogy stream: true a kérésben. Az API minden generált tokenhez Szerver által küldött eseményeket (SSE) ad vissza. Ez lehetővé teszi a kimenet valós idejű megjelenítését. A token-felhasználási statisztikák az utolsó darabban találhatók a streamben. Ez segít a költségek pontos nyomon követésében anélkül, hogy minden egyes tokent fel kellene dolgozni.

A streamelés csökkenti az észlelt késleltetést hosszú válaszok esetén. Ideális chat felületekhez és dinamikus tartalomgeneráláshoz. Korábban megszakíthatja a streamet, ha a felhasználó megszakítja a generálást.

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

Függvényhívás és JSON mód

Használja a tools paraméter a funkcióhívás engedélyezésére. Határozza meg funkcióit a kérelem törzsében, és hagyja, hogy a modell kiválassza, melyiket hívja meg. A tool_choice paraméter lehetővé teszi egy adott funkció kényszerítését vagy automatikus kiválasztását. Szigorú JSON kimenet érdekében állítsd be response_format a {"type": "json_object"}. Ez biztosítja, hogy a válasz érvényes JSON legyen.

A function calling hasznos strukturált adatok kinyeréséhez vagy műveletek indításához. A JSON mód tökéletes API-integrációkhoz, amelyek kiszámítható formátumot igényelnek. Kombinálja mindkettőt a robusztus alkalmazáslogikához.

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)

Modell paraméterek és korlátok

Állítsd be a generálási viselkedést a standard paraméterekkel: temperature, top_p, és stop. A maximális kontextus ablak 100,000 token, beleértve a promptot és a kiegészítést. A kérésenkénti maximális kimenet 16,000 token. Ha nem állítja be max_tokens, a korlát alapértelmezett 2 048 token.

Használat seed a reprodukálható eredményekhez. Állítsa be presence_penalty és frequency_penalty a ismétlődés vezérléséhez. Ezek a paraméterek finomhangolt kontrollt biztosítanak a modell kreativitása és konzisztenciája felett. Mindig tesztelje az adott felhasználási esettel, hogy megtalálja a megfelelő egyensúlyt.

Sebességkorlátok és hibák

Az API percenként 300 kérésre és 8 párhuzamos kérésre szabja a limitet kulcsonként. Ha túllépi ezeket a limiteket, 429-es hibát kap. A 401-es hiba érvénytelen vagy hiányzó API-kulcsot jelez. A 402-es hiba azt jelenti, hogy az előre fizetett hitel elfogyott.

A hibák nem merítik a hitelkeretedet. Büntetés nélkül ismétlheted a sikertelen kéréseket. A kérés törzse 8 MB méretre van korlátozva. Kezeld óvatosan a párhuzamosságot a throttling elkerülése érdekében. Kövesd nyomon a felhasználást a streamelt válaszok utolsó darabján keresztül.