fix: apiDocs path, model validation, stream+url conflict

- Change apiDocs from full URL to path (fixes broken URL in --help)
- Add client-side model validation for --model flag
- Error when --stream and --output-format url are combined

Author: tars90percent

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-generation',
+  apiDocs: '/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.' },
@@ -69,6 +69,14 @@ export default defineCommand({
     const format = detectOutputFormat(config.output);
 
     const model = (flags.model as string) || musicCoverModel(config);
+    const VALID_MODELS = ['music-cover', 'music-cover-free'];
+    if (flags.model && !VALID_MODELS.includes(model)) {
+      throw new CLIError(
+        `Invalid model "${model}". Valid models: ${VALID_MODELS.join(', ')}`,
+        ExitCode.USAGE,
+        'mmx music cover --model music-cover',
+      );
+    }
     const body: MusicRequest = {
       model,
       prompt,

src/commands/music/generate.ts

@@ -14,7 +14,7 @@ import { musicGenerateModel } from './models';
 export default defineCommand({
   name: 'music generate',
   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',
+  apiDocs: '/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 (e.g. "cinematic orchestral, building tension"). Max 2000 chars when combined with structured flags.' },
@@ -125,6 +125,14 @@ export default defineCommand({
     const format = detectOutputFormat(config.output);
 
     const model = (flags.model as string) || musicGenerateModel(config);
+    const VALID_MODELS = ['music-2.6', 'music-2.6-free', 'music-2.5+', 'music-2.5'];
+    if (flags.model && !VALID_MODELS.includes(model)) {
+      throw new CLIError(
+        `Invalid model "${model}". Valid models: ${VALID_MODELS.join(', ')}`,
+        ExitCode.USAGE,
+        'mmx music generate --model music-2.6',
+      );
+    }
     const outFormat = (flags.outputFormat as string) || 'hex';
     if (outFormat !== 'hex' && outFormat !== 'url') {
       throw new CLIError(
@@ -133,6 +141,13 @@ export default defineCommand({
         'mmx music generate --output-format url',
       );
     }
+    if (flags.stream && outFormat === 'url') {
+      throw new CLIError(
+        '--stream and --output-format url cannot be used together. Streaming requires hex format.',
+        ExitCode.USAGE,
+        'mmx music generate --output-format url',
+      );
+    }
     const body: MusicRequest = {
       model,
       prompt,