- T2A v2 ile paketlenmiş konuşma sentezi
MiniMax-VL-01ile paketlenmiş görüntü anlamamusic-2.6ile paketlenmiş müzik üretimi- MiniMax Token Plan arama API’si üzerinden paketlenmiş
web_search
| Sağlayıcı ID’si | Kimlik doğrulama | Yetenekler |
|---|---|---|
minimax | API anahtarı | Metin, görüntü üretimi, müzik üretimi, video üretimi, görüntü anlama, konuşma, web araması |
minimax-portal | OAuth | Metin, görüntü üretimi, müzik üretimi, video üretimi, görüntü anlama, konuşma |
Yerleşik katalog
| Model | Tür | Açıklama |
|---|---|---|
MiniMax-M3 | Sohbet (akıl yürütme) | Varsayılan barındırılan akıl yürütme modeli |
MiniMax-M2.7 | Sohbet (akıl yürütme) | Önceki barındırılan akıl yürütme modeli |
MiniMax-M2.7-highspeed | Sohbet (akıl yürütme) | Daha hızlı M2.7 akıl yürütme katmanı |
MiniMax-VL-01 | Görü | Görüntü anlama modeli |
image-01 | Görüntü üretimi | Metinden görüntü ve görüntüden görüntü düzenleme |
music-2.6 | Müzik üretimi | Varsayılan müzik modeli |
music-2.5 | Müzik üretimi | Önceki müzik üretimi katmanı |
music-2.0 | Müzik üretimi | Eski müzik üretimi katmanı |
MiniMax-Hailuo-2.3 | Video üretimi | Metinden videoya ve görüntü referansı akışları |
Başlarken
Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.- OAuth (Coding Plan)
- API key
En uygun olduğu durum: API anahtarı gerektirmeden OAuth üzerinden MiniMax Coding Plan ile hızlı kurulum.
- International
- China
OAuth kurulumları
minimax-portal sağlayıcı id’sini kullanır. Model referansları minimax-portal/MiniMax-M3 biçimini izler.openclaw configure ile yapılandırma
JSON düzenlemeden MiniMax’i ayarlamak için etkileşimli yapılandırma sihirbazını kullanın:
Choose a MiniMax auth option
Kullanılabilir MiniMax seçeneklerinden birini seçin:
| Kimlik doğrulama seçimi | Açıklama |
|---|---|
minimax-global-oauth | Uluslararası OAuth (Coding Plan) |
minimax-cn-oauth | Çin OAuth (Coding Plan) |
minimax-global-api | Uluslararası API anahtarı |
minimax-cn-api | Çin API anahtarı |
Yetenekler
Görüntü üretimi
MiniMax Plugin’i,image_generate aracı için image-01 modelini kaydeder. Şunları destekler:
- En boy oranı denetimiyle metinden görüntü üretimi
- En boy oranı denetimiyle görüntüden görüntü düzenleme (konu referansı)
- İstek başına en fazla 9 çıktı görüntüsü
- Düzenleme isteği başına en fazla 1 referans görüntüsü
- Desteklenen en boy oranları:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
MINIMAX_API_KEY veya OAuth kimlik doğrulamasını kullanır. MiniMax zaten ayarlanmışsa ek yapılandırma gerekmez.
Hem minimax hem de minimax-portal, aynı image-01 modeliyle image_generate kaydeder. API anahtarı kurulumları MINIMAX_API_KEY kullanır; OAuth kurulumları bunun yerine paketlenmiş minimax-portal kimlik doğrulama yolunu kullanabilir.
Görüntü üretimi her zaman MiniMax’in özel görüntü uç noktasını (/v1/image_generation) kullanır ve models.providers.minimax.baseUrl değerini yok sayar; çünkü bu alan sohbet/Anthropic uyumlu temel URL’yi yapılandırır. Görüntü üretimini CN uç noktası üzerinden yönlendirmek için MINIMAX_API_HOST=https://api.minimaxi.com ayarlayın; varsayılan küresel uç nokta https://api.minimax.io adresidir.
Onboarding veya API anahtarı kurulumu açık models.providers.minimax girdileri yazdığında OpenClaw, MiniMax-M3, MiniMax-M2.7 ve MiniMax-M2.7-highspeed modellerini sohbet modelleri olarak somutlaştırır. M3, metin ve görüntü girdisi sunduğunu bildirir; görüntü anlama, Plugin’e ait MiniMax-VL-01 medya sağlayıcısı üzerinden ayrı olarak sunulmaya devam eder.
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için bkz. Görüntü Üretimi.
Metinden konuşmaya
Paketlenmişminimax Plugin’i, MiniMax T2A v2’yi messages.tts için bir konuşma sağlayıcısı olarak kaydeder.
- Varsayılan TTS modeli:
speech-2.8-hd - Varsayılan ses:
English_expressive_narrator - Desteklenen paketlenmiş model id’leri arasında
speech-2.8-hd,speech-2.8-turbo,speech-2.6-hd,speech-2.6-turbo,speech-02-hd,speech-02-turbo,speech-01-hdvespeech-01-turbobulunur. - Kimlik doğrulama çözümleme sırası:
messages.tts.providers.minimax.apiKey, ardındanminimax-portalOAuth/belirteç kimlik doğrulama profilleri, ardından Token Plan ortam anahtarları (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), ardındanMINIMAX_API_KEY. - TTS ana makinesi yapılandırılmamışsa OpenClaw, yapılandırılmış
minimax-portalOAuth ana makinesini yeniden kullanır ve/anthropicgibi Anthropic uyumlu yol soneklerini çıkarır. - Normal ses ekleri MP3 olarak kalır.
- Feishu ve Telegram gibi sesli not hedefleri, MiniMax MP3’ten
ffmpegile 48 kHz Opus’a dönüştürülür; çünkü Feishu/Lark dosya API’si yerel ses iletileri için yalnızcafile_type: "opus"kabul eder. - MiniMax T2A kesirli
speedvevoldeğerlerini kabul eder, ancakpitchtam sayı olarak gönderilir; OpenClaw, API isteğinden önce kesirlipitchdeğerlerini keser.
| Ayar | Ortam değişkeni | Varsayılan | Açıklama |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | MiniMax T2A API ana makinesi. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | TTS model id’si. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | Konuşma çıktısı için kullanılan ses id’si. |
messages.tts.providers.minimax.speed | 1.0 | Oynatma hızı, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Ses düzeyi, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Tam sayı perde kaydırması, -12..12. |
Müzik üretimi
Paketlenmiş MiniMax Plugin’i, hemminimax hem de minimax-portal için paylaşılan music_generate aracı üzerinden müzik üretimini kaydeder.
- Varsayılan müzik modeli:
minimax/music-2.6 - OAuth müzik modeli:
minimax-portal/music-2.6 minimax/music-2.5veminimax/music-2.0da desteklenir- İstem denetimleri:
lyrics,instrumental - Çıktı biçimi:
mp3 - Oturum destekli çalıştırmalar,
action: "status"dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devri davranışı için bkz. Müzik Üretimi.
Video üretimi
Paketle birlikte gelen MiniMax Plugin, hemminimax hem de minimax-portal için paylaşılan
video_generate aracı üzerinden video üretimini kaydeder.
- Varsayılan video modeli:
minimax/MiniMax-Hailuo-2.3 - OAuth video modeli:
minimax-portal/MiniMax-Hailuo-2.3 - Modlar: metinden videoya ve tek görsel referans akışları
aspectRatioveresolutiondesteklenir
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devri davranışı için bkz. Video Üretimi.
Görsel anlama
MiniMax Plugin, görsel anlamayı metin kataloğundan ayrı olarak kaydeder:| Sağlayıcı Kimliği | Varsayılan görsel modeli |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Web arama
MiniMax Plugin ayrıca MiniMax Token Plan arama API’si üzerindenweb_search kaydeder.
- Sağlayıcı kimliği:
minimax - Yapılandırılmış sonuçlar: başlıklar, URL’ler, parçacıklar, ilgili sorgular
- Tercih edilen ortam değişkeni:
MINIMAX_CODE_PLAN_KEY - Kabul edilen ortam takma adları:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Uyumluluk geri dönüşü: zaten bir token-plan kimlik bilgisine işaret ettiğinde
MINIMAX_API_KEY - Bölge yeniden kullanımı:
plugins.entries.minimax.config.webSearch.region, ardındanMINIMAX_API_HOST, ardından MiniMax sağlayıcı temel URL’leri - Arama
minimaxsağlayıcı kimliğinde kalır; OAuth CN/global kurulumu bölgeyi dolaylı olarakmodels.providers.minimax-portal.baseUrlüzerinden yönlendirebilir veMINIMAX_OAUTH_TOKENüzerinden bearer auth sağlayabilir
plugins.entries.minimax.config.webSearch.* altında bulunur.
Tam web arama yapılandırması ve kullanımı için bkz. MiniMax Arama.
Gelişmiş yapılandırma
Yapılandırma seçenekleri
Yapılandırma seçenekleri
| Seçenek | Açıklama |
|---|---|
models.providers.minimax.baseUrl | https://api.minimax.io/anthropic tercih edin (Anthropic uyumlu); https://api.minimax.io/v1 OpenAI uyumlu payload’lar için isteğe bağlıdır |
models.providers.minimax.api | anthropic-messages tercih edin; openai-completions OpenAI uyumlu payload’lar için isteğe bağlıdır |
models.providers.minimax.apiKey | MiniMax API anahtarı (MINIMAX_API_KEY) |
models.providers.minimax.models | id, name, reasoning, contextWindow, maxTokens, cost tanımlayın |
agents.defaults.models | İzin listesinde istediğiniz modeller için takma ad tanımlayın |
models.mode | MiniMax’i yerleşiklerle birlikte eklemek istiyorsanız merge olarak tutun |
Thinking varsayılanları
Thinking varsayılanları
api: "anthropic-messages" üzerinde, düşünme params/config içinde zaten açıkça ayarlanmadıkça OpenClaw MiniMax M2.x modelleri için thinking: { type: "disabled" } enjekte eder.Bu, M2.x’in akış endpoint’inin OpenAI tarzı delta parçalarında reasoning_content yaymasını önler; aksi takdirde iç akıl yürütme görünür çıktıya sızardı.MiniMax-M3 (ve M3.x) muaftır: M3 uygun Anthropic thinking blokları yayar ve thinking devre dışıyken stop_reason: "end_turn" ile boş bir content dizisi döndürür; bu nedenle wrapper M3’ü sağlayıcının atlanmış/uyarlanabilir thinking yolunda tutar.Hızlı mod
Hızlı mod
/fast on veya params.fastMode: true, Anthropic uyumlu stream yolunda MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.Geri dönüş örneği
Geri dönüş örneği
En uygun olduğu durum: en güçlü son nesil modelinizi birincil olarak tutup MiniMax M2.7’ye yük devri yapın. Aşağıdaki örnek Opus’u somut bir birincil olarak kullanır; tercih ettiğiniz son nesil birincil modelle değiştirin.
Coding Plan kullanım ayrıntıları
Coding Plan kullanım ayrıntıları
- Coding Plan kullanım API’si:
https://api.minimaxi.com/v1/token_plan/remainsveyahttps://api.minimax.io/v1/token_plan/remains(bir coding plan anahtarı gerektirir). - Kullanım yoklaması, yapılandırılmışsa host’u
models.providers.minimax-portal.baseUrlveyamodels.providers.minimax.baseUrlüzerinden türetir; bu nedenlehttps://api.minimax.io/anthropickullanan global kurulumlarapi.minimax.ioiçin yoklama yapar. Eksik veya hatalı biçimlendirilmiş temel URL’ler uyumluluk için CN geri dönüşünü korur. - OpenClaw, MiniMax coding-plan kullanımını diğer sağlayıcılar tarafından kullanılan aynı
% kalangösterimine normalleştirir. MiniMax’in hamusage_percent/usagePercentalanları tüketilen kota değil, kalan kotadır; bu nedenle OpenClaw bunları tersine çevirir. Sayı tabanlı alanlar mevcut olduğunda önceliklidir. - API
model_remainsdöndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketinistart_time/end_timeüzerinden türetir ve coding-plan pencerelerinin daha kolay ayırt edilebilmesi için seçilen model adını plan etiketine dahil eder. - Kullanım anlık görüntüleri
minimax,minimax-cnveminimax-portaldeğerlerini aynı MiniMax kota yüzeyi olarak ele alır ve Coding Plan anahtarı ortam değişkenlerine geri dönmeden önce depolanan MiniMax OAuth’u tercih eder.
Notlar
- Model referansları auth yolunu izler:
- API anahtarı kurulumu:
minimax/<model> - OAuth kurulumu:
minimax-portal/<model>
- API anahtarı kurulumu:
- Varsayılan sohbet modeli:
MiniMax-M3 - Alternatif sohbet modelleri:
MiniMax-M2.7,MiniMax-M2.7-highspeed - İlk katılım ve doğrudan API anahtarı kurulumu M3 ve her iki M2.7 varyantı için model tanımları yazar
- Görsel anlama, Plugin’e ait
MiniMax-VL-01medya sağlayıcısını kullanır - Kesin maliyet takibine ihtiyacınız varsa
models.jsoniçindeki fiyatlandırma değerlerini güncelleyin - Geçerli sağlayıcı kimliğini doğrulamak için
openclaw models listkullanın, ardındanopenclaw models set minimax/MiniMax-M3veyaopenclaw models set minimax-portal/MiniMax-M3ile geçiş yapın
Sağlayıcı kuralları için bkz. Model sağlayıcıları.
Sorun giderme
"Bilinmeyen model: minimax/MiniMax-M3"
"Bilinmeyen model: minimax/MiniMax-M3"
Bu genellikle MiniMax sağlayıcısının yapılandırılmadığı anlamına gelir (eşleşen sağlayıcı girdisi yoktur ve MiniMax auth profili/ortam anahtarı bulunmamıştır). Bu algılama için bir düzeltme 2026.1.12 sürümündedir. Düzeltmek için:
- 2026.1.12 sürümüne yükseltin (veya kaynak
mainüzerinden çalıştırın), ardından Gateway’i yeniden başlatın. openclaw configureçalıştırıp bir MiniMax auth seçeneği belirleyin veya- Eşleşen
models.providers.minimaxya damodels.providers.minimax-portalbloğunu elle ekleyin veya - Eşleşen sağlayıcının enjekte edilebilmesi için
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENya da bir MiniMax auth profili ayarlayın.
- API anahtarı yolu:
minimax/MiniMax-M3,minimax/MiniMax-M2.7veyaminimax/MiniMax-M2.7-highspeed - OAuth yolu:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7veyaminimax-portal/MiniMax-M2.7-highspeed
Daha fazla yardım: Sorun Giderme ve SSS.
İlgili
Model seçimi
Sağlayıcıları, model referanslarını ve yük devri davranışını seçme.
Görsel üretimi
Paylaşılan görsel aracı parametreleri ve sağlayıcı seçimi.
Müzik üretimi
Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.
Video üretimi
Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.
MiniMax Arama
MiniMax Token Plan üzerinden web arama yapılandırması.
Sorun giderme
Genel sorun giderme ve SSS.