MiniMax api: Pika-aloitus ja SDK-opas

Todennus ja base URL

Käytä annettua API-avainta ja osoita asiakasohjelmasi omistettuun perus-URL-osoitteeseen. Päätepiste vastauksien generointiin on https://api.minimaxaiapi.com/v1/chat/completions. Lisää avain kenttään Authorization header Bearer-tokenina. Tämä toimii minkä tahansa standardin OpenAI-SDK:n kanssa, koska noudatamme samaa protokollaa.

• Otsakkeen nimi: Authorization
• Otsakkeen arvo: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Monimutkaista asennusta ei tarvita. Päivitä vain olemassa olevan projektin kokoonpano.

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

Lähetä POST-pyyntö chat completions -päätepisteeseen saadaksesi tekstivastauksen. Mallin tunniste on uncensored. Sinun on sisällytettävä viestit-taulukko, joka sisältää keskusteluhistoriasi. Järjestelmä käsittelee syötteen ja palauttaa generoidun tekstin kysymyksesi perusteella.

Tämä päätepiste käsittelee kaikki tekstintuotantotarpeet. Se ei tue upotuksia, ääntä tai videota. Voit virrata vastauksia tai odottaa koko lohkon valmistumista. Malli käsittelee kontekstin yhteensä 100 000 tokeniin asti.

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)

Streamaus ja token-käyttö

Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. API palauttaa palvelimen lähettämiä tapahtumia (SSE) jokaiselle tuotetulle tokenille. Tämä mahdollistaa tulosteen reaaliaikaisen näyttämisen. Tokenien käyttötilastot sisällytetään streamin viimeiseen palaseen. Tämä auttaa sinua seuraamaan kustannuksia tarkasti ilman jokaista yksittäistä tokenia vaativaa jäsentämistä.

Streamaus vähentää havaittua viivettä pitkissä vastauksissa. Se on ihanteellinen chat-liittymille ja dynaamiselle sisällön generoinnille. Voit lopettaa virran varhain, jos käyttäjä keskeyttää generoinnin.

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

Funktikutsut ja JSON-tila

Käytä tools parametri, joka ottaa käyttöön funktiokutsun. Määrittele funktiosi pyynnön ruumiissa ja anna mallin valita, kumpaa kutsuttavaksi. The tool_choice parametri pakottaa tietyn toiminnon tai automaattisen valinnan. Tiukan JSON-tulosteen kohdalla aseta response_format vastaan {"type": "json_object"}. Tämä varmistaa, että vastaus on kelvollista JSONia.

Toimintojen kutsuminen on hyödyllistä rakenteisen datan erottamiseen tai toimintojen käynnistämiseen. JSON-tila on täydellinen API-integraatioihin, jotka vaativat ennustettavia muotoja. Yhdistä molemmat vahvaan sovelluslogiikkaan.

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)

Malliparametrit ja rajoitukset

Säädä generointikäyttäytymistä standardiparametreilla kuten temperature, top_p, ja stop. Kontesttiluukun maksimikoko on 100 000 tokenia sisältäen promptin ja vastauksen. Maksimituotos pyyntöä kohden on 16 000 tokenia. Jos et aseta max_tokens, raja oletusarvo on 2 048 tokenia.

Käyttö seed toistuvien tulosten saamiseksi. Aseta presence_penalty ja frequency_penalty hallitsemaan toistoa. Nämä parametrit antavat hienojakoisen hallinnan mallin luovuudelle ja johdonmukaisuudelle. Testaa aina käyttötarkoituksesi kanssa löytääksesi oikean tasapainon.

Nopeusrajoitukset ja virheet

API rajoittaa 300 pyyntöä minuutissa ja 8 samanaikaista pyyntöä per avain. Jos ylityt nämä rajat, saat 429-virheen. 401-virhe tarkoittaa virheellistä tai puuttuvaa API-avainta. 402-virhe tarkoittaa, että esimaksukrediittisi on loppu.

Virheet eivät kuluta krediittiasi. Voit toistaa epäonnistuneita pyyntöjä ilman seuraamuksia. Pyynnön rungon koko on rajoitettu 8 MB:aan. Hallitse samanaikaisuutta huolellisesti välttääksesi ruuhkautumisen. Seuraa käyttöäsi streamausvastauksen viimeisen osan kautta.