Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

fix(audio): switch default MiniMax endpoint to domestic api.minimaxi.com

hugohe343ffb6a752d8
diff --git a/.env.example b/.env.example
index ac2873dc..eb2c0e5d 100644
--- a/.env.example
+++ b/.env.example
@@ -53,7 +53,8 @@
# IMAGE_BACKEND=minimax
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Override for overseas users / 海外用户覆盖
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
# ─────────────────────────────────────────────────────────────
# Example: Qwen / 通义生图示例
@@ -97,7 +98,8 @@
#
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Override for overseas users / 海外用户覆盖
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
#
# SILICONFLOW_API_KEY=your-siliconflow-key
# SILICONFLOW_MODEL=Qwen/Qwen-Image
@@ -143,7 +145,8 @@
#
# Optional provider-specific TTS endpoint overrides.
# 可选:按提供商覆盖 TTS 接入点。
-# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2
+# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2 # Default China endpoint / 默认国内地址
+# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2 # Optional overseas endpoint / 可选海外地址
# QWEN_TTS_BASE_URL=https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
# COSYVOICE_TTS_BASE_URL=https://dashscope.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer
diff --git a/docs/audio-narration.md b/docs/audio-narration.md
index b2ec6400..3bfae87f 100644
--- a/docs/audio-narration.md
+++ b/docs/audio-narration.md
@@ -58,6 +58,7 @@ python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
# 2C. Or generate MP3s with MiniMax (supports system and cloned voice_id)
export MINIMAX_API_KEY="your-minimax-api-key"
+# Defaults to the China endpoint. For overseas access, set MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2.
python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
--provider minimax \
--voice-id <minimax-voice-id> \
diff --git a/docs/zh/audio-narration.md b/docs/zh/audio-narration.md
index a56f467b..3bcc3898 100644
--- a/docs/zh/audio-narration.md
+++ b/docs/zh/audio-narration.md
@@ -51,6 +51,7 @@ python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
# 2B. 用 MiniMax 生成 MP3(支持系统音色或复刻 voice_id)
export MINIMAX_API_KEY="your-minimax-api-key"
+# 默认使用国内地址;海外访问可设置 MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2
python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
--provider minimax \
--voice-id <minimax-voice-id> \
diff --git a/skills/ppt-master/scripts/tts_backends/backend_minimax.py b/skills/ppt-master/scripts/tts_backends/backend_minimax.py
index 0502c3ab..6c4f1350 100644
--- a/skills/ppt-master/scripts/tts_backends/backend_minimax.py
+++ b/skills/ppt-master/scripts/tts_backends/backend_minimax.py
@@ -9,9 +9,11 @@ from pathlib import Path
from tts_backends.backend_common import extension_from_format, post_json, read_api_key
-DEFAULT_ENDPOINT = "https://api.minimax.io/v1/t2a_v2"
+DEFAULT_ENDPOINT = "https://api.minimaxi.com/v1/t2a_v2"
DEFAULT_MODEL = "speech-2.8-hd"
+# International fallback: set MINIMAX_TTS_BASE_URL=https://api.minimax.io if needed.
+
def output_extension(audio_format: str) -> str:
return extension_from_format(audio_format)
@@ -88,5 +90,4 @@ def generate(
def print_voices() -> None:
print("MiniMax TTS voices are selected by voice_id.")
print("Use a system voice ID or a cloned voice_id from MiniMax Voice Clone.")
- print("Example system voice from MiniMax docs: English_expressive_narrator")
-
+ print("Example domestic system voice from MiniMax docs: male-qn-qingse")
diff --git a/skills/ppt-master/workflows/generate-audio.md b/skills/ppt-master/workflows/generate-audio.md
index fb7fd9a4..23a559f7 100644
--- a/skills/ppt-master/workflows/generate-audio.md
+++ b/skills/ppt-master/workflows/generate-audio.md
@@ -121,6 +121,7 @@ python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
--elevenlabs-model eleven_multilingual_v2
# 1C. Or generate audio with MiniMax
+# Defaults to the China endpoint; set MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2 for overseas access.
python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> \
--provider minimax --voice-id <chosen-voice-id> \
--minimax-model speech-2.8-hd