MiniMax MCP

ทางการ

โต้ตอบกับ API อันทรงพลังของ MiniMax สำหรับ Text-to-Speech การสร้างรูปภาพ และวิดีโอ

คุณทำอะไรได้บ้างด้วย MiniMax MCP?

  • แปลงข้อความเป็นเสียงพูด — ขอให้ผู้ช่วยแปลงข้อความที่เขียนเป็นเสียงโดยใช้เสียงที่ระบุ
  • โคลนเสียง — โคลนเสียงจากไฟล์เสียงที่คุณให้มา แล้วนำไปใช้สร้างเสียงพูดได้อีก
  • ออกแบบเสียง — สร้างเสียงแบบกำหนดเองจากพรอมป์ต์คำบรรยาย พร้อมเสียงตัวอย่าง
  • สร้างและแก้ไขภาพ — สร้างภาพจากพรอมป์ต์ในพื้นที่ 1K/2K/4K หรือแก้ไขภาพโดยใช้พรอมป์ต์และภาพอ้างอิงได้สูงสุด 16 ภาพ
  • สร้างวิดีโอ — สร้างวิดีโอจากพรอมป์ต์ พร้อมตัวเลือกระยะเวลาและความละเอียด และสอบถามผลลัพธ์ของงานภายหลังได้

เอกสาร

export

เซิร์ฟเวอร์ MiniMax Model Context Protocol (MCP) อย่างเป็นทางการ ซึ่งช่วยให้โต้ตอบกับ API สำหรับแปลงข้อความเป็นเสียงและสร้างวิดีโอ/รูปภาพอันทรงพลังได้ เซิร์ฟเวอร์นี้ช่วยให้ไคลเอ็นต์ MCP เช่น Claude Desktop, Cursor, Windsurf, OpenAI Agents และอื่น ๆ สามารถสร้างเสียง โคลนเสียง สร้างวิดีโอ สร้างรูปภาพ และทำสิ่งอื่น ๆ ได้

💡 แนะนำ: MiniMax CLI (mmx-cli) — เครื่องมือบรรทัดคำสั่งอย่างเป็นทางการของเราที่มาพร้อมโมเดลล่าสุดและฟีเจอร์เพิ่มเติม เช่น ข้อความ วิชัน และการค้นหา ใช้งานเป็นทักษะของเอเจนต์ AI สำหรับ Claude Code, Cursor, OpenClaw และอื่น ๆ ได้

เอกสารประกอบ

เริ่มต้นใช้งานอย่างรวดเร็วด้วยไคลเอ็นต์ MCP

  1. รับคีย์ API จาก MiniMax
  2. ติดตั้ง uv (ตัวจัดการแพ็กเกจ Python) โดยติดตั้งด้วย curl -LsSf https://astral.sh/uv/install.sh | sh หรือดู uv repo สำหรับวิธีติดตั้งเพิ่มเติม
  3. สำคัญ: โฮสต์ API และคีย์จะแตกต่างกันตามภูมิภาคและต้องตรงกัน มิฉะนั้นจะพบข้อผิดพลาด Invalid API key
ภูมิภาคทั่วโลกจีนแผ่นดินใหญ่
MINIMAX_API_KEYรับได้จาก MiniMax Globalรับได้จาก MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

ไปที่ Claude > Settings > Developer > Edit Config > claude_desktop_config.json เพื่อเพิ่มรายการต่อไปนี้:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ คำเตือน: คีย์ API ต้องตรงกับโฮสต์ หากเกิดข้อผิดพลาด "API Error: invalid api key" โปรดตรวจสอบโฮสต์ API ของคุณ:

  • โฮสต์ทั่วโลก:https://api.minimax.io
  • โฮสต์จีนแผ่นดินใหญ่:https://api.minimaxi.com

หากใช้ Windows คุณต้องเปิดใช้งาน "Developer Mode" ใน Claude Desktop เพื่อใช้เซิร์ฟเวอร์ MCP คลิก "Help" ในเมนูแฮมเบอร์เกอร์ที่มุมซ้ายบน แล้วเลือก "Enable Developer Mode"

Cursor

ไปที่ Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server เพื่อเพิ่มการกำหนดค่าด้านบน

เท่านี้ก็เรียบร้อย ไคลเอ็นต์ MCP ของคุณสามารถโต้ตอบกับ MiniMax ผ่านเครื่องมือเหล่านี้ได้แล้ว:

การขนส่ง

รองรับการขนส่งสองประเภท ได้แก่ stdio และ sse

stdioSSE
เรียกใช้ในเครื่องปรับใช้ในเครื่องหรือบนคลาวด์ได้
สื่อสารผ่าน stdoutสื่อสารผ่าน network
อินพุต: รองรับการประมวลผลทรัพยากร local files หรือ URL ที่ถูกต้องอินพุต: เมื่อติดตั้งใช้งานบนคลาวด์ แนะนำให้ใช้ URL สำหรับอินพุต

เครื่องมือที่พร้อมใช้งาน

เครื่องมือคำอธิบาย
text_to_audioแปลงข้อความเป็นเสียงด้วยเสียงที่กำหนด
list_voicesแสดงรายการเสียงทั้งหมดที่พร้อมใช้งาน
voice_cloneโคลนเสียงโดยใช้ไฟล์เสียงที่ระบุ
generate_videoสร้างวิดีโอจากพรอมป์ต์
text_to_imageสร้างรูปภาพจากพรอมป์ต์ ค่าเริ่มต้นคือ MiniMax-H3-Image (รองรับ area 1K/2K/4K และ size); ยังใช้ image-01 ได้ผ่าน model
image_editแก้ไขรูปภาพด้วย MiniMax-H3-Image โดยใช้พรอมป์ต์และรูปภาพอ้างอิง 1-16 รูป
query_video_generationสอบถามผลลัพธ์ของงานสร้างวิดีโอ
voice_designสร้างเสียงจากพรอมป์ต์โดยใช้ข้อความตัวอย่าง

บันทึกการเผยแพร่

10 พฤศจิกายน 2026

🆕 มีอะไรใหม่

  • การแก้ไขรูปภาพ: เครื่องมือ image_edit ใหม่ — แก้ไขรูปภาพด้วย MiniMax-H3-Image โดยใช้พรอมป์ต์และรูปภาพอ้างอิง 1-16 รูป (URL, data URI, mm_file:// หรือพาธในเครื่อง)
  • การสร้างรูปภาพด้วย H3: text_to_image ใช้ MiniMax-H3-Image เป็นค่าเริ่มต้น และรองรับ area (1K/2K/4K) และ size; ยังคงใช้ image-01 ได้ผ่านพารามิเตอร์ model

📈 เครื่องมือที่ปรับปรุงแล้ว

  • text_to_image - ใช้ MiniMax-H3-Image (/v1/images/generations) เป็นค่าเริ่มต้น; ระบุ model="image-01" เพื่อใช้โมเดลก่อนหน้า

2 กรกฎาคม 2025

🆕 มีอะไรใหม่

  • การออกแบบเสียง: เครื่องมือ voice_design ใหม่ - สร้างเสียงแบบกำหนดเองจากพรอมป์ต์คำอธิบาย พร้อมเสียงตัวอย่าง
  • การปรับปรุงวิดีโอ: เพิ่มโมเดล MiniMax-Hailuo-02 ที่ให้คุณภาพคมชัดเป็นพิเศษ พร้อมตัวควบคุมระยะเวลา/ความละเอียด

📈 เครื่องมือที่ปรับปรุงแล้ว

  • voice_design - สร้างเสียงเฉพาะบุคคลจากคำอธิบายข้อความ
  • generate_video - รองรับ MiniMax-Hailuo-02 แล้ว พร้อมตัวเลือกระยะเวลา 6s/10s และความละเอียด 768P/1080P

คำถามที่พบบ่อย

1. invalid api key

โปรดตรวจสอบให้แน่ใจว่าคีย์ API และโฮสต์ API ของคุณตรงกันตามภูมิภาค

ภูมิภาคทั่วโลกจีนแผ่นดินใหญ่
MINIMAX_API_KEYรับได้จาก MiniMax Globalรับได้จาก MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

โปรดยืนยันพาธแบบสัมบูรณ์โดยเรียกใช้คำสั่งนี้ในเทอร์มินัล:

which uvx

เมื่อได้พาธแบบสัมบูรณ์แล้ว (เช่น /usr/local/bin/uvx) ให้อัปเดตการกำหนดค่าเพื่อใช้พาธนั้น (เช่น "command": "/usr/local/bin/uvx")

3. วิธีใช้ generate_video ใน async-mode

กำหนดกฎการทำงานให้เสร็จก่อนเริ่มต้น: หรือจะกำหนดค่ากฎเหล่านี้ในการตั้งค่า IDE (เช่น Cursor) ก็ได้:

ตัวอย่างการใช้งาน

⚠️ คำเตือน: การใช้เครื่องมือเหล่านี้อาจมีค่าใช้จ่าย

1. อ่านข่าวภาคค่ำช่วงหนึ่ง

2. โคลนเสียง

3. สร้างวิดีโอ

4. สร้างรูปภาพ