MiniMax

Paketle gelen minimax Plugin’i iki sağlayıcıya ek olarak yedi yetenek kaydeder: sohbet, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma (T2A v2) ve web araması.

Sağlayıcı kimliği	Kimlik doğrulama	Yetenekler
`minimax`	API anahtarı	Metin, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma, web araması
`minimax-portal`	OAuth	Metin, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma

MiniMax Coding Plan için yönlendirme bağlantısı (%10 indirim): MiniMax Coding Plan

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üntü	Görüntü anlama modeli
`image-01`	Görüntü oluşturma	Metinden görüntüye ve görüntüden görüntüye düzenleme
`music-2.6`	Müzik oluşturma	Varsayılan müzik modeli
`MiniMax-Hailuo-2.3`	Video oluşturma	Metinden videoya ve görüntüden videoya akışlar

Model referansları kimlik doğrulama yolunu izler: API anahtarı kurulumları için minimax/<model>, OAuth kurulumları için minimax-portal/<model>.

Başlarken

OAuth (Coding Plan)
API anahtarı

En uygun kullanım: API anahtarı gerektirmeden OAuth aracılığıyla MiniMax Coding Plan ile hızlı kurulum.

Uluslararası
Çin

İlk kurulumu çalıştırın

openclaw onboard --auth-choice minimax-global-oauth

Elde edilen sağlayıcı temel URL’si: api.minimax.io.

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider minimax-portal

İlk kurulumu çalıştırın

openclaw onboard --auth-choice minimax-cn-oauth

Elde edilen sağlayıcı temel URL’si: api.minimaxi.com.

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider minimax-portal

OAuth kurulumları minimax-portal sağlayıcı kimliğini kullanır. Model referansları minimax-portal/MiniMax-M3 biçimini izler.

En uygun kullanım: Anthropic uyumlu API ile barındırılan MiniMax.

Uluslararası
Çin

İlk kurulumu çalıştırın

openclaw onboard --auth-choice minimax-global-api

Bu, temel URL olarak api.minimax.io değerini yapılandırır.

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider minimax

İlk kurulumu çalıştırın

openclaw onboard --auth-choice minimax-cn-api

Bu, temel URL olarak api.minimaxi.com değerini yapılandırır.

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider minimax

Yapılandırma örneği

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M3",
            name: "MiniMax M3",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
            contextWindow: 1000000,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

MiniMax-M2.x’in Anthropic uyumlu akış uç noktası, yerel Anthropic düşünme blokları yerine OpenAI tarzı delta parçalarında reasoning_content yayar; bu da düşünme örtük olarak etkin bırakılırsa dahili akıl yürütmenin görünür çıktıya sızmasına neden olur. OpenClaw, thinking değerini açıkça kendiniz ayarlamadığınız sürece M2.x düşünmesini varsayılan olarak devre dışı bırakır. MiniMax-M3 (ve ileriye dönük uyumlu M3.x) bundan muaftır: M3, uygun Anthropic düşünme blokları yayar ve görünür içerik üretmek için düşünmenin etkin olmasını gerektirir; bu nedenle OpenClaw, M3’ü sağlayıcının uyarlanabilir düşünme yolunda tutar. Aşağıdaki Gelişmiş yapılandırma bölümünde yer alan Düşünme varsayılanları kısmına bakın.

API anahtarı kurulumları minimax sağlayıcı kimliğini kullanır. Model referansları minimax/MiniMax-M3 biçimini izler.

`openclaw configure` aracılığıyla yapılandırma

Sihirbazı başlatın

openclaw configure

Model/kimlik doğrulamayı seçin

Menüden Model/auth öğesini seçin.

Bir MiniMax kimlik doğrulama seçeneği belirleyin

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ı

Varsayılan modelinizi seçin

İstendiğinde varsayılan modelinizi seçin.

Yetenekler

Görüntü oluşturma

MiniMax Plugin’i, aynı MINIMAX_API_KEY veya OAuth kimlik doğrulamasını metin modelleriyle yeniden kullanarak hem minimax hem de minimax-portal üzerinde image_generate aracı için image-01 modelini kaydeder.

En-boy oranı denetimiyle hem metinden görüntü oluşturma hem de görüntüden görüntüye düzenleme (özne referansı)
İstek başına en fazla 9 çıktı görüntüsü, düzenleme isteği başına 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

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Görüntü oluşturma her zaman MiniMax’in özel görüntü uç noktasını (/v1/image_generation) kullanır ve bu alan bunun yerine sohbet/Anthropic uyumlu temel URL’yi yapılandırdığından models.providers.minimax.baseUrl değerini yok sayar. Görüntü oluşturmayı CN uç noktası üzerinden yönlendirmek için MINIMAX_API_HOST=https://api.minimaxi.com değerini ayarlayın; varsayılan küresel uç nokta https://api.minimax.io değeridir.

Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Görüntü Oluşturma bölümüne bakın.

Metinden konuşmaya

Paketle gelen minimax Plugin’i, tts için MiniMax T2A v2’yi konuşma sağlayıcısı olarak kaydeder.

Varsayılan TTS modeli: speech-2.8-hd
Varsayılan ses: English_expressive_narrator
Paketle gelen model kimlikleri: 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
Kimlik doğrulama çözümleme sırası: tts.providers.minimax.apiKey, ardından minimax-portal OAuth/token kimlik doğrulama profilleri, ardından Token Plan ortam anahtarları (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), ardından MINIMAX_API_KEY
Hiçbir TTS ana makinesi yapılandırılmamışsa OpenClaw, yapılandırılmış minimax-portal OAuth ana makinesini yeniden kullanır ve /anthropic gibi Anthropic uyumlu yol soneklerini kaldırır
Normal ses ekleri MP3 olarak kalır. Sesli not hedefleri (Feishu, Telegram ve sesli not uyumlu bir ek isteyen diğer kanallar), örneğin Feishu/Lark dosya API’si yerel sesli mesajlar için yalnızca file_type: "opus" kabul ettiğinden MiniMax MP3’ten ffmpeg ile 48kHz Opus’a dönüştürülür
MiniMax T2A kesirli speed ve vol değerlerini kabul eder, ancak pitch bir tam sayı olarak gönderilir; OpenClaw, API isteğinden önce kesirli pitch değerlerini keser

Ayar	Ortam değişkeni	Varsayılan	Açıklama
`tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	MiniMax T2A API ana makinesi.
`tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	TTS model kimliği.
`tts.providers.minimax.voiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	Konuşma çıktısı için kullanılan ses kimliği.
`tts.providers.minimax.speed`		`1.0`	Oynatma hızı, `0.5..2.0`.
`tts.providers.minimax.vol`		`1.0`	Ses düzeyi, `(0, 10]`.
`tts.providers.minimax.pitch`		`0`	Tam sayı perde kaydırması, `-12..12`.

Müzik oluşturma

Paketle gelen MiniMax Plugin’i, hem minimax hem de minimax-portal için paylaşılan music_generate aracı üzerinden müzik oluşturmayı kaydeder.

Varsayılan müzik modeli: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
Ayrıca music-2.6-free, music-cover ve music-cover-free desteklenir
İstem denetimleri: lyrics, instrumental
Çıktı biçimi: mp3
Oturum destekli çalıştırmalar, action: "status" dâhil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır

{
  agents: {
    defaults: {
      musicGenerationModel: { primary: "minimax/music-2.6" },
    },
  },
}

Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Müzik Oluşturma bölümüne bakın.

Video oluşturma

Paketle gelen MiniMax Plugin’i, hem minimax hem de minimax-portal için paylaşılan video_generate aracı üzerinden video oluşturmayı kaydeder.

Varsayılan video modeli: minimax/MiniMax-Hailuo-2.3 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
Ayrıca MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live ve I2V-01 desteklenir
Modlar: metinden videoya ve tek görsel referanslı akışlar
resolution desteklenir (Hailuo 2.3/02 modellerinde 768P veya 1080P); aspectRatio desteklenmez ve yok sayılır

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },
    },
  },
}

Ortak araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Video Oluşturma bölümüne bakın.

Görsel anlama

MiniMax Plugin, görsel anlamayı metin kataloğundan ayrı olarak kaydeder:

Sağlayıcı kimliği	Varsayılan görsel modeli	PDF metin çıkarma
`minimax`	`MiniMax-VL-01`	`MiniMax-M2.7`
`minimax-portal`	`MiniMax-VL-01`	`MiniMax-M2.7`

Bu nedenle, paketle birlikte gelen metin sağlayıcısı kataloğu görsel özellikli M3 sohbet referanslarını da içerse bile otomatik medya yönlendirmesi MiniMax görsel anlamayı kullanabilir. PDF anlama, yalnızca metin çıkarma için MiniMax-M2.7 kullanır; MiniMax, PDF’den görsele dönüştürme yolu kaydetmez.

Web araması

MiniMax Plugin ayrıca MiniMax Token Plan arama API’si (/v1/coding_plan/search) üzerinden web_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 değişkeni takma adları: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
Uyumluluk geri dönüşü: zaten bir token planı kimlik bilgisine işaret ediyorsa MINIMAX_API_KEY
Bölgeyi yeniden kullanma sırası: plugins.entries.minimax.config.webSearch.region, ardından MINIMAX_API_HOST, ardından MiniMax sağlayıcısının temel URL’leri
Arama, minimax sağlayıcı kimliğinde kalır; OAuth CN/global kurulumu, models.providers.minimax-portal.baseUrl üzerinden bölgeyi dolaylı olarak yönlendirebilir ve MINIMAX_OAUTH_TOKEN üzerinden bearer kimlik doğrulaması sağlayabilir

Yapılandırma plugins.entries.minimax.config.webSearch.* altında bulunur.

Web aramasının tam yapılandırması ve kullanımı için MiniMax Arama bölümüne bakın.

Gelişmiş yapılandırma

Yapılandırma seçenekleri

Seçenek	Açıklama
`models.providers.minimax.baseUrl`	`https://api.minimax.io/anthropic` tercih edilir (Anthropic uyumlu); OpenAI uyumlu yükler için `https://api.minimax.io/v1` isteğe bağlıdır
`models.providers.minimax.api`	`anthropic-messages` tercih edilir; OpenAI uyumlu yükler için `openai-completions` 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ımlar
`agents.defaults.models`	Model başına takma adlar, parametreler ve meta veriler
`agents.defaults.modelPolicy.allow`	İsteğe bağlı açık model izin listesi
`models.mode`	MiniMax’i yerleşik seçeneklerin yanına eklemek istiyorsanız `merge` değerini koruyun

Düşünme varsayılanları

api: "anthropic-messages" üzerinde, önceki bir sarmalayıcı yükteki thinking alanını önceden ayarlamadığı sürece OpenClaw, MiniMax M2.x modelleri için thinking: { type: "disabled" } ekler. Bu, M2.x’in akış uç noktasının OpenAI tarzı delta parçalarında reasoning_content yayımlamasını önleyerek dahili akıl yürütmenin görünür çıktıya sızmasını engeller.MiniMax-M3 (ve M3.x) muaftır: düşünme devre dışı bırakıldığında M3, stop_reason: "end_turn" ile boş bir content dizisi döndürür; bu nedenle OpenClaw, M3 için örtük devre dışı varsayılanını kaldırır ve bir düşünme düzeyi ayarlandığında bunun yerine thinking: { type: "adaptive" } değerini zorunlu kılar.Model ailesine göre kullanılabilir düşünme düzeyleri:

Model ailesi	Düzeyler	Varsayılan
`MiniMax-M3`	`off`, `adaptive`	`adaptive`
`MiniMax-M2.x`	`off`, `minimal`, `low`, `medium`, `high`	`off`

Hızlı mod

/fast on veya params.fastMode: true, Anthropic uyumlu akış yolunda (api: "anthropic-messages", sağlayıcı minimax veya minimax-portal) MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.

Geri dönüş örneği

En uygun kullanım: En güçlü son nesil modelinizi birincil olarak kullanın, başarısızlık durumunda MiniMax M2.7’ye geçin. Aşağıdaki örnekte somut bir birincil model olarak Opus kullanılır; bunu tercih ettiğiniz son nesil birincil modelle değiştirin.

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "primary" },
        "minimax/MiniMax-M2.7": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
    },
  },
}

Coding Plan kullanım ayrıntıları

Coding Plan kullanım API’si: https://api.minimaxi.com/v1/token_plan/remains veya https://api.minimax.io/v1/token_plan/remains (bir coding plan anahtarı gerektirir).
Kullanım yoklaması, yapılandırıldığında ana bilgisayarı models.providers.minimax-portal.baseUrl veya models.providers.minimax.baseUrl üzerinden türetir; böylece https://api.minimax.io/anthropic kullanan global kurulumlar api.minimax.io adresini yoklar. Eksik veya hatalı biçimlendirilmiş temel URL’ler, uyumluluk amacıyla CN geri dönüşünü korur.
OpenClaw, MiniMax coding plan kullanımını diğer sağlayıcıların kullandığı % left görünümüyle aynı biçime normalleştirir. MiniMax’in ham usage_percent / usagePercent alanları tüketilen değil, kalan kotayı gösterir; bu nedenle OpenClaw bunları tersine çevirir. Mevcut olduklarında sayı tabanlı alanlar önceliklidir.
API, model_remains döndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketini start_time / end_time üzerinden türetir ve coding plan pencerelerinin daha kolay ayırt edilebilmesi için seçilen model adını plan etiketine ekler.
Kullanım anlık görüntüleri minimax, minimax-cn, minimax-portal ve minimax-portal-cn değerlerini aynı MiniMax kota yüzeyi olarak ele alır ve Coding Plan anahtarı ortam değişkenlerine geri dönmeden önce depolanmış MiniMax OAuth’u tercih eder.

Notlar

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 çeşidi için model tanımları yazar
Görsel anlama, Plugin’e ait MiniMax-VL-01 medya sağlayıcısını kullanır
Kesin maliyet takibi gerekiyorsa models.json içindeki fiyatlandırma değerlerini güncelleyin
Geçerli sağlayıcı kimliğini doğrulamak için openclaw models list kullanın, ardından openclaw models set minimax/MiniMax-M3 veya openclaw models set minimax-portal/MiniMax-M3 ile geçiş yapın

Sağlayıcı kuralları için Model sağlayıcıları bölümüne bakın.

Sorun giderme

"Bilinmeyen model: minimax/MiniMax-M3"

Bu genellikle MiniMax sağlayıcısının yapılandırılmadığı anlamına gelir (eşleşen bir sağlayıcı girdisi ve MiniMax kimlik doğrulama profili/ortam anahtarı bulunamadı). Çözüm için:

openclaw configure komutunu çalıştırıp bir MiniMax kimlik doğrulama seçeneği belirleyin veya
Eşleşen models.providers.minimax ya da models.providers.minimax-portal bloğunu elle ekleyin veya
Eşleşen sağlayıcının eklenebilmesi için MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN veya bir MiniMax kimlik doğrulama profili ayarlayın.

Model kimliğinin büyük/küçük harfe duyarlı olduğundan emin olun:

API anahtarı yolu: minimax/MiniMax-M3, minimax/MiniMax-M2.7 veya minimax/MiniMax-M2.7-highspeed
OAuth yolu: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 veya minimax-portal/MiniMax-M2.7-highspeed

Ardından şu komutla yeniden kontrol edin:

openclaw models list

Daha fazla yardım: Sorun giderme ve SSS.

İlgili içerikler

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Görsel oluşturma

Ortak görsel aracı parametreleri ve sağlayıcı seçimi.

Müzik oluşturma

Ortak müzik aracı parametreleri ve sağlayıcı seçimi.

Video oluşturma

Ortak video aracı parametreleri ve sağlayıcı seçimi.

MiniMax Arama

MiniMax Token Plan üzerinden web araması yapılandırması.

Sorun giderme

Genel sorun giderme ve SSS.

Overview

Concepts and configuration

Providers

Yerleşik katalog

Başlarken

Yapılandırma örneği

`openclaw configure` aracılığıyla yapılandırma

Yetenekler

Görüntü oluşturma

Metinden konuşmaya

Müzik oluşturma

Video oluşturma

Görsel anlama

Web araması

Gelişmiş yapılandırma

Notlar

Sorun giderme

İlgili içerikler

Model seçimi

Görsel oluşturma

Müzik oluşturma

Video oluşturma

MiniMax Arama

Sorun giderme

​Yerleşik katalog

​Başlarken

​Yapılandırma örneği

​openclaw configure aracılığıyla yapılandırma

​Yetenekler

​Görüntü oluşturma

​Metinden konuşmaya

​Müzik oluşturma

​Video oluşturma

​Görsel anlama

​Web araması

​Gelişmiş yapılandırma

​Notlar

​Sorun giderme

​İlgili içerikler

Model seçimi

Görsel oluşturma

Müzik oluşturma

Video oluşturma

MiniMax Arama

Sorun giderme

Yerleşik katalog

Başlarken

Yapılandırma örneği

`openclaw configure` aracılığıyla yapılandırma

Yetenekler

Görüntü oluşturma

Metinden konuşmaya

Müzik oluşturma

Video oluşturma

Görsel anlama

Web araması

Gelişmiş yapılandırma

Notlar

Sorun giderme

İlgili içerikler