Fix region auto-detection on key change, improve error hints, remove --auto-lyrics

- Re-detect region when API key fingerprint changes (stored in config.yaml)
- Fix key precedence in fingerprint check to match credential resolver order
- Add minimum plan requirements to model access and quota error messages
- Use region-aware upgrade URL in error hints
- Remove broken --auto-lyrics flag from music generate
- Warn when no lyrics provided for music generation

Author: tars90percent

README.md

@@ -91,7 +91,7 @@ Run `minimax <command> --help` to see the full list of options, defaults, and us
 | `video generate` | Create a video generation task | `--model`, `--prompt`, `--first-frame`, `--callback-url`, `--wait`, `--poll-interval`, `--download` |
 | `video task get` | Query video task status | `--task-id` |
 | `video download` | Download a completed video by file ID | `--file-id`, `--out` |
-| `music generate` | Generate a song | `--prompt`, `--lyrics`, `--lyrics-file`, `--auto-lyrics`, `--format`, `--sample-rate`, `--bitrate`, `--stream`, `--out`, `--out-format` |
+| `music generate` | Generate a song | `--prompt`, `--lyrics`, `--lyrics-file`, `--format`, `--sample-rate`, `--bitrate`, `--stream`, `--out`, `--out-format` |
 | `search query` | Search the web via MiniMax | `--q` |
 | `vision describe` | Describe an image using MiniMax VLM | `--image`, `--prompt` |
 | `quota show` | Display Token Plan usage and remaining quotas | — |
@@ -178,7 +178,7 @@ minimax music generate --prompt "Indie folk, melancholic" --lyrics "La la la..."
 minimax music generate --prompt "Upbeat pop" --lyrics-file song.txt --out summer.mp3
 
 # Auto-generated lyrics
-minimax music generate --prompt "Jazz lounge" --auto-lyrics --out jazz.mp3
+minimax music generate --prompt "Jazz lounge" --lyrics "Do do do..." --out jazz.mp3
 ```
 
 #### search

src/args.ts

@@ -47,7 +47,7 @@ export function parseArgs(argv: string[]): ParsedArgs {
 
       // Boolean flags
       if (['quiet', 'verbose', 'noColor', 'yes', 'dryRun', 'help', 'stream',
-           'subtitles', 'autoLyrics', 'wait', 'noBrowser'].includes(camelKey)) {
+           'subtitles', 'wait', 'noBrowser'].includes(camelKey)) {
         (flags as Record<string, unknown>)[camelKey] = true;
         i++;
         continue;

src/commands/music/generate.ts

@@ -17,7 +17,6 @@ export default defineCommand({
     { flag: '--prompt <text>', description: 'Music style description' },
     { flag: '--lyrics <text>', description: 'Song lyrics' },
     { flag: '--lyrics-file <path>', description: 'Read lyrics from file (use - for stdin)' },
-    { flag: '--auto-lyrics', description: 'Auto-generate lyrics from prompt' },
     { flag: '--format <fmt>', description: 'Audio format (default: mp3)' },
     { flag: '--sample-rate <hz>', description: 'Sample rate (default: 44100)' },
     { flag: '--bitrate <bps>', description: 'Bitrate (default: 256000)' },
@@ -27,7 +26,7 @@ export default defineCommand({
   ],
   examples: [
     'minimax music generate --prompt "Indie folk, melancholic" --lyrics-file song.txt --out my_song.mp3',
-    'minimax music generate --prompt "Upbeat pop" --auto-lyrics --out summer.mp3',
+    'minimax music generate --prompt "Upbeat pop" --lyrics "La la la..." --out summer.mp3',
     'minimax music generate --prompt "Jazz lounge" --out-format url --output json',
   ],
   async run(config: Config, flags: GlobalFlags) {
@@ -49,14 +48,17 @@ export default defineCommand({
       );
     }
 
+    if (!lyrics) {
+      process.stderr.write('Warning: No lyrics provided. Use --lyrics or --lyrics-file to include lyrics.\n');
+    }
+
     const outFormat = (flags.outFormat as string) || 'hex';
     const format = detectOutputFormat(config.output);
 
     const body: MusicRequest = {
       model: 'music-2.5',
       prompt,
       lyrics,
-      auto_lyrics: flags.autoLyrics === true || undefined,
       audio_setting: {
         format: (flags.format as string) || 'mp3',
         sample_rate: (flags.sampleRate as number) || 44100,

src/config/detect-region.ts

@@ -51,9 +51,9 @@ export async function detectRegion(apiKey: string): Promise<Region> {
 }
 
 /**
- * Saves the detected region to ~/.minimax/config.yaml.
+ * Saves the detected region and key fingerprint to ~/.minimax/config.yaml.
  */
-export async function saveDetectedRegion(region: Region): Promise<void> {
+export async function saveDetectedRegion(region: Region, keyFingerprint?: string): Promise<void> {
   await ensureConfigDir();
   const configPath = getConfigPath();
 
@@ -65,5 +65,8 @@ export async function saveDetectedRegion(region: Region): Promise<void> {
   }
 
   existing.region = region;
+  if (keyFingerprint) {
+    existing.region_key_fingerprint = keyFingerprint;
+  }
   writeFileSync(configPath, yamlStringify(existing), { mode: 0o600 });
 }

src/config/loader.ts

@@ -28,11 +28,17 @@ export function loadConfig(flags: GlobalFlags): Config {
 
   const explicitRegion = (flags.region as string)
     || process.env.MINIMAX_REGION
-    || file.region
     || undefined;
 
-  const region = (explicitRegion || 'global') as Region;
-  const needsRegionDetection = !explicitRegion;
+  const cachedRegion = file.region;
+  const region = (explicitRegion || cachedRegion || 'global') as Region;
+
+  // Re-detect if: no explicit region AND (no cached region OR key fingerprint changed)
+  // Precedence must match resolver: flag > config file > env var (OAuth skipped — no stable fingerprint)
+  const activeKey = apiKey || fileApiKey || envApiKey;
+  const keyFingerprint = activeKey ? activeKey.slice(0, 8) : undefined;
+  const needsRegionDetection = !explicitRegion
+    && (!cachedRegion || (keyFingerprint !== undefined && keyFingerprint !== file.region_key_fingerprint));
 
   // Explicit --base-url overrides region-derived URL
   const baseUrl = flags.baseUrl

src/config/schema.ts

@@ -10,6 +10,7 @@ export type Region = keyof typeof REGIONS;
 export const ConfigSchema = z.object({
   api_key: z.string().optional(),
   region: z.enum(['global', 'cn']).default('global'),
+  region_key_fingerprint: z.string().optional(),
   base_url: z.string().url().optional(),
   output: z.enum(['text', 'json', 'yaml']).default('text'),
   timeout: z.number().positive().default(300),

src/main.ts

@@ -27,15 +27,15 @@ async function main() {
   const command = registry.resolve(commandPath);
   const config = loadConfig(flags);
 
-  // Auto-detect region on first run when no region is configured
+  // Auto-detect region when no explicit region is set and the API key has changed
   if (config.needsRegionDetection) {
-    const apiKey = config.apiKey || config.fileApiKey;
+    const apiKey = config.apiKey || config.fileApiKey || config.envApiKey;
     if (apiKey) {
       const detected = await detectRegion(apiKey);
       config.region = detected;
       config.baseUrl = REGIONS[detected];
       config.needsRegionDetection = false;
-      await saveDetectedRegion(detected);
+      await saveDetectedRegion(detected, apiKey.slice(0, 8));
     }
   }
 

src/types/api.ts

@@ -158,7 +158,6 @@ export interface MusicRequest {
   model: string;
   prompt?: string;
   lyrics?: string;
-  auto_lyrics?: boolean;
   audio_setting?: {
     format?: string;
     sample_rate?: number;

src/types/commands.ts

@@ -63,7 +63,6 @@ export interface MusicGenerateFlags {
   prompt?: string;
   lyrics?: string;
   lyricsFile?: string;
-  autoLyrics?: boolean;
   format?: string;
   sampleRate?: number;
   bitrate?: number;