MiniMax

​

기본 제공 카탈로그

​

시작하기

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider minimax

{
  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,
          },
        ],
      },
    },
  },
}

​

openclaw configure로 구성

openclaw configure

​

기능

​

이미지 생성

• 텍스트-이미지 생성 및 이미지-이미지 편집(피사체 참조), 둘 다 종횡비 제어 지원
• 요청당 최대 9개의 출력 이미지, 편집 요청당 1개의 참조 이미지
• 지원되는 종횡비: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

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

​

텍스트 음성 변환

• 기본 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, speech-01-240228
• 인증 확인 순서: messages.tts.providers.minimax.apiKey, 그다음 minimax-portal OAuth/토큰 인증 프로필, 그다음 Token Plan 환경 키(MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), 마지막으로 MINIMAX_API_KEY
• TTS 호스트가 구성되지 않은 경우 OpenClaw는 구성된 minimax-portal OAuth 호스트를 재사용하고 /anthropic과 같은 Anthropic 호환 경로 접미사를 제거합니다.
• 일반 오디오 첨부 파일은 MP3로 유지됩니다. 음성 메시지 호환 첨부 파일을 요청하는 대상(Feishu, Telegram 및 기타 채널)은 ffmpeg를 사용하여 MiniMax MP3를 48kHz Opus로 트랜스코딩합니다. 예를 들어 Feishu/Lark 파일 API는 네이티브 오디오 메시지에 file_type: "opus"만 허용하기 때문입니다.
• MiniMax T2A는 소수점 speed와 vol을 허용하지만 pitch는 정수로 전송됩니다. OpenClaw는 API 요청 전에 소수점 pitch 값을 버림 처리합니다.

​

음악 생성

• 기본 음악 모델: minimax/music-2.6(OAuth: minimax-portal/music-2.6)
• music-2.6-free, music-cover, music-cover-free도 지원
• 프롬프트 제어 항목: lyrics, instrumental
• 출력 형식: mp3
• 세션 기반 실행은 action: "status"를 포함한 공통 작업/상태 흐름을 통해 분리됩니다.

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

​

동영상 생성

• 기본 동영상 모델: minimax/MiniMax-Hailuo-2.3(OAuth: minimax-portal/MiniMax-Hailuo-2.3)
• MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01도 지원
• 모드: 텍스트-동영상 및 단일 이미지 참조 흐름
• resolution 지원(Hailuo 2.3/02 모델에서 768P 또는 1080P), aspectRatio`는 지원되지 않으며 무시됩니다. OC_I18N_900012

​

이미지 이해

​

웹 검색

• 제공자 ID: minimax
• 구조화된 결과: 제목, URL, 스니펫, 관련 검색어
• 권장 환경 변수: MINIMAX_CODE_PLAN_KEY
• 허용되는 환경 변수 별칭: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• 호환성 대체 경로: 이미 토큰 플랜 자격 증명을 가리키는 경우 MINIMAX_API_KEY
• 리전 재사용 순서: plugins.entries.minimax.config.webSearch.region, MINIMAX_API_HOST, MiniMax 제공자 기본 URL
• 검색은 제공자 ID minimax를 유지합니다. OAuth 중국/글로벌 설정은 models.providers.minimax-portal.baseUrl을 통해 간접적으로 리전을 지정할 수 있으며, MINIMAX_OAUTH_TOKEN을 통해 베어러 인증을 제공할 수 있습니다.

​

고급 구성

​

참고 사항

• 기본 채팅 모델: MiniMax-M3. 대체 채팅 모델: MiniMax-M2.7, MiniMax-M2.7-highspeed
• 온보딩 및 직접 API 키 설정은 M3와 두 M2.7 변형의 모델 정의를 기록합니다.
• 이미지 이해에는 Plugin이 소유한 MiniMax-VL-01 미디어 제공자를 사용합니다.
• 정확한 비용 추적이 필요하면 models.json의 가격 값을 업데이트하세요.
• openclaw models list를 사용하여 현재 제공자 ID를 확인한 다음, openclaw models set minimax/MiniMax-M3 또는 openclaw models set minimax-portal/MiniMax-M3로 전환하세요.

​

문제 해결

openclaw models list

​

관련 항목