Arendaja platvorm

MiniMax Open Platform API

MiniMax ülevaade arendajatele, mis hõlmab API-juurdepääsu, hinnastust, SDK-tuge, lõppunkte, võimekusi ja platvormi reegleid.

Dokumentatsioon API juhend

API võti Nõutud

Peamine API MiniMaxi API-platvorm Anthropicuga ja OpenAI-ga ühilduvate keele-API-dega

SDK tugi Ametlik dokumentatsioon toetab Anthropic SDK-d soovitatava keeleintegratsioonina ning OpenAI SDK-d Pythonis ja Node.js-is. PHP ja teiste keelte jaoks on saadaval otse HTTP-päringud. Ametlikud MiniMaxi MCP-rakendused on saadaval Pythonis ja JavaSc

Päringupiirangud Avaldatud piirangud erinevad API ja mudeli järgi. MiniMax-M3: 200 RPM ja 10 000 000 TPM. MiniMax-M2.7, M2.7-highspeed, M2.5, M2.5-highspeed, M2.1, M2.1-highspeed ja M2: üldjuhul 500 RPM ja 20 000 000 TPM. H3-videogeneratsioon: 300 RPM ja maksimaalselt 30

Platvorm

API ülevaade

Lõppunktid (endpoints)

API ligipääs

Juuraadress (Base URL)


					https://api.minimax.io

Peamine API MiniMaxi API-platvorm Anthropicuga ja OpenAI-ga ühilduvate keele-API-dega

Hinnad

API Hinnad

Hinnakujundusmudel Kasutuspõhine tasumine tokeni-, tähemärgi-, pildi-, heli-, videosekundi-, päringu- ja ülesandepõhise hinnastamise alusel; saadaval on ka eraldi Token Plani ja krediidi valikud.

MiniMax-M3 standardhinnaks on märgitud 0,30 dollarit miljoni sisendtokeni ja 1,20 dollarit miljoni väljundtokeni kohta päringute puhul, mille sisend sisaldab kuni 512 000 tokenit; suurema kontekstiga päringute ja prioriteetse töötlemise hind on kõrgem. Muude modaalsuste puhul kehtivad eraldi ühikuhinnad.

Arendaja töömugavus

SDK info

SDK Ametlik dokumentatsioon toetab Anthropic SDK-d soovitatava keeleintegratsioonina ning OpenAI SDK-d Pythonis ja Node.js-is. PHP ja teiste keelte jaoks on saadaval otse HTTP-päringud. Ametlikud MiniMaxi MCP-rakendused on saadaval Pythonis ja JavaSc

Kasutusmugavus Hea. Saadaval on standardsed HTTP API-d ning keelemudelitele pääseb ligi ametliku OpenAI SDK või soovitatud Anthropic SDK kaudu. Meedia API-d põhinevad otse HTTP-l, multipart-päringutel, asünkroonsetel ülesannetel või WebSocketi mustritel.

Dokumentatsioon Hea ja põhjalik dokumentatsioon, mis hõlmab ajakohast API-de ülevaadet ning mudelite, hinnastamise, päringumäärade piirangute, SDK-de, failide, meedia ja serveripoolsete tööriistade dokumentatsiooni. Mõned võimalused on kirjeldatud eraldi lõpp-punktide le

Viivitus Avaldatud ligikaudsed väljundkiirused hõlmavad MiniMax-M3 puhul enam kui 100 tokenit sekundis, M2.7 ja M2.5 puhul umbes 60 tokenit sekundis ning suure kiirusega variantide puhul umbes 100 tokenit sekundis. Tegelik latentsus varieerub olenevalt töökoormuse

Allikad

Viited arendajale

Dokumentatsioon ↗ API juhend ↗ Liivakast ↗

Featuurid

API võimekused

✓ Voogedastus

✓ Funktsioonide kasutamine

✓ Failide üleslaadimine

✓ Veebiotsing

✓ Pildi sisend

✓ Liivakast

Lühikirjeldus

Platvorm pakub API-sid keele-, kõne-, video-, pildi-, muusika-, failihalduse ja serveripõhiste tööriistade jaoks. MiniMax-M3 on API dokumentatsioonis loetletud praegune lipulaev-keelemudel, mis toetab ühe miljoni märgi suurust kogukonteksti akent, teksti-, pildi- ja videosisendit, voogedastust, tööriistade kutsumist ning arutlusvõime juhtimise seadeid. Keelemudeliga integreerimiseks soovitatakse Anthropicuga ühilduvat API-t, lisaks toetatakse OpenAI-ga ühilduvaid Chat Completionsi päringuid. Serveripoolne veebotsing (web_search) on saadaval Anthropic Messages API ja OpenAI Responses API kaudu. Faile saab üles laadida video mõistmiseks, video genereerimiseks, hääle kloonimiseks, helisisendi loomiseks viipade abil ning asünkroonseks pika teksti kõneks sünteesimiseks. Kõne puhul toetatakse HTTP- ja WebSocketi-põhist voogedastust. Video genereerimine on asünkroonne ning kasutab ülesannete loomise ja oleku päringu töövooge. Muusika-API-dele kehtivad uutele kasutajatele alates 20. augustist 2026 piirangud. Avalik dokumentatsioon ei kinnita eraldi püsiva majutusega Assistantsi API olemasolu, mis kasutaks assistendi, lõime ja käituse objekte. Peenhäälestust ei ole praeguse avaliku API võimalusena üheselt dokumenteeritud.

Näited

API Näited

curl --fail-with-body --silent --show-error https://api.minimax.io/v1/chat/completions \
  -H "Authorization: Bearer ${MINIMAX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain how streaming responses work."}
    ],
    "thinking": {"type": "disabled"},
    "max_completion_tokens": 512
  }' | jq -r '.choices[0].message.content'

curl --fail-with-body --silent --show-error https://api.minimax.io/v1/chat/completions \
  -H "Authorization: Bearer ${MINIMAX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3",
    "messages": [
      {"role": "user", "content": "What is the weather in Boston?"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get current weather for a city",
          "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }' | jq '.choices[0].message'

# Install: pip install openai
import json
import os
from openai import OpenAI

api_key = os.environ["MINIMAX_API_KEY"]
client = OpenAI(
    api_key=api_key,
    base_url="https://api.minimax.io/v1",
)

try:
    response = client.chat.completions.create(
        model="MiniMax-M3",
        messages=[
            {"role": "system", "content": "You are a helpful technical assistant."},
            {"role": "user", "content": "Give me three practical uses for a multimodal API."},
        ],
        extra_body={"thinking": {"type": "disabled"}},
        max_completion_tokens=512,
    )
    print(response.choices[0].message.content)
except Exception as exc:
    print(f"MiniMax API request failed: {exc}")

stream = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[
        {"role": "system", "content": "Answer clearly and briefly."},
        {"role": "user", "content": "Explain function calling in one paragraph."},
    ],
    stream=True,
    extra_body={"thinking": {"type": "disabled"}},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

def get_weather(city: str) -> dict:
    return {"city": city, "temperature_c": 18, "condition": "partly cloudy"}

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"]
        }
    }
}]

messages = [{"role": "user", "content": "What is the weather in Boston?"}]
first = client.chat.completions.create(
    model="MiniMax-M3",
    messages=messages,
    tools=tools,
    tool_choice="auto",
    extra_body={"thinking": {"type": "disabled"}},
)
assistant_message = first.choices[0].message
messages.append(assistant_message.model_dump(exclude_none=True))
if assistant_message.tool_calls:
    for call in assistant_message.tool_calls:
        arguments = json.loads(call.function.arguments)
        result = get_weather(arguments["city"])
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result),
        })
    final = client.chat.completions.create(
        model="MiniMax-M3",
        messages=messages,
        extra_body={"thinking": {"type": "disabled"}},
    )
    print(final.choices[0].message.content)
else:
    print(assistant_message.content)

// Install: npm install openai
import OpenAI from "openai";

const apiKey = process.env.MINIMAX_API_KEY;
if (!apiKey) throw new Error("MINIMAX_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.minimax.io/v1"
});

try {
  const response = await client.chat.completions.create({
    model: "MiniMax-M3",
    messages: [
      { role: "system", content: "You are a helpful assistant." },
      { role: "user", content: "Summarize the benefits of streaming APIs." }
    ],
    max_completion_tokens: 512,
    extra_body: { thinking: { type: "disabled" } }
  });
  console.log(response.choices[0].message.content);

  const stream = await client.chat.completions.create({
    model: "MiniMax-M3",
    messages: [
      { role: "user", content: "Explain multimodal input in two sentences." }
    ],
    stream: true,
    extra_body: { thinking: { type: "disabled" } }
  });
  for await (const chunk of stream) {
    const text = chunk.choices?.[0]?.delta?.content;
    if (text) process.stdout.write(text);
  }
  process.stdout.write("\n");
} catch (error) {
  console.error("MiniMax API request failed:", error instanceof Error ? error.message : error);
  process.exitCode = 1;
}

<?php
$apiKey = getenv('MINIMAX_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('MINIMAX_API_KEY is required');
}

$url = 'https://api.minimax.io/v1/chat/completions';
$payload = [
    'model' => 'MiniMax-M3',
    'messages' => [
        ['role' => 'system', 'content' => 'You are a helpful technical assistant.'],
        ['role' => 'user', 'content' => 'Explain how an API key should be stored securely.']
    ],
    'max_completion_tokens' => 512,
    'thinking' => ['type' => 'disabled']
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_TIMEOUT => 60,
]);

$body = curl_exec($ch);
if ($body === false) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException('cURL error: ' . $error);
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($status < 200 || $status >= 300) {
    $message = $data['base_resp']['status_msg'] ?? $body;
    throw new RuntimeException('MiniMax API error (' . $status . '): ' . $message);
}

$result = $data['choices'][0]['message']['content'] ?? null;
if ($result === null) {
    throw new RuntimeException('The response did not contain message content.');
}

echo $result . PHP_EOL;
?>

Põhimõtted

Andmete kasutus

MiniMaxi praeguses API privaatsuspoliitikas on sätestatud, et MiniMax ei kasuta sisendina edastatud isikuandmeid inimese omaduste tuletamiseks ega tarbijate profileerimiseks või sihtimiseks isikuandmete abil mudelite treenimisel. Poliitika ei sisalda lihtsat üldist kinnitust, et kõik API kaudu esitatud viibad ja väljundid on välistatud kõigist mudelite treenimise protsessidest. Arendajad peaksid tutvuma kehtiva poliitikaga ning hankima konfidentsiaalsete, reguleeritud või tundlike töökoormuste jaoks asjakohased lepingulised tagatised.

Andmete säilitamine

Säilitamisperiood sõltub andmetüübist ja töövoost. Privaatsuspoliitika kohaselt võidakse isikuandmeid säilitada nii kaua, kui see on vajalik või seadusega lubatud või kui see on vajalik nende kogumise eesmärgi täitmiseks. Seejärel need kustutatakse või vajaduse korral anonümiseeritakse. Kõneliideseid kirjeldatakse olekuvabadena ning need ei salvesta kasutajaandmeid. Üles laaditud videomõistmise failid säilitatakse kuni 7 päeva ja video genereerimise sisendfailid kehtivad 7 päeva. Ajutised hääle kloonimise ja hääle kujundamise hääled kustutatakse, kui neid 168 tunni jooksul ei kasutata.

Päringupiirangud

Avaldatud piirangud erinevad API ja mudeli järgi. MiniMax-M3: 200 RPM ja 10 000 000 TPM. MiniMax-M2.7, M2.7-highspeed, M2.5, M2.5-highspeed, M2.1, M2.1-highspeed ja M2: üldjuhul 500 RPM ja 20 000 000 TPM. H3-videogeneratsioon: 300 RPM ja maksimaalselt 30

Arendaja juhend

MiniMaxi API: algaja juhend mudelite, hinnastuse ja integreerimise kohta

MiniMax Open Platform on kasutuspõhine arendaja-API keele-, kõne-, pildi-, video- ja muusikarakenduste ning failihalduse ja veebist otsimise töövoogude jaoks. Arendajad saavad kasutada soovitatud Anthropicuga ühilduvat liidest või OpenAI-ga ühilduvat API-t, autentida Bearer API-võtmete abil, voogedastada vastuseid, kutsuda tööriistu, laadida üles faile ning koostada asünkroonseid meedialoome töövooge. MiniMax-M3 on praegu platvormil loetletud juhtiv keelemudel, samal ajal kui natiivsed lõpp-punktid võimaldavad selliseid funktsioone nagu kõnesüntees ja video genereerimine.

MiniMax Open Platform annab arendajatele API kaudu juurdepääsu teksti genereerimisele, arutlusvõimele, koodi kirjutamisele, multimodaalsele sisendile, kõnele, piltidele, videole, failihaldusele ja serveripoolsele veebiotsingule. Uus integratsioon algab tavaliselt Open Platformi konto ja API-võtme loomisest ning seejärel kas soovitatud Anthropicuga ühilduva keeleliidese või OpenAI-ga ühilduva Chat Completions API kasutuselevõtust. Selles juhendis selgitatakse MiniMaxi rakendusse integreerimise praktilist seadistamist, hinnastamismudelit, võimalusi, näiteid, piiranguid ja kompromisse.

MiniMax Open Platform pakub kasutuspõhise hinnastusega API-sid keele-, kodeerimis-, arutlus-, kõne-, pildi-, video- ja failitöötluseks ning veebiotsinguks. Arendajad saavad kasutada Anthropicuga või OpenAI-ga ühilduvaid keeleliideseid, autentida end Beareri võtmetega, voogedastada vastuseid, kutsuda tööriistu, laadida üles faile ja hallata asünkroonseid meediatöötlusülesandeid. Juhend käsitleb seadistamist, M3 ja teisi mudeleid, hinnastamisühikuid, SDK-sid, piiranguid, privaatsusega seotud kaalutlusi ning tootmiskeskkonna kompromisse.

Mis on MiniMax API?

MiniMax Open Platform on arendajatele mõeldud teenus generatiivse tehisintellekti funktsioonide lisamiseks rakendustesse. Selle API-d hõlmavad keelemudeleid, kõnesünteesi, piltide genereerimist, videote genereerimist, muusikaga seotud teenuseid, failihaldust ning serveripoolseid tööriistu, näiteks veebiotsingut. See on eraldiseisev MiniMaxi tarbijarakendustest ja mõeldud arendajatele, kes vajavad programmilist juurdepääsu, kasutuspõhist arveldamist ning rakenduse juhitud töövooge.

Keelerakenduste puhul soovitab MiniMax praegu Anthropiciga ühilduvat API-t. Saadaval on ka OpenAI-ga ühilduv API, mis võib vähendada migratsioonitööd rakendustes, mis on juba OpenAI SDK abil loodud. Meedia- ja failitöövoogude jaoks kasutatakse natiivseid HTTP-, multipart-üleslaadimise, asünkroonsete ülesannete ja WebSocketi liideseid.

Platvorm sobib vestlusrakendustele, kodeerimisabilistele, agentide töövoogudele, dokumentide ja videote analüüsiks, kõneliidestele, sisu genereerimise tööriistadele ning rakendustele, mis kombineerivad teksti koos pildi- või videosisendiga. See sobib halvemini juhul, kui rakendus vajab ühtset toodetervikuna toimivat kasutuskogemust, tagatud piiranguteta tasuta kasutust või selgelt dokumenteeritud majutatud assistentide süsteemi, millel on püsivad assistendi-, lõime- ja käitamisobjektid.

Juurdepääsu saamine ja API võtme loomine

Alustamiseks registreeruge MiniMax API platvormil või logige sisse. Looge arendajakonsoolis API võti ning lisage enne tasuliste päringute saatmist kontole saldo või muu sobiv ressurss. Open Platformi standardsed API võtmed on Token Plani tellimuse võtmetest eraldi, seega ei tohiks eeldada, et tellimuse võti töötab kõigi kasutuspõhise arveldamisega lõpp-punktidega.

Saatke võti kandertokenina Authorization päises. Hoidke seda keskkonnamuutujas või serveripoolses saladuste halduris. Ärge paigutage võtit brauseri JavaScripti, mobiilirakenduse pakettidesse, avalikesse koodirepositooriumidesse ega kliendipoolsesse HTML-i, sest kasutajad võivad selle sealt välja võtta ja väärkasutada.

export MINIMAX_API_KEY="your-api-key"

curl --fail-with-body --silent --show-error 
  https://api.minimax.io/v1/chat/completions 
  -H "Authorization: Bearer ${MINIMAX_API_KEY}" 
  -H "Content-Type: application/json"

Rahvusvahelise API baas-URL on https://api.minimax.io. Enne juurutamist tuleb kontrollida piirkondlikke lõpp-punkte ja kontonõudeid, sest mudelite saadavus, maksevõimalused ja juurdepääsureeglid võivad piirkonniti erineda.

Liidese ja mudeli valimine

Uue keeleintegratsiooni puhul on soovitatav alustada Anthropiciga ühilduvast API-st. OpenAI-ga ühilduv liides on praktiline alternatiiv olemasolevatele OpenAI SDK rakendustele ja kasutab https://api.minimax.io/v1 baas-URL-i. Anthropiciga ühilduv lõpp-punkt kasutab aadressi https://api.minimax.io/anthropic.

MiniMax-M3 on platvormi dokumentatsioonis loetletud praeguse lipulaeva keelemudelina. See on mõeldud pika konteksti töötlemiseks, arutlemiseks, kodeerimiseks, agentide töövoogudeks, tööriistade kasutamiseks ning multimodaalseks sisendiks. Platvorm loetleb ka mudelid MiniMax-M2.7, MiniMax-M2.7-highspeed, MiniMax-M2.5, MiniMax-M2.5-highspeed, MiniMax-M2.1, MiniMax-M2.1-highspeed ja MiniMax-M2.

Valige M3, kui rakendus vajab praeguse lipulaeva keelevõimekust, pikka konteksti või teksti-, pildi- ja videosisendit. Võrrelge M2.x-i ja kiire versiooni variante juhul, kui läbilaskevõime, hind või vastuse kiirus on uuema mudeli kasutamisest olulisemad. Mudelite nimed, piirangud ja saadavus võivad muutuda, seega peaksid tootmissüsteemid kontrollima ajakohast dokumentatsiooni, mitte eeldama mudelite toe püsimist.

Esimese päringu tegemine keelemudelile

OpenAI-ga ühilduv API võtab vastu tavalisi vestlussõnumeid. Järgmises näites kasutatakse OpenAI Pythoni SDK praegust versiooni koos MiniMaxi ühilduva baas-URL-iga.

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MINIMAX_API_KEY"],
    base_url="https://api.minimax.io/v1",
)

response = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain API streaming in three sentences."},
    ],
    extra_body={"thinking": {"type": "disabled"}},
    max_completion_tokens=512,
)

print(response.choices[0].message.content)

Päringus määratakse mudel ja sõnumite jada. Vastus sisaldab valikute loendit; tavalise ühe vastusega päringu puhul on genereeritud tekst saadaval aadressil response.choices[0].message.content. Siin näidatud säte thinking järgib esitatud MiniMaxi OpenAI-ga ühilduva API näidet ja lülitab lühikese vastuse jaoks laiendatud mõtlemise välja.

Kuidas MiniMax API hinnastamine toimib

Standardne API juurdepääs kasutab kasutuspõhist arveldamist. Keelemudelite eest võetakse üldjuhul tasu iga miljoni sisend- ja väljundtokeni kohta ning vajaduse korral arvestatakse viiba vahemälu kasutamist eraldi. Teised teenused kasutavad oma ühikuid, sealhulgas kõne puhul tähemärke või helitunde, video puhul väljundi sekundeid, piltide genereerimisel pilte ning mõne platvormifunktsiooni puhul päringuid või ülesandeid.

Dokumenteeritud MiniMax-M3 standardhind on kuni 512 000 sisendtokeniga päringute puhul 0,30 dollarit miljoni sisendtokeni ja 1,20 dollarit miljoni väljundtokeni kohta. Sellest sisendisuurusest suuremate päringute hind on 0,60 dollarit miljoni sisendtokeni ja 2,40 dollarit miljoni väljundtokeni kohta. Viiba vahemälu lugemise eest võetakse tasu eraldi.

Toetatud keelepäringute jaoks on saadaval prioriteetne teenusetase, mille hind on 1,5 korda kõrgem kui standardhind. Selle eesmärk on parandada päringute vastuvõtmise prioriteeti, vastuse kiirust ja töökindlust; see ei muuda rakenduse aluseks olevaid arhitektuurinõudeid.

Jälgige kasutust ühikute kaupa, selle asemel et käsitleda kõiki päringuid võrdsetena. Keelepäring võib kulutada sisend- ja väljundtokeneid, samas kui kõne-, pildi- või videotöövoog võib kaasa tuua tasusid tähemärkide, piltide, helitundide, väljundsekundite, päringute või ülesannete eest.

Voogedastus, tööriistad ja multimodaalne sisend

Vastuste voogedastus

Voogedastus saadab genereeritud väljundi järk-järgult, selle asemel et oodata kogu vastuse valmimist. See on vestlusliideste puhul kasulik, sest rakendus saab teksti kuvada kohe selle saabumisel. OpenAI-ga ühilduv API kasutab standardset parameetrit stream.

stream = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[
        {"role": "user", "content": "Explain function calling briefly."}
    ],
    stream=True,
    extra_body={"thinking": {"type": "disabled"}},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Kõnesüntees toetab samuti HTTP- ja WebSocketi-põhist voogedastust, mis võimaldab heli järk-järgult genereerida ja vastu võtta.

Funktsioonide ja tööriistade kutsumine

MiniMax-M3 toetab OpenAI-ga ühilduva liidese kaudu funktsioonitööriistu. Tööriista määratlus kirjeldab funktsiooni, mille eest teie rakendus vastutab, näiteks ilmateate päringut või andmebaasiotsingut. Mudel võib funktsiooni kutsumist taotleda, kuid teie server peab argumendid valideerima, funktsiooni käivitama ja tulemuse tagasi saatma.

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="MiniMax-M3",
    messages=[{"role": "user", "content": "What is the weather in Boston?"}],
    tools=tools,
    tool_choice="auto",
    extra_body={"thinking": {"type": "disabled"}},
)

print(response.choices[0].message)

Mitme vooruga tööriistatöövoos säilitage kogu assistendi sõnum, sealhulgas tööriistakutse teave ja kõik nõutud arutluse väljad, enne kui lisate tööriistade tulemused. Selle teabe puudumine võib katkestada mudeli tööriistakutsete järjepidevuse.

Pildi-, video- ja failisisend

MiniMax-M3 toetab OpenAI-ga ühilduva sõnumivormingu kaudu teksti-, pildi- ja videosisendit. Pilte saab edastada URL-i või base64-andmetena. Suuremaid videoid saab üles laadida Files API kaudu ja neile viidata mm_file:// identifikaatori abil.

Failihalduse API toetab failide üleslaadimist, loetlemist, hankimist, lugemist ja kustutamist. Sõltuvalt lõpp-punktist saab faile kasutada video mõistmiseks, video genereerimise sisendina, hääle kloonimiseks, viiba helina ning pika teksti asünkroonseks kõnesünteesiks. Ajutistel failidel on kehtivuspiirangud: video mõistmise ja video genereerimise sisendfailid kehtivad dokumentatsiooni kohaselt kuni seitse päeva, seega peaksid rakendused olema valmis neid uuesti üles laadima.

Meedia genereerimine ja serveripoolsed töövood

Meedia API-d ei järgi alati sama päringu ja vastuse mustrit nagu vestlus. Video genereerimine on asünkroonne: looge ülesanne, säilitage selle ülesande identifikaator, kontrollige selle olekut ja hankige pärast lõpetamist väljundi URL. Pika teksti kõnesüntees pakub asünkroonset töövoogu ka päringutele, mis ületavad sünkroonse tähemärgipiirangu.

Platvorm pakub serveripoolset tööriista web_search Anthropic Messages API ja OpenAI Responses API kaudu. See võimaldab mudelil vastuse koostamise ajal otsida värsket teavet veebist, kusjuures iga päringu eest võetakse tasu eraldi. MiniMax avaldab ka MCP-rakendusi meedia genereerimise võimaluste ühendamiseks MCP-ga ühilduvate agendikeskkondadega.

Avalik API dokumentatsioon ei määratle eraldi püsivat Assistants API-t, millel oleksid majutatud assistendid, lõimed ja käitamised. Kui teie rakendus vajab selliseid objekte, rakendage vestluste salvestamine, tööriistade käivitamine ja ülesannete orkestreerimine oma rakenduses, välja arvatud juhul, kui mõni eraldi dokumenteeritud MiniMaxi toode neid pakub.

SDK-d, HTTP-juurdepääs ja mänguväljak

MiniMax dokumenteerib Anthropic SDK-d keelemudelite jaoks soovitatava keeleintegratsioonina ning pakub ka ajakohaseid OpenAI SDK näiteid Pythoni ja Node.js-i jaoks. Platvorm põhineb HTTP-l, seega saavad PHP ja muud keeled sellele otse standardsete HTTP-teekide kaudu helistada. Natiivsed meedia lõpp-punktid võivad nõuda JSON-päringuid, multipart-üleslaadimisi, asünkroonset oleku kontrollimist või WebSocketi ühendusi.

Open Platformi konsool pakub teenuse proovimiseks ja API-juurdepääsu haldamiseks mänguväljakut. Kasutage seda mandaatide valideerimiseks ja päringutega tutvumiseks, kuid korrake olulisi teste enne tootmiskasutust koodis, sest kvoodid, mudelite saadavus, arveldamine ja piirkondlik juurdepääs võivad erineda.

Piirangud ja tootmiskasutuse kaalutlused

Avaldatud piirangud erinevad mudeli ja lõpp-punkti järgi. Dokumentatsioonis on MiniMax-M3 piiranguks märgitud 200 päringut minutis ja 10 000 000 tokenit minutis. Loetletud M2.x-i keelemudelid lubavad üldjuhul 500 päringut minutis ja 20 000 000 tokenit minutis. Meediateenustel on eraldi ühenduste, päringute ja samaaegsete ülesannete piirangud; näiteks on dokumenteeritud H3 video genereerimise piiranguteks 300 päringut minutis ja maksimaalselt 30 käimasolevat ülesannet.

Avaldatud ligikaudsete väljundikiiruste kohaselt on M3 kiirus vähemalt 100 tokenit sekundis, M2.7 ja M2.5 kiirus umbes 60 tokenit sekundis ning kiirete variantide kiirus umbes 100 tokenit sekundis. Need on hinnangud, mitte latentsusaja garantiid. Tegelikku jõudlust mõjutavad viiba suurus, liiklus, piirkond, voogedastus, teenusetase ja töökoormus.

Kasutage ajutiste vigade korral eksponentsiaalset tagasipöördumist ning järgige nii minutis lubatud päringute kui ka tokenite piiranguid.
Jälgige keelemodelle kasutavaid tokeneid eraldi kõnetähemärkidest, helitundidest, piltide arvust, videosekunditest, päringutest ja asünkroonsetest ülesannetest.
Kasutage interaktiivsete teksti- või kõnekogemuste puhul voogedastust.
Hoidke üles laaditud failide identifikaatorid ja meedia allalaadimise URL-id ajutistena, välja arvatud juhul, kui asjakohane dokumentatsioon sätestab teisiti.
Hoidke piirkondliku lõpp-punkti valik, arvelduskonto ja API võtme konfiguratsioon omavahel kooskõlas.
Ärge saatke konfidentsiaalseid ega reguleeritud andmeid enne kehtiva API lepingu ja privaatsuspoliitika ülevaatamist.

Privaatsus ja andmete töötlemine

MiniMaxi API privaatsuspoliitika sätestab, et isikuandmeid võidakse säilitada nii kaua, kui see on vajalik või seadusega lubatud või kui see on vajalik andmete kogumise eesmärgi täitmiseks. Samuti märgitakse, et isikuandmeid võidakse säilitada Ameerika Ühendriikides asuvates andmekeskustes ning töödelda MiniMaxi või kolmandatest osapooltest teenusepakkujate poolt kooskõlas kohaldatava õigusega.

Poliitika kohaselt ei kasuta MiniMax sisendina saadetud isikuandmeid inimese omaduste tuletamiseks ega isikuandmeid tarbijate profileerimiseks või sihtimiseks mõeldud treenimiseks. See ei sisalda lihtsat üldist väidet, et kõik API kaudu saadetud viibad ja väljundid on välistatud igasugusest mudelite treenimisest. Enne tundlike tootmisandmete saatmist vaadake üle kehtiv poliitika ja hankige asjakohased lepingulised tagatised.

Millal on MiniMax API hea või halb valik

MiniMax on hea valik juhul, kui rakendus vajab üht arendajaplatvormi, mis hõlmab keelemudeleid, kodeerimist, arutlemist, multimodaalset sisendit, kõnet, pilte, videot, faile ja veebiotsingut. OpenAI-ga ühilduv liides võib lihtsustada kasutuselevõttu olemasolevates SDK-põhistes rakendustes, samas kui Anthropiciga ühilduv liides on platvormi soovitatav keeleintegratsioon. M3 pikk kontekst ja tööriistade kasutamise tugi on kasulikud dokumentide analüüsimisel ja agentide töövoogudes.

See võib olla halb valik juhul, kui projekt nõuab kõikides riikides identset saadavust ja hinnastamist, stabiilset ühtset API-t kõigi modaalsuste jaoks, küpseid majutatud assistendiobjekte, piiranguteta tasuta kasutust või üldist garantiid, et esitatud andmeid ei kasutata treenimiseks. Ökosüsteem on jaotatud eri tüüpi lõpp-punktide ja tootespetsiifiliste poliitikate vahel ning mudelid, kvoodid, piirkondlik juurdepääs ja meedia saadavus võivad muutuda. Enne tootmisarhitektuurile pühendumist kontrollige konkreetset mudelit, lõpp-punkti, säilitamistingimusi ja hinda.

Allikad 11