- T2A v2 के ज़रिए बंडल्ड स्पीच सिंथेसिस
MiniMax-VL-01के ज़रिए बंडल्ड इमेज अंडरस्टैंडिंगmusic-2.6के ज़रिए बंडल्ड संगीत जनरेशन- MiniMax Token Plan search API के ज़रिए बंडल्ड
web_search
| प्रदाता ID | प्रमाणीकरण | क्षमताएँ |
|---|---|---|
minimax | API कुंजी | टेक्स्ट, इमेज जनरेशन, संगीत जनरेशन, वीडियो जनरेशन, इमेज अंडरस्टैंडिंग, स्पीच, वेब खोज |
minimax-portal | OAuth | टेक्स्ट, इमेज जनरेशन, संगीत जनरेशन, वीडियो जनरेशन, इमेज अंडरस्टैंडिंग, स्पीच |
बिल्ट-इन कैटलॉग
| मॉडल | प्रकार | विवरण |
|---|---|---|
MiniMax-M3 | चैट (रीजनिंग) | डिफ़ॉल्ट होस्टेड रीजनिंग मॉडल |
MiniMax-M2.7 | चैट (रीजनिंग) | पिछला होस्टेड रीजनिंग मॉडल |
MiniMax-M2.7-highspeed | चैट (रीजनिंग) | तेज़ M2.7 रीजनिंग टियर |
MiniMax-VL-01 | विज़न | इमेज अंडरस्टैंडिंग मॉडल |
image-01 | इमेज जनरेशन | टेक्स्ट-से-इमेज और इमेज-से-इमेज संपादन |
music-2.6 | संगीत जनरेशन | डिफ़ॉल्ट संगीत मॉडल |
music-2.5 | संगीत जनरेशन | पिछला संगीत जनरेशन टियर |
music-2.0 | संगीत जनरेशन | लेगेसी संगीत जनरेशन टियर |
MiniMax-Hailuo-2.3 | वीडियो जनरेशन | टेक्स्ट-से-वीडियो और इमेज रेफ़रेंस फ़्लो |
शुरू करना
अपनी पसंदीदा प्रमाणीकरण विधि चुनें और सेटअप चरणों का पालन करें।- OAuth (Coding Plan)
- API key
सर्वोत्तम उपयोग: OAuth के ज़रिए MiniMax Coding Plan के साथ त्वरित सेटअप, API कुंजी आवश्यक नहीं।
- International
- China
OAuth सेटअप
minimax-portal प्रदाता id का उपयोग करते हैं। मॉडल refs minimax-portal/MiniMax-M3 फ़ॉर्म का पालन करते हैं।openclaw configure के ज़रिए कॉन्फ़िगर करें
JSON संपादित किए बिना MiniMax सेट करने के लिए इंटरैक्टिव कॉन्फ़िग विज़र्ड का उपयोग करें:
Choose a MiniMax auth option
उपलब्ध MiniMax विकल्पों में से एक चुनें:
| प्रमाणीकरण विकल्प | विवरण |
|---|---|
minimax-global-oauth | अंतरराष्ट्रीय OAuth (Coding Plan) |
minimax-cn-oauth | चीन OAuth (Coding Plan) |
minimax-global-api | अंतरराष्ट्रीय API कुंजी |
minimax-cn-api | चीन API कुंजी |
क्षमताएँ
इमेज जनरेशन
MiniMax Pluginimage_generate टूल के लिए image-01 मॉडल रजिस्टर करता है। यह समर्थन करता है:
- aspect ratio control के साथ टेक्स्ट-से-इमेज जनरेशन
- aspect ratio control के साथ इमेज-से-इमेज संपादन (subject reference)
- प्रति अनुरोध अधिकतम 9 output images
- प्रति edit request अधिकतम 1 reference image
- समर्थित aspect ratios:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
MINIMAX_API_KEY या OAuth प्रमाणीकरण का उपयोग करता है। यदि MiniMax पहले से सेट है, तो कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं है।
minimax और minimax-portal दोनों समान
image-01 मॉडल के साथ image_generate रजिस्टर करते हैं। API-key सेटअप MINIMAX_API_KEY का उपयोग करते हैं; OAuth सेटअप इसके बजाय
बंडल्ड minimax-portal प्रमाणीकरण पथ का उपयोग कर सकते हैं।
इमेज जनरेशन हमेशा MiniMax के समर्पित image endpoint
(/v1/image_generation) का उपयोग करता है और models.providers.minimax.baseUrl को अनदेखा करता है,
क्योंकि वह फ़ील्ड chat/Anthropic-compatible base URL को कॉन्फ़िगर करता है। इमेज जनरेशन को
CN endpoint के ज़रिए route करने के लिए
MINIMAX_API_HOST=https://api.minimaxi.com सेट करें; डिफ़ॉल्ट global endpoint
https://api.minimax.io है।
जब onboarding या API-key setup स्पष्ट models.providers.minimax
entries लिखता है, OpenClaw MiniMax-M3, MiniMax-M2.7, और
MiniMax-M2.7-highspeed को chat models के रूप में materialize करता है। M3 टेक्स्ट और इमेज input advertise करता है;
image understanding अलग से Plugin-owned
MiniMax-VL-01 media provider के ज़रिए exposed रहता है।
साझा tool parameters, provider selection, और failover behavior के लिए इमेज जनरेशन देखें।
टेक्स्ट-से-स्पीच
बंडल्डminimax Plugin MiniMax T2A v2 को
messages.tts के लिए speech provider के रूप में रजिस्टर करता है।
- डिफ़ॉल्ट TTS मॉडल:
speech-2.8-hd - डिफ़ॉल्ट आवाज़:
English_expressive_narrator - समर्थित बंडल्ड model ids में
speech-2.8-hd,speech-2.8-turbo,speech-2.6-hd,speech-2.6-turbo,speech-02-hd,speech-02-turbo,speech-01-hd, औरspeech-01-turboशामिल हैं। - Auth resolution
messages.tts.providers.minimax.apiKey, फिरminimax-portalOAuth/token auth profiles, फिर Token Plan environment keys (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), फिरMINIMAX_API_KEYहै। - यदि कोई TTS host कॉन्फ़िगर नहीं है, OpenClaw कॉन्फ़िगर किए गए
minimax-portalOAuth host का फिर से उपयोग करता है और/anthropicजैसे Anthropic-compatible path suffixes हटा देता है। - सामान्य audio attachments MP3 रहते हैं।
- Feishu और Telegram जैसे voice-note targets को MiniMax
MP3 से 48kHz Opus में
ffmpegके साथ transcode किया जाता है, क्योंकि Feishu/Lark file API native audio messages के लिए केवलfile_type: "opus"स्वीकार करता है। - MiniMax T2A fractional
speedऔरvolस्वीकार करता है, लेकिनpitchinteger के रूप में भेजा जाता है; OpenClaw API request से पहले fractionalpitchvalues को truncate करता है।
| सेटिंग | Env var | डिफ़ॉल्ट | विवरण |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | MiniMax T2A API host. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | TTS model id. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | speech output के लिए उपयोग की गई voice id. |
messages.tts.providers.minimax.speed | 1.0 | Playback speed, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Volume, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Integer pitch shift, -12..12. |
संगीत जनरेशन
बंडल्ड MiniMax Pluginminimax और minimax-portal दोनों के लिए साझा
music_generate टूल के ज़रिए संगीत जनरेशन रजिस्टर करता है।
- डिफ़ॉल्ट संगीत मॉडल:
minimax/music-2.6 - OAuth संगीत मॉडल:
minimax-portal/music-2.6 minimax/music-2.5औरminimax/music-2.0का भी समर्थन करता है- प्रॉम्प्ट नियंत्रण:
lyrics,instrumental - आउटपुट फ़ॉर्मैट:
mp3 - सेशन-समर्थित रन साझा task/status फ़्लो के माध्यम से अलग हो जाते हैं, जिसमें
action: "status"शामिल है
साझा टूल पैरामीटर, प्रदाता चयन, और failover व्यवहार के लिए संगीत जनरेशन देखें।
वीडियो जनरेशन
बंडल किया गया MiniMax Pluginminimax और minimax-portal दोनों के लिए साझा
video_generate टूल के माध्यम से वीडियो जनरेशन रजिस्टर करता है।
- डिफ़ॉल्ट वीडियो मॉडल:
minimax/MiniMax-Hailuo-2.3 - OAuth वीडियो मॉडल:
minimax-portal/MiniMax-Hailuo-2.3 - मोड: text-to-video और single-image reference फ़्लो
aspectRatioऔरresolutionका समर्थन करता है
साझा टूल पैरामीटर, प्रदाता चयन, और failover व्यवहार के लिए वीडियो जनरेशन देखें।
इमेज समझ
MiniMax Plugin इमेज समझ को टेक्स्ट कैटलॉग से अलग रजिस्टर करता है:| प्रदाता ID | डिफ़ॉल्ट इमेज मॉडल |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
वेब खोज
MiniMax Plugin MiniMax Token Plan search API के माध्यम सेweb_search भी रजिस्टर करता है।
- प्रदाता id:
minimax - संरचित परिणाम: शीर्षक, URL, स्निपेट, संबंधित क्वेरी
- पसंदीदा env var:
MINIMAX_CODE_PLAN_KEY - स्वीकृत env aliases:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - संगतता fallback:
MINIMAX_API_KEYजब वह पहले से token-plan क्रेडेंशियल की ओर इशारा करता हो - क्षेत्र पुनः उपयोग:
plugins.entries.minimax.config.webSearch.region, फिरMINIMAX_API_HOST, फिर MiniMax प्रदाता base URLs - खोज प्रदाता id
minimaxपर रहती है; OAuth CN/global सेटअपmodels.providers.minimax-portal.baseUrlके माध्यम से अप्रत्यक्ष रूप से क्षेत्र निर्देशित कर सकता है औरMINIMAX_OAUTH_TOKENके माध्यम से bearer auth दे सकता है
plugins.entries.minimax.config.webSearch.* के अंतर्गत रहता है।
पूर्ण वेब खोज कॉन्फ़िगरेशन और उपयोग के लिए MiniMax Search देखें।
उन्नत कॉन्फ़िगरेशन
कॉन्फ़िगरेशन विकल्प
कॉन्फ़िगरेशन विकल्प
| विकल्प | विवरण |
|---|---|
models.providers.minimax.baseUrl | https://api.minimax.io/anthropic को प्राथमिकता दें (Anthropic-compatible); https://api.minimax.io/v1 OpenAI-compatible payloads के लिए वैकल्पिक है |
models.providers.minimax.api | anthropic-messages को प्राथमिकता दें; openai-completions OpenAI-compatible payloads के लिए वैकल्पिक है |
models.providers.minimax.apiKey | MiniMax API key (MINIMAX_API_KEY) |
models.providers.minimax.models | id, name, reasoning, contextWindow, maxTokens, cost परिभाषित करें |
agents.defaults.models | उन मॉडलों को alias करें जिन्हें आप allowlist में चाहते हैं |
models.mode | यदि आप built-ins के साथ MiniMax जोड़ना चाहते हैं तो merge रखें |
Thinking डिफ़ॉल्ट
Thinking डिफ़ॉल्ट
api: "anthropic-messages" पर, OpenClaw MiniMax M2.x मॉडलों के लिए thinking: { type: "disabled" } इंजेक्ट करता है, जब तक कि thinking पहले से params/config में स्पष्ट रूप से सेट न हो।यह M2.x के streaming endpoint को OpenAI-style delta chunks में reasoning_content उत्सर्जित करने से रोकता है, जिससे आंतरिक reasoning दृश्यमान आउटपुट में लीक हो सकती थी।MiniMax-M3 (और M3.x) अपवाद है: M3 सही Anthropic thinking blocks उत्सर्जित करता है और thinking अक्षम होने पर stop_reason: "end_turn" के साथ खाली content array लौटाता है, इसलिए wrapper M3 को प्रदाता के omitted/adaptive thinking path पर रखता है।तेज़ मोड
तेज़ मोड
Anthropic-compatible stream path पर
/fast on या params.fastMode: true MiniMax-M2.7 को MiniMax-M2.7-highspeed में फिर से लिखता है।Fallback उदाहरण
Fallback उदाहरण
इसके लिए सर्वोत्तम: अपने सबसे मजबूत latest-generation मॉडल को primary रखें, MiniMax M2.7 पर fail over करें। नीचे का उदाहरण Opus को ठोस primary के रूप में उपयोग करता है; इसे अपने पसंदीदा latest-gen primary मॉडल से बदलें।
Coding Plan उपयोग विवरण
Coding Plan उपयोग विवरण
- Coding Plan उपयोग API:
https://api.minimaxi.com/v1/token_plan/remainsयाhttps://api.minimax.io/v1/token_plan/remains(coding plan key आवश्यक है)। - उपयोग polling कॉन्फ़िगर होने पर
models.providers.minimax-portal.baseUrlयाmodels.providers.minimax.baseUrlसे host प्राप्त करती है, इसलिएhttps://api.minimax.io/anthropicका उपयोग करने वाले global setupsapi.minimax.ioको poll करते हैं। अनुपस्थित या malformed base URLs संगतता के लिए CN fallback रखते हैं। - OpenClaw MiniMax coding-plan उपयोग को अन्य प्रदाताओं द्वारा उपयोग किए जाने वाले उसी
% leftडिस्प्ले में normalize करता है। MiniMax के rawusage_percent/usagePercentफ़ील्ड remaining quota हैं, consumed quota नहीं, इसलिए OpenClaw उन्हें invert करता है। मौजूद होने पर count-based फ़ील्ड प्राथमिकता पाते हैं। - जब API
model_remainsलौटाता है, OpenClaw chat-model entry को प्राथमिकता देता है, आवश्यकता होने परstart_time/end_timeसे window label निकालता है, और plan label में चुने गए मॉडल का नाम शामिल करता है ताकि coding-plan windows को अलग करना आसान हो। - उपयोग snapshots
minimax,minimax-cn, औरminimax-portalको उसी MiniMax quota surface के रूप में मानते हैं, और Coding Plan key env vars पर fallback करने से पहले संग्रहित MiniMax OAuth को प्राथमिकता देते हैं।
नोट्स
- मॉडल refs auth path का पालन करते हैं:
- API-key सेटअप:
minimax/<model> - OAuth सेटअप:
minimax-portal/<model>
- API-key सेटअप:
- डिफ़ॉल्ट chat मॉडल:
MiniMax-M3 - वैकल्पिक chat मॉडल:
MiniMax-M2.7,MiniMax-M2.7-highspeed - Onboarding और direct API-key सेटअप M3 और दोनों M2.7 variants के लिए मॉडल definitions लिखते हैं
- इमेज समझ plugin-owned
MiniMax-VL-01media provider का उपयोग करती है - यदि आपको सटीक cost tracking चाहिए तो
models.jsonमें pricing values अपडेट करें - वर्तमान प्रदाता id की पुष्टि करने के लिए
openclaw models listका उपयोग करें, फिरopenclaw models set minimax/MiniMax-M3याopenclaw models set minimax-portal/MiniMax-M3से स्विच करें
प्रदाता नियमों के लिए मॉडल प्रदाता देखें।
समस्या निवारण
"अज्ञात मॉडल: minimax/MiniMax-M3"
"अज्ञात मॉडल: minimax/MiniMax-M3"
आमतौर पर इसका मतलब है कि MiniMax प्रदाता कॉन्फ़िगर नहीं है (कोई matching provider entry नहीं और कोई MiniMax auth profile/env key नहीं मिला)। इस detection के लिए एक fix 2026.1.12 में है। ठीक करने के लिए:
- 2026.1.12 पर upgrade करें (या source
mainसे चलाएँ), फिर gateway restart करें। openclaw configureचलाएँ और MiniMax auth option चुनें, या- matching
models.providers.minimaxयाmodels.providers.minimax-portalblock मैन्युअल रूप से जोड़ें, या MINIMAX_API_KEY,MINIMAX_OAUTH_TOKEN, या MiniMax auth profile सेट करें ताकि matching provider inject किया जा सके।
- API-key path:
minimax/MiniMax-M3,minimax/MiniMax-M2.7, याminimax/MiniMax-M2.7-highspeed - OAuth path:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7, याminimax-portal/MiniMax-M2.7-highspeed
अधिक सहायता: समस्या निवारण और FAQ।
संबंधित
मॉडल चयन
प्रदाताओं, मॉडल refs, और failover व्यवहार को चुनना।
इमेज जनरेशन
साझा इमेज टूल पैरामीटर और प्रदाता चयन।
संगीत जनरेशन
साझा संगीत टूल पैरामीटर और प्रदाता चयन।
वीडियो जनरेशन
साझा वीडियो टूल पैरामीटर और प्रदाता चयन।
MiniMax Search
MiniMax Token Plan के माध्यम से वेब खोज कॉन्फ़िगरेशन।
समस्या निवारण
सामान्य समस्या निवारण और FAQ।