feat(docs): add mmx help command + apiDocs to all commands

- New 'mmx help' command listing all official API doc links
- Add apiDocs field to Command interface (command.ts)
- Register apiDocs display in registry printCommandHelp
- Add apiDocs to: text chat, speech synthesize, image generate,
  video generate, music generate, music cover
- Update text chat --model: list all 7 models (M2.7/highspeed/M2.5/M2.5-highspeed/M2.1/M2/Text-01)
- Update speech synthesize: 8 models (2.8/2.6/02/01 hd+turbo)
- Update image description: image-01/image-01-live
- Update video description: Hailuo-2.3/2.3-Fast/Hailuo-02

Author: Raylan LIN

src/command.ts

@@ -14,6 +14,7 @@ export interface Command {
   usage?: string;
   options?: OptionDef[];
   examples?: string[];
+  apiDocs?: string;
   execute(config: Config, flags: GlobalFlags): Promise<void>;
 }
 
@@ -23,6 +24,7 @@ export interface CommandSpec {
   usage?: string;
   options?: OptionDef[];
   examples?: string[];
+  apiDocs?: string;
   run(config: Config, flags: GlobalFlags): Promise<void>;
 }
 
@@ -33,6 +35,7 @@ export function defineCommand(spec: CommandSpec): Command {
     usage: spec.usage,
     options: spec.options,
     examples: spec.examples,
+    apiDocs: spec.apiDocs,
     execute: spec.run,
   };
 }

src/commands/help.ts

@@ -0,0 +1,39 @@
+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 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

@@ -18,7 +18,8 @@ import { promptText, failIfMissing } from '../../utils/prompt';
 
 export default defineCommand({
   name: 'image generate',
-  description: 'Generate images (image-01)',
+  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

@@ -13,7 +13,8 @@ import { musicCoverModel } from './models';
 
 export default defineCommand({
   name: 'music cover',
-  description: 'Generate a cover version of a song based on reference audio (music-cover-free)',
+  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-generation',
   usage: 'mmx music cover --prompt <text> (--audio <url> | --audio-file <path>) [--lyrics <text>] [--out <path>] [flags]',
   options: [
     { flag: '--prompt <text>', description: 'Target cover style, e.g. "Indie folk, acoustic guitar, warm male vocal"' },

src/commands/music/generate.ts

@@ -13,7 +13,8 @@ import { musicGenerateModel } from './models';
 
 export default defineCommand({
   name: 'music generate',
-  description: 'Generate a song (music-2.6-free)',
+  description: 'Generate a song (music-2.6 / music-2.6-free / music-2.5+ / music-2.5)',
+  apiDocs: 'https://platform.minimax.io/docs/api-reference/music-generation',
   usage: 'mmx music generate --prompt <text> (--lyrics <text> | --instrumental | --lyrics-optimizer) [--out <path>] [flags]',
   options: [
     { flag: '--prompt <text>', description: 'Music style description (can be detailed — see examples)' },

src/commands/text/chat.ts

@@ -78,6 +78,7 @@ 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-post',
   usage: 'mmx text chat --message <text> [flags]',
   options: [
     { flag: '--model <model>', description: 'Model ID (default: MiniMax-M2.7)' },

src/commands/video/generate.ts

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

src/registry.ts

@@ -22,6 +22,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';
 
@@ -237,6 +238,9 @@ ${b('Getting Help:')}
         out.write(`  ${d(ex)}\n`);
       }
     }
+    if (cmd.apiDocs) {
+      out.write(`\n${b('API Reference:')} ${d(cmd.apiDocs)}\n`);
+    }
     out.write(`\n${d('Global flags (--api-key, --output, --quiet, etc.) are always available.')}\n`);
     out.write(`${d("Run")} mmx --help ${d('for the full list.')}\n`);
   }
@@ -278,4 +282,5 @@ export const registry = new CommandRegistry({
   'config set':           configSet,
   'config export-schema': configExportSchema,
   'update':               update,
+  'help':                 help,
 });