- Вбудований синтез мовлення через T2A v2
- Вбудоване розуміння зображень через
MiniMax-VL-01 - Вбудовану генерацію музики через
music-2.6 - Вбудований
web_searchчерез пошуковий API MiniMax Token Plan
| 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
Найкраще для: швидкого налаштування MiniMax Coding Plan через OAuth без потреби в API-ключі.
- International
- China
Налаштування OAuth використовують ID провайдера
minimax-portal. Посилання на моделі мають форму minimax-portal/MiniMax-M3.Налаштування через openclaw configure
Скористайтеся інтерактивним майстром конфігурації, щоб налаштувати MiniMax без редагування JSON:
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-ключ для Китаю |
Можливості
Генерація зображень
Plugin MiniMax реєструє модельimage-01 для інструмента image_generate. Вона підтримує:
- Генерацію зображень із тексту з керуванням співвідношенням сторін
- Редагування зображення за зображенням (референс суб’єкта) з керуванням співвідношенням сторін
- До 9 вихідних зображень на запит
- До 1 референсного зображення на запит редагування
- Підтримувані співвідношення сторін:
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_generate з тією самою
моделлю image-01. Налаштування з API-ключем використовують MINIMAX_API_KEY; налаштування OAuth можуть натомість використовувати
вбудований шлях автентифікації minimax-portal.
Генерація зображень завжди використовує спеціальну кінцеву точку MiniMax для зображень
(/v1/image_generation) та ігнорує models.providers.minimax.baseUrl,
оскільки це поле налаштовує базову URL-адресу для чату/Anthropic-сумісного API. Установіть
MINIMAX_API_HOST=https://api.minimaxi.com, щоб спрямовувати генерацію зображень
через китайську кінцеву точку; стандартна глобальна кінцева точка:
https://api.minimax.io.
Коли онбординг або налаштування API-ключа записує явні записи models.providers.minimax,
OpenClaw матеріалізує MiniMax-M3, MiniMax-M2.7 і
MiniMax-M2.7-highspeed як чат-моделі. M3 заявляє підтримку текстового та зображувального вводу;
розуміння зображень залишається окремо доступним через медіапровайдера
MiniMax-VL-01, який належить Plugin.
Див. Генерація зображень, щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
Перетворення тексту на мовлення
Вбудований Pluginminimax реєструє MiniMax T2A v2 як провайдера мовлення для
messages.tts.
- Стандартна TTS-модель:
speech-2.8-hd - Стандартний голос:
English_expressive_narrator - Підтримувані вбудовані ID моделей включають
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. - Порядок визначення автентифікації:
messages.tts.providers.minimax.apiKey, потім профілі автентифікації OAuth/токенаminimax-portal, потім ключі середовища Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), потімMINIMAX_API_KEY. - Якщо хост TTS не налаштовано, OpenClaw повторно використовує налаштований
OAuth-хост
minimax-portalі прибирає суфікси Anthropic-сумісного шляху, такі як/anthropic. - Звичайні аудіовкладення залишаються MP3.
- Цілі голосових нотаток, як-от Feishu і Telegram, транскодуються з MiniMax
MP3 у 48 кГц Opus за допомогою
ffmpeg, оскільки файловий API Feishu/Lark приймає лишеfile_type: "opus"для нативних аудіоповідомлень. - MiniMax T2A приймає дробові
speedіvol, алеpitchнадсилається як ціле число; OpenClaw відсікає дробову частину значеньpitchперед API-запитом.
| Налаштування | Змінна середовища | Стандартне значення | Опис |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | Хост API MiniMax T2A. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | ID TTS-моделі. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | ID голосу для мовленнєвого виводу. |
messages.tts.providers.minimax.speed | 1.0 | Швидкість відтворення, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Гучність, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Цілочисельний зсув висоти тону, -12..12. |
Генерація музики
Вбудований Plugin MiniMax реєструє генерацію музики через спільний інструментmusic_generate як для minimax, так і для minimax-portal.
- Типова музична модель:
minimax/music-2.6 - Музична модель OAuth:
minimax-portal/music-2.6 - Також підтримує
minimax/music-2.5іminimax/music-2.0 - Елементи керування промптом:
lyrics,instrumental - Формат виводу:
mp3 - Запуски з підтримкою сеансу від’єднуються через спільний потік завдань/статусу, зокрема
action: "status"
Див. Генерація музики, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку failover.
Генерація відео
Вбудований plugin MiniMax реєструє генерацію відео через спільний інструментvideo_generate для minimax і minimax-portal.
- Типова відеомодель:
minimax/MiniMax-Hailuo-2.3 - Відеомодель OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - Режими: перетворення тексту на відео та потоки з посиланням на одне зображення
- Підтримує
aspectRatioіresolution
Див. Генерація відео, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку failover.
Розуміння зображень
Plugin MiniMax реєструє розуміння зображень окремо від текстового каталогу:| ID постачальника | Типова модель зображень |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Вебпошук
Plugin MiniMax також реєструєweb_search через search API MiniMax Token Plan.
- ID постачальника:
minimax - Структуровані результати: заголовки, URL-адреси, фрагменти, пов’язані запити
- Рекомендована змінна середовища:
MINIMAX_CODE_PLAN_KEY - Прийняті псевдоніми середовища:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Резервна сумісність:
MINIMAX_API_KEY, коли вона вже вказує на облікові дані token-plan - Повторне використання регіону:
plugins.entries.minimax.config.webSearch.region, потімMINIMAX_API_HOST, потім базові URL-адреси постачальника MiniMax - Пошук залишається на ID постачальника
minimax; налаштування OAuth CN/global може непрямо спрямовувати регіон черезmodels.providers.minimax-portal.baseUrlі надавати bearer auth черезMINIMAX_OAUTH_TOKEN
plugins.entries.minimax.config.webSearch.*.
Див. Пошук MiniMax, щоб дізнатися про повну конфігурацію та використання вебпошуку.
Розширена конфігурація
Параметри конфігурації
Параметри конфігурації
| Параметр | Опис |
|---|---|
models.providers.minimax.baseUrl | Надавайте перевагу https://api.minimax.io/anthropic (сумісний з Anthropic); https://api.minimax.io/v1 є необов’язковим для payload, сумісних з OpenAI |
models.providers.minimax.api | Надавайте перевагу anthropic-messages; openai-completions є необов’язковим для payload, сумісних з OpenAI |
models.providers.minimax.apiKey | API-ключ MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models | Визначте id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models | Призначте псевдоніми моделям, які хочете додати до allowlist |
models.mode | Залиште merge, якщо хочете додати MiniMax поряд із вбудованими моделями |
Типові налаштування Thinking
Типові налаштування Thinking
Для
api: "anthropic-messages" OpenClaw вставляє thinking: { type: "disabled" } для моделей MiniMax M2.x, якщо thinking ще не задано явно в параметрах/конфігурації.Це не дає потоковому endpoint M2.x видавати reasoning_content у delta chunks стилю OpenAI, що призвело б до витоку внутрішнього reasoning у видимий вивід.MiniMax-M3 (і M3.x) виняток: M3 видає правильні thinking blocks Anthropic і повертає порожній масив content із stop_reason: "end_turn", коли thinking вимкнено, тому wrapper залишає M3 на пропущеному/адаптивному шляху thinking постачальника.Швидкий режим
Швидкий режим
/fast on або params.fastMode: true переписує MiniMax-M2.7 на MiniMax-M2.7-highspeed на потоковому шляху, сумісному з Anthropic.Приклад резервного переходу
Приклад резервного переходу
Найкраще для: залишити найсильнішу модель останнього покоління як основну й переходити на MiniMax M2.7 у разі збою. У прикладі нижче Opus використано як конкретну основну модель; замініть її на бажану основну модель останнього покоління.
Подробиці використання Coding Plan
Подробиці використання Coding Plan
- API використання Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainsабоhttps://api.minimax.io/v1/token_plan/remains(потрібен ключ coding plan). - Опитування використання виводить host із
models.providers.minimax-portal.baseUrlабоmodels.providers.minimax.baseUrl, якщо їх налаштовано, тому глобальні налаштування зhttps://api.minimax.io/anthropicопитуютьapi.minimax.io. Відсутні або неправильно сформовані базові URL-адреси зберігають резерв CN для сумісності. - OpenClaw нормалізує використання coding-plan MiniMax до того самого відображення
% left, яке використовують інші постачальники. Сирі поля MiniMaxusage_percent/usagePercentозначають залишок квоти, а не спожиту квоту, тому OpenClaw інвертує їх. Поля на основі лічильників мають пріоритет, коли вони наявні. - Коли API повертає
model_remains, OpenClaw надає перевагу запису chat-model, за потреби виводить мітку вікна зstart_time/end_timeі додає назву вибраної моделі до мітки плану, щоб вікна coding-plan було легше розрізняти. - Знімки використання трактують
minimax,minimax-cnіminimax-portalяк одну поверхню квоти MiniMax і надають перевагу збереженому OAuth MiniMax перед резервним переходом до змінних середовища ключа Coding Plan.
Примітки
- Model refs відповідають шляху автентифікації:
- Налаштування API-ключа:
minimax/<model> - Налаштування OAuth:
minimax-portal/<model>
- Налаштування API-ключа:
- Типова чат-модель:
MiniMax-M3 - Альтернативні чат-моделі:
MiniMax-M2.7,MiniMax-M2.7-highspeed - Onboarding і пряме налаштування API-ключа записують визначення моделей для M3 та обох варіантів M2.7
- Розуміння зображень використовує медіапостачальника
MiniMax-VL-01, яким володіє plugin - Оновіть значення цін у
models.json, якщо вам потрібне точне відстеження витрат - Використовуйте
openclaw models list, щоб підтвердити поточний ID постачальника, а потім перемкніться за допомогоюopenclaw models set minimax/MiniMax-M3абоopenclaw models set minimax-portal/MiniMax-M3
Див. Постачальники моделей, щоб дізнатися про правила постачальників.
Усунення несправностей
"Невідома модель: minimax/MiniMax-M3"
"Невідома модель: minimax/MiniMax-M3"
Зазвичай це означає, що постачальника MiniMax не налаштовано (немає відповідного запису постачальника й не знайдено профілю автентифікації MiniMax або ключа середовища). Виправлення для цього виявлення є у 2026.1.12. Щоб виправити:
- Оновіться до 2026.1.12 (або запустіть із вихідного коду
main), потім перезапустіть gateway. - Запустіть
openclaw configureі виберіть параметр автентифікації MiniMax, або - Додайте відповідний блок
models.providers.minimaxчиmodels.providers.minimax-portalвручну, або - Задайте
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENабо профіль автентифікації MiniMax, щоб можна було вставити відповідного постачальника.
- Шлях API-ключа:
minimax/MiniMax-M3,minimax/MiniMax-M2.7абоminimax/MiniMax-M2.7-highspeed - Шлях OAuth:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7абоminimax-portal/MiniMax-M2.7-highspeed
Додаткова допомога: Усунення несправностей і FAQ.
Пов’язане
Вибір моделі
Вибір постачальників, model refs і поведінка failover.
Генерація зображень
Спільні параметри інструмента зображень і вибір постачальника.
Генерація музики
Спільні параметри інструмента музики та вибір постачальника.
Генерація відео
Спільні параметри інструмента відео та вибір постачальника.
Пошук MiniMax
Конфігурація вебпошуку через MiniMax Token Plan.
Усунення несправностей
Загальне усунення несправностей і FAQ.