feat: add 'mmx help' command + align all --help with official API docs

- New 'mmx help' command lists all official MiniMax API documentation links
- Speech synthesize: model list expanded to 8 models (hd/turbo variants for 2.8/2.6/02/01)
- Video generate: description updated with T2V/I2V/S2V model breakdown
- Image generate: added image-01-live model
- Text chat: model list expanded to all 7 models (M2.7, M2.7-highspeed, M2.5, M2.5-highspeed, M2.1, M2, Text-01)
- API doc URLs corrected: speech-t2a-http, image-generation-t2i, text-post

Author: Raylan LIN

src/commands/help.ts

@@ -0,0 +1,41 @@
+import { defineCommand } from '../command';
+import type { Config } from '../config/schema';
+import type { GlobalFlags } from '../types/flags';
+
+interface ApiRef {
+  command: string;
+  title: string;
+  url: string;
+}
+
+const API_REFS: ApiRef[] = [
+  { command: 'mmx text chat',            title: 'Text Generation (Chat Completion)',    url: 'https://platform.minimax.io/docs/api-reference/text-post' },
+  { command: 'mmx speech synthesize',    title: 'Speech T2A (Text-to-Audio)',           url: 'https://platform.minimax.io/docs/api-reference/speech-t2a-http' },
+  { command: 'mmx speech clone',         title: 'Voice Clone',                          url: 'https://platform.minimax.io/docs/api-reference/speech-voice-clone-http' },
+  { command: 'mmx speech design',        title: 'Voice Design',                         url: 'https://platform.minimax.io/docs/api-reference/speech-voice-design-http' },
+  { command: 'mmx image generate',       title: 'Image Generation (T2I / I2I)',         url: 'https://platform.minimax.io/docs/api-reference/image-generation-t2i' },
+  { command: 'mmx video generate',       title: 'Video Generation (T2V / I2V / S2V)',   url: 'https://platform.minimax.io/docs/api-reference/video-generation' },
+  { command: 'mmx music generate',       title: 'Music Generation',                     url: 'https://platform.minimax.io/docs/api-reference/music-generation' },
+  { command: 'mmx music cover',          title: 'Music Cover (via Music Generation)',   url: 'https://platform.minimax.io/docs/api-reference/music-generation' },
+  { command: 'mmx search query',         title: 'Web Search',                           url: 'https://platform.minimax.io/docs/api-reference/web-search' },
+  { command: 'mmx vision describe',      title: 'Vision (Image Understanding)',         url: 'https://platform.minimax.io/docs/api-reference/vision' },
+];
+
+export default defineCommand({
+  name: 'help',
+  description: 'Show MiniMax API documentation links',
+  usage: 'mmx help',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference',
+  async run(_config: Config, _flags: GlobalFlags) {
+    process.stdout.write(`
+MiniMax API Documentation Links
+
+  Official docs: https://platform.minimax.io/docs/api-reference
+
+`);
+    for (const ref of API_REFS) {
+      process.stdout.write(`  ${ref.command.padEnd(30)} ${ref.title}\n`);
+      process.stdout.write(`  ${' '.repeat(30)} ${ref.url}\n\n`);
+    }
+  },
+});

src/commands/image/generate.ts

@@ -20,8 +20,8 @@ import { promptText, failIfMissing } from '../../utils/prompt';
 
 export default defineCommand({
   name: 'image generate',
-  description: 'Generate images (image-01)',
-  apiDocs: 'https://platform.minimax.io/docs/api-reference/image-generation',
+  description: 'Generate images (image-01 / image-01-live)',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference/image-generation-t2i',
   usage: 'mmx image generate --prompt <text> [flags]',
   options: [
     { flag: '--prompt <text>', description: 'Image description', required: true },

src/commands/music/cover.ts

@@ -14,7 +14,7 @@ import { musicCoverModel } from './models';
 export default defineCommand({
   name: 'music cover',
   description: 'Generate a cover version of a song based on reference audio (music-cover / music-cover-free)',
-  apiDocs: 'https://platform.minimax.io/docs/api-reference/music-cover-generation',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference/music-generation',
   usage: 'mmx music cover --prompt <text> (--audio <url> | --audio-file <path>) [--lyrics <text>] [--out <path>] [flags]',
   options: [
     { flag: '--model <model>', description: 'Model: music-cover (Token Plan), music-cover-free (Pay-as-you-go, default). Override only if needed.' },

src/commands/speech/synthesize.ts

@@ -13,11 +13,11 @@ import type { SpeechRequest, SpeechResponse } from '../../types/api';
 
 export default defineCommand({
   name: 'speech synthesize',
-  description: 'Synchronous TTS, up to 10,000 characters (speech-2.8-hd / 2.6 / 02)',
-  apiDocs: 'https://platform.minimax.io/docs/api-reference/speech-synthesis',
+  description: 'Synchronous TTS, up to 10,000 characters (speech-2.8 / 2.6 / 02 / 01)',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference/speech-t2a-http',
   usage: 'mmx speech synthesize --text <text> [--out <path>] [flags]',
   options: [
-    { flag: '--model <model>',           description: 'Model ID: speech-2.8-hd (default, highest quality), speech-2.6 (balanced), speech-02 (fastest)' },
+    { flag: '--model <model>',           description: 'Model ID: speech-2.8-hd (default, highest quality), speech-2.8-turbo, speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo' },
     { flag: '--text <text>',             description: 'Text to synthesize. Max 10,000 characters. Supports SSML-like pronunciation tags.' },
     { flag: '--text-file <path>',        description: 'Read text from file (use - for stdin). Same 10k char limit applies.' },
     { flag: '--voice <id>',              description: 'Voice ID (default: English_expressive_narrator). Run "mmx speech voices" to list available voices.' },

src/commands/text/chat.ts

@@ -78,10 +78,10 @@ function extractText(content: ContentBlock[]): string {
 export default defineCommand({
   name: 'text chat',
   description: 'Send a chat completion (MiniMax Messages API)',
-  apiDocs: 'https://platform.minimax.io/docs/api-reference/text-generation',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference/text-post',
   usage: 'mmx text chat --message <text> [flags]',
   options: [
-    { flag: '--model <model>', description: 'Model ID: MiniMax-M2.7 (default, balanced), MiniMax-M2.7-highspeed (faster, lower cost)' },
+    { flag: '--model <model>', description: 'Model ID: MiniMax-M2.7 (default), MiniMax-M2.7-highspeed, MiniMax-M2.5, MiniMax-M2.5-highspeed, MiniMax-M2.1, MiniMax-M2, MiniMax-Text-01' },
     { flag: '--message <text>',        description: 'Message text (repeatable). Prefix with role: to set role — e.g. "user:Hello", "assistant:Hi!", "system:You are helpful"', required: true, type: 'array' },
     { flag: '--messages-file <path>',  description: 'JSON file with messages array (use - for stdin). Format: [{"role": "user", "content": "..."}]' },
     { flag: '--system <text>',         description: 'System prompt to set assistant behavior' },

src/commands/video/generate.ts

@@ -21,7 +21,7 @@ import { promptText, failIfMissing } from '../../utils/prompt';
 
 export default defineCommand({
   name: 'video generate',
-  description: 'Generate a video (Hailuo-2.3 / 2.3-Fast / Hailuo-02 / S2V-01)',
+  description: 'Generate a video (T2V: Hailuo-2.3 / 2.3-Fast / Hailuo-02 | I2V: + I2V-01 / I2V-01-Director / I2V-01-live | S2V: S2V-01)',
   apiDocs: 'https://platform.minimax.io/docs/api-reference/video-generation',
   usage: 'mmx video generate --prompt <text> [flags]',
   options: [

src/registry.ts

@@ -24,6 +24,7 @@ import configShow from './commands/config/show';
 import configSet from './commands/config/set';
 import configExportSchema from './commands/config/export-schema';
 import update from './commands/update';
+import help from './commands/help';
 
 export type { Command, OptionDef } from './command';
 
@@ -285,4 +286,5 @@ export const registry = new CommandRegistry({
   'config set':           configSet,
   'config export-schema': configExportSchema,
   'update':               update,
+  'help':                 help,
 });