Mis on Xiaomi MiMo API?
Xiaomi MiMo API avatud platvorm on Xiaomi praegune arendajatele suunatud mudelite järeldusplatvorm. See võimaldab rakendustel saata MiMo mudelitele HTTPS-i kaudu viipasid ja muid toetatud sisendeid ning saada genereeritud vastuseid.
Platvorm on loodud tuttavana arendajatele, kes on kasutanud teisi mudelite API-sid. Selle peamine liides ühildub OpenAI API-ga ning Xiaomi dokumenteerib ka Anthropicuga ühilduva juurdepääsu. Peamine reaalajas kasutatav baas-URL on https://api.xiaomimimo.com/v1.
Kasutage API-t, kui soovite lisada rakendusele mudeli loodud teksti, piltide mõistmise, tööriistade kasutamise, veebist toetatud vastused, struktureeritud JSON-i või asünkroonse pakktöötluse. See on mõeldud arendajatele, kes loovad teenuseid, automatiseerimist, agentide töövooge, programmeerimistööriistu ja muid tarkvaraintegreeringuid, mitte inimestele, kes otsivad eraldiseisvat tarbijatele mõeldud vestlusrobotit.
Kuidas saada juurdepääs ja luua API-võti?
Alustage Xiaomi konto loomisest või olemasoleva konto kasutamisest ning avage MiMo API avatud platvormi konsool. Looge konsoolis API-võti ja kontrollige, milline arveldusviis ning piirkondlik teenus on sellega seotud.
Kasutuspõhise arvelduse API-võtmed kasutavad vormingut sk-. Token Plani mandaadid kasutavad eraldi vormingut tp- või meeskonnaplaani vorminguid ning neid tuleb kasutada spetsiaalse baas-URL-iga. Need mandaaditüübid ja saldod ei ole omavahel asendatavad.
Saatke võti kas api-key päises või Beareri autoriseerimispäises, olenevalt integratsioonimustrist. Hoidke võtit keskkonnamuutujas või saladuste halduris, mitte brauserikoodis, lähtekoodihoidlas ega mobiilirakenduses.
Xiaomi praegune dokumentatsioon kirjeldab peamiselt isikliku konto kaudu sisselogimist ning mõned teenused võivad nõuda täiendavat konto- või isikusamasuse kontrolli. Enne automatiseeritud tootmiskonto registreerimise kavandamist kontrollige konsoolis kehtivaid nõudeid.
Millise mudeli ja API peaksite valima?
Uute integratsioonide puhul alustage praegusest MiMo V2.6 mudeliperest:
mimo-v2.6-proon suurema võimekusega üldotstarbeline valik, mis toetab täieliku modaalsusega kasutusjuhtumeid.mimo-v2.6-flashon paljude teksti- ja multimodaalsete töökoormuste jaoks soodsam valik.mimo-v2.6-pro-ultraspeedon mõeldud latentsustundlike töökoormuste jaoks, kuid selle kättesaadavus ja teenusetingimused võivad nõuda Xiaomiga eraldi kokkuleppeid.
Kasutage Chat Completionsit, kui vajate laialdaselt dokumenteeritud sõnumipõhist liidest. Kasutage Responsesiga ühilduvat lõpp-punkti, kui teie integratsioon või tööriistaökosüsteem eeldab konkreetselt uuemat Responses-mustrit, sealhulgas mõnda programmeerimis- ja agenditööriista.
Asjakohased lõpp-punktid on /chat/completions, /responses ja /models. MiMo V2.5 ja MiMo V2.5 Pro on mõnes dokumentatsioonis endiselt olemas, kuid nende kasutuselt kõrvaldamine on kavandatud 21. oktoobriks 2026 kell 10.00 Pekingi aja järgi. Kui V2.6 vasted on saadaval, ei ole need uue tootmislahenduse lähtekohaks sobivad.
Tehke oma esimene API-päring
Järgmine Pythoni näide kasutab praegust OpenAI Pythoni SDK-d koos Xiaomi OpenAI-ga ühilduva baas-URL-iga. Installige SDK käsuga pip install -U openai, määrake MIMO_API_KEY ja käivitage seejärel päring.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MIMO_API_KEY"],
base_url="https://api.xiaomimimo.com/v1",
)
response = client.chat.completions.create(
model="mimo-v2.6-flash",
messages=[
{"role": "user", "content": "Explain API keys in one sentence."}
],
max_completion_tokens=256,
)
print(response.choices[0].message.content)Sama päringu saab teha otse HTTP kaudu:
curl https://api.xiaomimimo.com/v1/chat/completions
-H "api-key: $MIMO_API_KEY"
-H "Content-Type: application/json"
-d '{
"model": "mimo-v2.6-flash",
"messages": [
{"role": "user", "content": "Explain API keys in one sentence."}
],
"max_completion_tokens": 256
}'Vastuse mõistmine
Chat Completionsi vastus sisaldab massiivi choices. Genereeritud assistendi tekst on tavaliselt saadaval aadressil choices[0].message.content. Rakendused peavad siiski arvestama olukordadega, kus mudel tagastab teksti asemel tööriistakutse või kus vastus sisaldab viga, mittetäielikku väljundit või kasutatava sisu puudumist.
Tootmiskoodis kontrollige HTTP-olekut, käsitlege vigaseid vastuseid ja valideerige kogu sisu, mida kasutatakse mõne teise süsteemi juhtimiseks. Ärge käsitlege mudeli genereeritud teksti ega tööriistaargumente automaatselt usaldusväärse sisendina.
Kuidas Xiaomi MiMo API hinnastamine toimib?
MiMo toetab kasutuspõhist arveldust, mis põhineb žetoonide kasutamisel. Sisendžetoonidel, väljundžetoonidel ja vahemällu salvestatud sisendžetoonidel on eraldi hinnad ning vahemälust tabamised maksavad vähem kui tavaline sisendi töötlemine. Xiaomi dokumenteerib Hiina-sisese RMB-hinnastamise ja välismaise dollaripõhise hinnastamise eraldi. Veebiotsingut arveldatakse mudeližetoonidest eraldi.
22. septembri 2026 seisuga on dokumenteeritud välismaised reaalaja hinnad järgmised:
| Mudel | Vahemällu salvestatud sisend | Sisend | Väljund |
|---|---|---|---|
| MiMo V2.6 Pro | $0.0036 miljoni žetooni kohta | $0.435 miljoni žetooni kohta | $0.87 miljoni žetooni kohta |
| MiMo V2.6 Flash | $0.0028 miljoni žetooni kohta | $0.14 miljoni žetooni kohta | $0.28 miljoni žetooni kohta |
Vahemällu kirjutamise tasud on dokumentatsiooni kohaselt ajutiselt tasuta. Toetatud mudelite pakktöötlus maksab 50% vastavatest reaalaja hindadest. Platvorm pakub ka fikseeritud Token Plani pakette eraldi kvootide, mandaatide ja baas-URL-idega. Token Plani saldot ei saa eeldada töötavat samamoodi nagu tavalise kasutuspõhise arvelduskonto krediiti.
Rakenduse tegelik maksumus sõltub viiba pikkusest, genereeritud väljundist, vahemälu kasutamisest, mudeli valikust, veebiotsingu kasutamisest ja pakktöötlusse saadetava töö mahust. Enne eelarve määramist mõõtke žetoonide kasutust rakendusele tüüpiliste päringutega.
Mida saavad arendajad API-ga luua?
Voogedastatavad vastused
Voogedastus kasutab serveri saadetud sündmusi, et edastada väljundit järk-järgult, selle asemel et oodata täielikku vastust. See on kasulik vestlusliideste ja kaua kestvate genereerimiste puhul, sest kasutaja näeb osa tekstist varem. Voogedastatavad sündmused võivad sisaldada genereeritud teksti, põhjendamisega seotud välju, kui need on rakendatavad, ning tööriistakutsete muutusi.
stream = client.chat.completions.create(
model="mimo-v2.6-flash",
messages=[
{"role": "user", "content": "List three API testing tips."}
],
stream=True,
max_completion_tokens=256,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Funktsioonide ja tööriistade kutsumine
Funktsioonikutse võimaldab kirjeldada rakenduse funktsiooni JSON Schema laadse parameetrimääratluse abil. Mudel võib taotleda selle funktsiooni kasutamist, rakendus käivitab selle ja saadab tulemuse hilisema vestlusvooru käigus tagasi. Mudel ei käivita teie funktsiooni ise.
response = client.chat.completions.create(
model="mimo-v2.6-pro",
messages=[
{"role": "user", "content": "What is the weather in Seattle?"}
],
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",
max_completion_tokens=512,
)
message = response.choices[0].message
if message.tool_calls:
for call in message.tool_calls:
print(call.function.name, call.function.arguments)Enne millegi käivitamist valideerige funktsiooni nimi ja argumendid. Kontode, maksete, failide või muude välissüsteemidega seotud tööriistade puhul lisage rakenduse tasandi autoriseerimis- ja kinnituskontrollid.
Struktureeritud ja JSON-väljund
Chat Completions toetab JSON-režiimi koos response_format: {"type": "json_object"}. Samuti peate mudelile ütlema, et see tagastaks JSON-i. JSON-režiim ei kaota vajadust rakendusepõhise valideerimise järele: parsige vastus ja valideerige see oma eeldatava skeemi vastu enne selle salvestamist või kasutamist.
response = client.chat.completions.create(
model="mimo-v2.6-flash",
messages=[
{
"role": "system",
"content": "Return only valid JSON with the keys answer and confidence."
},
{"role": "user", "content": "Explain what an API key is."}
],
response_format={"type": "json_object"},
max_completion_tokens=256,
)
print(response.choices[0].message.content)Veebiotsing
Veebiotsingu plugin võimaldab toetatud mudelitel hankida ajakohast avalikku veebiteavet. See tuleb konsoolis lubada ja selle eest arveldatakse eraldi. Seda saab kasutada nii voogedastatavate kui ka voogedastuseta vastustega ning kombineerida kohandatud funktsioonitööriistadega.
Kuna otsingutulemused võivad muutuda ja olla mittetäielikud, peaksid rakendused otsustama, kuidas allikaid kuvada, käsitleda tulemusteta olukordi ning eristada hangitud teavet mudeli enda loodud selgitusest.
Piltide, heli, video ja failide sisend
Toetatud MiMo mudelid aktsepteerivad pildisisendit avalikult kättesaadavate pildi-URL-ide või Base64-andme-URL-ide kaudu. Dokumenteeritud pildivormingud hõlmavad JPEG-i, PNG-d, GIF-i, WebP-d ja BMP-d; ühe URL-i või kodeeritud pildi suurus on piiratud 50 MB-ga.
Dokumenteeritud reaalaja multimodaalsed mudelid ei toeta kohaliku pildifaili üleslaadimist loetletud pildimõistmise liidese kaudu. Teisendage pilt sobivaks andme-URL-iks või tehke see vajaduse korral kättesaadavaks juurdepääsetava URL-i kaudu. Platvorm dokumenteerib toetatud mudelite puhul ka heli- ja videosisendi, kuid kättesaadavus sõltub konkreetsest mudelist.
Failide üleslaadimine on Batch Inference'i jaoks saadaval. Arendajad laadivad üles JSONL-vormingus tööfailid, loovad asünkroonse pakktöö ja laadivad hiljem alla tulemuste- või veafailid. Pakktöö sisend- ja väljundfaile säilitatakse vaikimisi 30 päeva ning seejärel kustutatakse need automaatselt.
SDK-d, mänguväljak ja arendajatööriistad
Esitatud dokumentatsioonis ei ole kinnitatud Xiaomi-spetsiifilise SDK olemasolu. Ametlikes näidetes kasutatakse ühilduvate baas-URL-ide kaudu OpenAI Pythoni SDK-d ja Anthropic Pythoni SDK-d. JavaScripti ja PHP rakendused saavad kasutada OpenAI-ga ühilduvat HTTP API-t või ühilduvat klienditeeki.
MiMo platvormi konsool pakub API-võtmete haldust, mudelite juurdepääsu, arveldusseadeid ja selliste funktsioonide nagu veebiotsingu aktiveerimist. Platvormi mänguväljak on saadaval aadressil https://platform.xiaomimimo.com/. Xiaomi pakub ka eraldi agentide ökosüsteemi, mis hõlmab MCP-d, oskusi ja agentide avaldamist. See ökosüsteem erineb püsiva assistendiobjekti API-st: MiMo API pakub mudelitasandi tööriistakutseid ja Responsesiga ühilduvust, kuid läbi vaadatud dokumentatsioon ei kirjelda püsivat assistendiressurssi.
Piirangud ja tootmiskasutuse kaalutlused
MiMo V2.6 Pro ja Flashi puhul on dokumenteeritud piirang konto ja mudeli kohta 100 päringut minutis ning 10 miljonit žetooni minutis. Piirang hõlmab sama konto kõigi API-võtmetega tehtud päringuid. ASR- ja TTS-mudelite puhul on dokumenteeritud 100 päringut minutis. UltraSpeed kasutab avaldatud standardkvoodi asemel kohandatud teenusekokkuleppeid.
Xiaomi ei avalda läbi vaadatud API-dokumentatsioonis üldist latentsuse SLA-d. Suur serverikoormus võib põhjustada viivitusi või HTTP 429 vastuseid. Tootmiskliendid peaksid kasutama päringu ajalõppe, eksponentsiaalset tagasipöördumist, piiratud korduskatsete arvu ja idempotentset rakendusetasandi käsitlust, et korduspäring ei käivitaks kogemata välist toimingut uuesti.
Hoidke kasutuspõhise arvelduse, Token Plani ja piirkondlike pakktöötlusteenuste mandaadid ning konfiguratsioonid eraldi. Enne multimodaalse sisendi, veebiotsingu, heli, video või struktureeritud väljundi kasutamisele tuginemist kinnitage mudelipõhine tugi. Samuti tuleb märkida, et siin läbi vaadatud avalik dokumentatsioon ei määra kindlaks tavaliste reaalajaviipade ja -väljundite üldist säilitamisperioodi ega universaalset treeninguks kasutamise poliitikat. Pakifailide puhul on dokumenteeritud 30-päevane säilitusperiood, kuid muude andmekäitlusnõuete kohta peaksid arendajad hankima kehtiva lepingulise või poliitikapõhise kinnituse.
Millal on Xiaomi MiMo API hea valik?
MiMo on mõistlik valik, kui soovite ühes Xiaomi platvormis OpenAI-ga ühilduvat integratsiooni, praeguseid MiMo V2.6 mudeleid, žetoonipõhist arveldamist, piltide mõistmist, tööriistakutseid, veebiotsingut, struktureeritud JSON-i või pakktöötlust. Ühilduvus tuttavate SDK-dega võib vähendada vajaliku uue kliendikoodi hulka.
See võib olla halb valik, kui vajate üle maailma ühtset teenust, mille mudelifunktsioonid on kõigis piirkondades identsed, avaldatud üldist latentsuse SLA-d, küpset püsiva assistendi ressursimudelit või selgelt dokumenteeritud reaalaja andmete säilitamise ja treenimiseks kasutamise tagatisi. Eraldi mandaaditüübid, piirkondlik pakktöötluse lõpp-punkt, mudelipõhised võimalused ja kavandatud V2.5 kasutuselt kõrvaldamine nõuavad samuti töökorralduslikku planeerimist.
Uue projekti puhul alustage kulutundlike töökoormuste jaoks mimo-v2.6-flash või valige mimo-v2.6-pro, kui suurema võimekusega variant on sobivam. Enne tootmiskasutusele üleminekut testige täpselt neid viipasid, tööriistu, sisendvorminguid, piiranguid ja arveldusteekonda, mida teie rakendus kasutama hakkab.
