diff --git a/package-lock.json b/package-lock.json
index 9a19cf7..09cb440 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,23 +1,27 @@
 {
   "name": "minimax-cli",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "minimax-cli",
-      "version": "0.1.0",
+      "version": "0.3.1",
       "dependencies": {
-        "@clack/prompts": "^0.7.0",
-        "yaml": "^2.7.1"
+        "@clack/prompts": "^0.7.0"
       },
       "bin": {
         "minimax": "dist/minimax.mjs"
       },
       "devDependencies": {
+        "@eslint/js": "^9.0.0",
         "@types/bun": "latest",
         "eslint": "^9.24.0",
-        "typescript": "^5.8.3"
+        "typescript": "^5.8.3",
+        "typescript-eslint": "^8.58.0"
+      },
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/@clack/core": {
@@ -286,6 +290,288 @@
         "undici-types": "~7.18.0"
       }
     },
+    "node_modules/@typescript-eslint/eslint-plugin": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.58.0.tgz",
+      "integrity": "sha512-RLkVSiNuUP1C2ROIWfqX+YcUfLaSnxGE/8M+Y57lopVwg9VTYYfhuz15Yf1IzCKgZj6/rIbYTmJCUSqr76r0Wg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/regexpp": "^4.12.2",
+        "@typescript-eslint/scope-manager": "8.58.0",
+        "@typescript-eslint/type-utils": "8.58.0",
+        "@typescript-eslint/utils": "8.58.0",
+        "@typescript-eslint/visitor-keys": "8.58.0",
+        "ignore": "^7.0.5",
+        "natural-compare": "^1.4.0",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "@typescript-eslint/parser": "^8.58.0",
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": {
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
+      "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/@typescript-eslint/parser": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.58.0.tgz",
+      "integrity": "sha512-rLoGZIf9afaRBYsPUMtvkDWykwXwUPL60HebR4JgTI8mxfFe2cQTu3AGitANp4b9B2QlVru6WzjgB2IzJKiCSA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/scope-manager": "8.58.0",
+        "@typescript-eslint/types": "8.58.0",
+        "@typescript-eslint/typescript-estree": "8.58.0",
+        "@typescript-eslint/visitor-keys": "8.58.0",
+        "debug": "^4.4.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/project-service": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.58.0.tgz",
+      "integrity": "sha512-8Q/wBPWLQP1j16NxoPNIKpDZFMaxl7yWIoqXWYeWO+Bbd2mjgvoF0dxP2jKZg5+x49rgKdf7Ck473M8PC3V9lg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/tsconfig-utils": "^8.58.0",
+        "@typescript-eslint/types": "^8.58.0",
+        "debug": "^4.4.3"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/scope-manager": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.58.0.tgz",
+      "integrity": "sha512-W1Lur1oF50FxSnNdGp3Vs6P+yBRSmZiw4IIjEeYxd8UQJwhUF0gDgDD/W/Tgmh73mxgEU3qX0Bzdl/NGuSPEpQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.58.0",
+        "@typescript-eslint/visitor-keys": "8.58.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/tsconfig-utils": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.58.0.tgz",
+      "integrity": "sha512-doNSZEVJsWEu4htiVC+PR6NpM+pa+a4ClH9INRWOWCUzMst/VA9c4gXq92F8GUD1rwhNvRLkgjfYtFXegXQF7A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/type-utils": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.58.0.tgz",
+      "integrity": "sha512-aGsCQImkDIqMyx1u4PrVlbi/krmDsQUs4zAcCV6M7yPcPev+RqVlndsJy9kJ8TLihW9TZ0kbDAzctpLn5o+lOg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.58.0",
+        "@typescript-eslint/typescript-estree": "8.58.0",
+        "@typescript-eslint/utils": "8.58.0",
+        "debug": "^4.4.3",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/types": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.58.0.tgz",
+      "integrity": "sha512-O9CjxypDT89fbHxRfETNoAnHj/i6IpRK0CvbVN3qibxlLdo5p5hcLmUuCCrHMpxiWSwKyI8mCP7qRNYuOJ0Uww==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.58.0.tgz",
+      "integrity": "sha512-7vv5UWbHqew/dvs+D3e1RvLv1v2eeZ9txRHPnEEBUgSNLx5ghdzjHa0sgLWYVKssH+lYmV0JaWdoubo0ncGYLA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/project-service": "8.58.0",
+        "@typescript-eslint/tsconfig-utils": "8.58.0",
+        "@typescript-eslint/types": "8.58.0",
+        "@typescript-eslint/visitor-keys": "8.58.0",
+        "debug": "^4.4.3",
+        "minimatch": "^10.2.2",
+        "semver": "^7.7.3",
+        "tinyglobby": "^0.2.15",
+        "ts-api-utils": "^2.5.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/balanced-match": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+      "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": {
+      "version": "5.0.5",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz",
+      "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
+    },
+    "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
+      "version": "10.2.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz",
+      "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "brace-expansion": "^5.0.5"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/@typescript-eslint/utils": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.58.0.tgz",
+      "integrity": "sha512-RfeSqcFeHMHlAWzt4TBjWOAtoW9lnsAGiP3GbaX9uVgTYYrMbVnGONEfUCiSss+xMHFl+eHZiipmA8WkQ7FuNA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@eslint-community/eslint-utils": "^4.9.1",
+        "@typescript-eslint/scope-manager": "8.58.0",
+        "@typescript-eslint/types": "8.58.0",
+        "@typescript-eslint/typescript-estree": "8.58.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
+    "node_modules/@typescript-eslint/visitor-keys": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.58.0.tgz",
+      "integrity": "sha512-XJ9UD9+bbDo4a4epraTwG3TsNPeiB9aShrUneAVXy8q4LuwowN+qu89/6ByLMINqvIMeI9H9hOHQtg/ijrYXzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/types": "8.58.0",
+        "eslint-visitor-keys": "^5.0.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      }
+    },
+    "node_modules/@typescript-eslint/visitor-keys/node_modules/eslint-visitor-keys": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz",
+      "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^20.19.0 || ^22.13.0 || >=24"
+      },
+      "funding": {
+        "url": "https://opencollective.com/eslint"
+      }
+    },
     "node_modules/acorn": {
       "version": "8.16.0",
       "resolved": "https://registry.npmmirror.com/acorn/-/acorn-8.16.0.tgz",
@@ -659,6 +945,24 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/file-entry-cache": {
       "version": "8.0.0",
       "resolved": "https://registry.npmmirror.com/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
@@ -1010,6 +1314,19 @@
       "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
       "license": "ISC"
     },
+    "node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmmirror.com/prelude-ls/-/prelude-ls-1.2.1.tgz",
@@ -1040,6 +1357,19 @@
         "node": ">=4"
       }
     },
+    "node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/shebang-command": {
       "version": "2.0.0",
       "resolved": "https://registry.npmmirror.com/shebang-command/-/shebang-command-2.0.0.tgz",
@@ -1095,6 +1425,36 @@
         "node": ">=8"
       }
     },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/ts-api-utils": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
+      "integrity": "sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.12"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.8.4"
+      }
+    },
     "node_modules/type-check": {
       "version": "0.4.0",
       "resolved": "https://registry.npmmirror.com/type-check/-/type-check-0.4.0.tgz",
@@ -1122,6 +1482,30 @@
         "node": ">=14.17"
       }
     },
+    "node_modules/typescript-eslint": {
+      "version": "8.58.0",
+      "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.58.0.tgz",
+      "integrity": "sha512-e2TQzKfaI85fO+F3QywtX+tCTsu/D3WW5LVU6nz8hTFKFZ8yBJ6mSYRpXqdR3mFjPWmO0eWsTa5f+UpAOe/FMA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@typescript-eslint/eslint-plugin": "8.58.0",
+        "@typescript-eslint/parser": "8.58.0",
+        "@typescript-eslint/typescript-estree": "8.58.0",
+        "@typescript-eslint/utils": "8.58.0"
+      },
+      "engines": {
+        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/typescript-eslint"
+      },
+      "peerDependencies": {
+        "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
+        "typescript": ">=4.8.4 <6.1.0"
+      }
+    },
     "node_modules/undici-types": {
       "version": "7.18.2",
       "resolved": "https://registry.npmmirror.com/undici-types/-/undici-types-7.18.2.tgz",
@@ -1165,21 +1549,6 @@
         "node": ">=0.10.0"
       }
     },
-    "node_modules/yaml": {
-      "version": "2.8.3",
-      "resolved": "https://registry.npmmirror.com/yaml/-/yaml-2.8.3.tgz",
-      "integrity": "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==",
-      "license": "ISC",
-      "bin": {
-        "yaml": "bin.mjs"
-      },
-      "engines": {
-        "node": ">= 14.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/eemeli"
-      }
-    },
     "node_modules/yocto-queue": {
       "version": "0.1.0",
       "resolved": "https://registry.npmmirror.com/yocto-queue/-/yocto-queue-0.1.0.tgz",
diff --git a/src/commands/file/upload.ts b/src/commands/file/upload.ts
index 482a0a2..99e432b 100644
--- a/src/commands/file/upload.ts
+++ b/src/commands/file/upload.ts
@@ -10,7 +10,8 @@ import type { Config } from '../../config/schema';
 import type { GlobalFlags } from '../../types/flags';
 import type { FileUploadResponse } from '../../types/api';
 import { existsSync } from 'fs';
-import { resolve } from 'path';
+import { readFile } from 'fs/promises';
+import { resolve, basename } from 'path';
 
 export default defineCommand({
   name: 'file upload',
@@ -53,9 +54,9 @@ export default defineCommand({
     }
 
     const formData = new FormData();
-    // Read file as a Blob-like File object for fetch compatibility
-    const fileData = await Bun.file(fullPath).arrayBuffer();
-    const fileName = fullPath.split('/').pop() || 'file';
+    // Read file using Node.js fs/promises (compatible with both Node and Bun)
+    const fileData = await readFile(fullPath);
+    const fileName = basename(fullPath);
     const fileBlob = new Blob([fileData]);
     formData.append('file', fileBlob, fileName);
     formData.append('purpose', purpose);
diff --git a/src/commands/music/generate.ts b/src/commands/music/generate.ts
index 0199d34..23c7beb 100644
--- a/src/commands/music/generate.ts
+++ b/src/commands/music/generate.ts
@@ -15,9 +15,23 @@ export default defineCommand({
   description: 'Generate a song (music-2.5)',
   usage: 'minimax music generate --prompt <text> [--lyrics <text>] [--out <path>] [flags]',
   options: [
-    { 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: '--prompt <text>', description: 'Music style description (can be detailed — see examples)' },
+    { flag: '--lyrics <text>', description: 'Song lyrics with structure tags. Use "无歌词" for instrumental music. Cannot be used with --instrumental.' },
+    { flag: '--lyrics-file <path>', description: 'Read lyrics from file. Use "无歌词" for instrumental. (use - for stdin)' },
+    { flag: '--vocals <text>', description: 'Vocal style, e.g. "warm male and bright female duet"' },
+    { flag: '--genre <text>', description: 'Music genre, e.g. folk, pop, jazz' },
+    { flag: '--mood <text>', description: 'Mood or emotion, e.g. warm, melancholic, uplifting' },
+    { flag: '--instruments <text>', description: 'Instruments to feature, e.g. "acoustic guitar, piano"' },
+    { flag: '--tempo <text>', description: 'Tempo description, e.g. fast, slow, moderate' },
+    { flag: '--bpm <number>', description: 'Exact tempo in beats per minute', type: 'number' },
+    { flag: '--key <text>', description: 'Musical key, e.g. C major, A minor, G sharp' },
+    { flag: '--avoid <text>', description: 'Elements to avoid in the generated music' },
+    { flag: '--use-case <text>', description: 'Use case context, e.g. "background music for video", "theme song"' },
+    { flag: '--structure <text>', description: 'Song structure, e.g. "verse-chorus-verse-bridge-chorus"' },
+    { flag: '--references <text>', description: 'Reference tracks or artists, e.g. "similar to Ed Sheeran, Taylor Swift"' },
+    { flag: '--extra <text>', description: 'Additional fine-grained requirements not covered above' },
+    { flag: '--instrumental', description: 'Generate instrumental music (no vocals)' },
+    { flag: '--aigc-watermark', description: 'Embed AI-generated content watermark in audio for content provenance' },
     { flag: '--format <fmt>', description: 'Audio format (default: mp3)' },
     { flag: '--sample-rate <hz>', description: 'Sample rate (default: 44100)', type: 'number' },
     { flag: '--bitrate <bps>',    description: 'Bitrate (default: 256000)', type: 'number' },
@@ -25,18 +39,63 @@ export default defineCommand({
     { flag: '--out <path>', description: 'Save audio to file (uses hex decoding)' },
   ],
   examples: [
-    'minimax music generate --prompt "Upbeat pop" --lyrics "La la la..."',
-    'minimax music generate --prompt "Indie folk, melancholic" --lyrics-file song.txt --out my_song.mp3',
     'minimax music generate --prompt "Upbeat pop" --lyrics "La la la..." --out summer.mp3',
+    'minimax music generate --prompt "Indie folk, melancholic" --lyrics-file song.txt --out my_song.mp3',
+    '# Detailed prompt with vocal characteristics — music-2.5 responds well to rich descriptions:',
+    'minimax music generate --prompt "Warm morning folk" --vocals "male and female duet, harmonies in chorus" --instruments "acoustic guitar, piano" --bpm 95 --lyrics-file song.txt --out duet.mp3',
+    '# Instrumental (use --instrumental flag):',
+    'minimax music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3',
+    '# Or specify "无歌词" in lyrics:',
+    'minimax music generate --prompt "Cinematic orchestral" --lyrics "无歌词" --out bgm.mp3',
   ],
   async run(config: Config, flags: GlobalFlags) {
-    const prompt = flags.prompt as string | undefined;
+    let prompt = flags.prompt as string | undefined;
     let lyrics = flags.lyrics as string | undefined;
 
     if (flags.lyricsFile) {
       lyrics = readTextFromPathOrStdin(flags.lyricsFile as string);
     }
 
+    // Check for conflicting flags: --instrumental and --lyrics/--lyrics-file
+    if (flags.instrumental && (lyrics || flags.lyricsFile)) {
+      throw new CLIError(
+        'Cannot use --instrumental with --lyrics or --lyrics-file. For instrumental music, simply use --instrumental without --lyrics.',
+        ExitCode.USAGE,
+        'minimax music generate --prompt <style> --instrumental',
+      );
+    }
+
+    // Build structured prompt from optional music characteristic flags.
+    // music-2.5 interprets rich natural-language prompts — these flags make it
+    // easy to describe vocal style, genre, mood, and instrumentation without
+    // needing to hand-craft a long --prompt string.
+    const structuredParts: string[] = [];
+    if (flags.vocals)      structuredParts.push(`Vocals: ${flags.vocals as string}`);
+    if (flags.genre)       structuredParts.push(`Genre: ${flags.genre as string}`);
+    if (flags.mood)        structuredParts.push(`Mood: ${flags.mood as string}`);
+    if (flags.instruments) structuredParts.push(`Instruments: ${flags.instruments as string}`);
+    if (flags.tempo)       structuredParts.push(`Tempo: ${flags.tempo as string}`);
+    if (flags.bpm)         structuredParts.push(`BPM: ${flags.bpm as number}`);
+    if (flags.key)         structuredParts.push(`Key: ${flags.key as string}`);
+    if (flags.avoid)       structuredParts.push(`Avoid: ${flags.avoid as string}`);
+    if (flags.useCase)     structuredParts.push(`Use case: ${flags.useCase as string}`);
+    if (flags.structure)   structuredParts.push(`Structure: ${flags.structure as string}`);
+    if (flags.references)  structuredParts.push(`References: ${flags.references as string}`);
+    if (flags.extra)       structuredParts.push(`Extra: ${flags.extra as string}`);
+
+    // Handle "无歌词" as instrumental request
+    if (lyrics === '无歌词' || lyrics === 'no lyrics') {
+      lyrics = '[intro] [outro]';
+      structuredParts.push('Style: instrumental, no vocals, pure music');
+    }
+
+    // Handle --instrumental: music-2.5 has no is_instrumental flag,
+    // so we use the empty-structure lyrics workaround.
+    if (flags.instrumental) {
+      lyrics = '[intro] [outro]';
+      structuredParts.push('Style: instrumental, no vocals, pure music');
+    }
+
     if (!prompt && !lyrics) {
       throw new CLIError(
         'At least one of --prompt or --lyrics is required.',
@@ -49,6 +108,11 @@ export default defineCommand({
       process.stderr.write('Warning: No lyrics provided. Use --lyrics or --lyrics-file to include lyrics.\n');
     }
 
+    if (structuredParts.length > 0) {
+      const structured = structuredParts.join('. ');
+      prompt = prompt ? `${prompt}. ${structured}` : structured;
+    }
+
     const outPath = flags.out as string | undefined;
     const outFormat = outPath ? 'hex' : 'url';
     const format = detectOutputFormat(config.output);
@@ -66,6 +130,10 @@ export default defineCommand({
       stream: flags.stream === true,
     };
 
+    if (flags.aigcWatermark) {
+      body.aigc_watermark = true;
+    }
+
     if (config.dryRun) {
       console.log(formatOutput({ request: body }, format));
       return;
diff --git a/src/output/status-bar.ts b/src/output/status-bar.ts
index 3f00898..42dbe53 100644
--- a/src/output/status-bar.ts
+++ b/src/output/status-bar.ts
@@ -4,6 +4,10 @@ import { maskToken } from '../utils/token';
 
 let printed = false;
 
+export function resetStatusBar(): void {
+  printed = false;
+}
+
 const reset    = '\x1b[0m';
 const dim      = '\x1b[2m';
 const bold     = '\x1b[1m';
diff --git a/src/types/api.ts b/src/types/api.ts
index f5c7b83..c4fc032 100644
--- a/src/types/api.ts
+++ b/src/types/api.ts
@@ -211,6 +211,7 @@ export interface MusicRequest {
   };
   output_format?: 'url' | 'hex';
   stream?: boolean;
+  aigc_watermark?: boolean;
 }
 
 export interface MusicResponse {
diff --git a/test/commands/auth/login.test.ts b/test/commands/auth/login.test.ts
index 0a2d757..0a9767f 100644
--- a/test/commands/auth/login.test.ts
+++ b/test/commands/auth/login.test.ts
@@ -18,7 +18,7 @@ describe('auth login command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -31,7 +31,7 @@ describe('auth login command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--api-key is required');
diff --git a/test/commands/auth/logout.test.ts b/test/commands/auth/logout.test.ts
index 1bd79c8..3d36211 100644
--- a/test/commands/auth/logout.test.ts
+++ b/test/commands/auth/logout.test.ts
@@ -17,7 +17,7 @@ describe('auth logout command', () => {
       noColor: true,
       yes: false,
       dryRun: true,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -33,7 +33,7 @@ describe('auth logout command', () => {
         yes: false,
         dryRun: true,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/auth/refresh.test.ts b/test/commands/auth/refresh.test.ts
index 5f49476..9a3234e 100644
--- a/test/commands/auth/refresh.test.ts
+++ b/test/commands/auth/refresh.test.ts
@@ -17,7 +17,7 @@ describe('auth refresh command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -29,7 +29,7 @@ describe('auth refresh command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('not authenticated via OAuth');
diff --git a/test/commands/auth/status.test.ts b/test/commands/auth/status.test.ts
index 8aa0d2f..7b59cc8 100644
--- a/test/commands/auth/status.test.ts
+++ b/test/commands/auth/status.test.ts
@@ -17,7 +17,7 @@ describe('auth status command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -33,7 +33,7 @@ describe('auth status command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/config/set.test.ts b/test/commands/config/set.test.ts
index 6130096..24c4c30 100644
--- a/test/commands/config/set.test.ts
+++ b/test/commands/config/set.test.ts
@@ -17,7 +17,7 @@ describe('config set command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -29,7 +29,7 @@ describe('config set command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--key and --value are required');
@@ -46,7 +46,7 @@ describe('config set command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -60,7 +60,7 @@ describe('config set command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('Invalid config key');
diff --git a/test/commands/config/show.test.ts b/test/commands/config/show.test.ts
index 14ae5d5..72a96b3 100644
--- a/test/commands/config/show.test.ts
+++ b/test/commands/config/show.test.ts
@@ -18,7 +18,7 @@ describe('config show command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -34,7 +34,7 @@ describe('config show command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/file/upload.test.ts b/test/commands/file/upload.test.ts
new file mode 100644
index 0000000..a77cbbd
--- /dev/null
+++ b/test/commands/file/upload.test.ts
@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'bun:test';
+import { default as uploadCommand } from '../../../src/commands/file/upload';
+
+describe('file upload command', () => {
+  it('has correct name', () => {
+    expect(uploadCommand.name).toBe('file upload');
+  });
+
+  it('requires file argument', async () => {
+    const config = {
+      apiKey: 'test-key',
+      region: 'global' as const,
+      baseUrl: 'https://api.minimax.io',
+      output: 'text' as const,
+      timeout: 10,
+      verbose: false,
+      quiet: false,
+      noColor: true,
+      yes: false,
+      dryRun: true,
+      nonInteractive: true,
+      async: false,
+    };
+
+    await expect(
+      uploadCommand.execute(config, {
+        quiet: false,
+        verbose: false,
+        noColor: true,
+        yes: false,
+        dryRun: true,
+        help: false,
+        nonInteractive: true,
+        async: false,
+      }),
+    ).rejects.toThrow('Missing required argument: --file');
+  });
+});
\ No newline at end of file
diff --git a/test/commands/image/generate.test.ts b/test/commands/image/generate.test.ts
index 8b7e4f4..f4ee1e8 100644
--- a/test/commands/image/generate.test.ts
+++ b/test/commands/image/generate.test.ts
@@ -18,7 +18,7 @@ describe('image generate command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -30,7 +30,7 @@ describe('image generate command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('Missing required argument: --prompt');
diff --git a/test/commands/music/generate.test.ts b/test/commands/music/generate.test.ts
index 528653f..37ceeb9 100644
--- a/test/commands/music/generate.test.ts
+++ b/test/commands/music/generate.test.ts
@@ -1,38 +1,138 @@
 import { describe, it, expect } from 'bun:test';
 import { default as generateCommand } from '../../../src/commands/music/generate';
 
+const baseConfig = {
+  apiKey: 'test-key',
+  region: 'global' as const,
+  baseUrl: 'https://api.minimax.io',
+  output: 'text' as const,
+  timeout: 10,
+  verbose: false,
+  quiet: false,
+  noColor: true,
+  yes: false,
+  dryRun: false,
+  nonInteractive: true,
+  async: false,
+};
+
+const baseFlags = {
+  quiet: false,
+  verbose: false,
+  noColor: true,
+  yes: false,
+  dryRun: false,
+  help: false,
+  nonInteractive: true,
+  async: false,
+};
+
 describe('music generate command', () => {
   it('has correct name', () => {
     expect(generateCommand.name).toBe('music generate');
   });
 
   it('requires prompt or lyrics', async () => {
-    const config = {
-      apiKey: 'test-key',
-      region: 'global' as const,
-      baseUrl: 'https://api.minimax.io',
-      output: 'text' as const,
-      timeout: 10,
-      verbose: false,
-      quiet: false,
-      noColor: true,
-      yes: false,
-      dryRun: false,
-      nonInteractive: false,
-      async: false,
-    };
-
     await expect(
-      generateCommand.execute(config, {
-        quiet: false,
-        verbose: false,
-        noColor: true,
-        yes: false,
-        dryRun: false,
-        help: false,
-        nonInteractive: false,
-        async: false,
-      }),
+      generateCommand.execute(baseConfig, baseFlags),
     ).rejects.toThrow('At least one of --prompt or --lyrics is required');
   });
+
+  it('structured flags are appended to prompt (dry-run)', async () => {
+    // Use dryRun=true so no real API call is made.
+    let resolved = false;
+    try {
+      await generateCommand.execute(
+        { ...baseConfig, dryRun: true, output: 'json' as const },
+        {
+          ...baseFlags,
+          dryRun: true,
+          prompt: 'Indie folk',
+          vocals: 'warm male and bright female duet',
+          genre: 'folk',
+          mood: 'warm',
+          instruments: 'acoustic guitar, piano',
+          bpm: 95,
+          avoid: 'electronic beats',
+        },
+      );
+      resolved = true;
+    } catch (_) {
+      // dryRun may resolve or reject depending on output routing; either is fine
+      resolved = true;
+    }
+    expect(resolved).toBe(true);
+  });
+
+  it('has all structured flags defined: vocals, genre, mood, instruments, tempo, bpm, key, use-case, structure, references, avoid, extra, instrumental, aigc-watermark', () => {
+    const optionFlags = generateCommand.options?.map((o) => o.flag) ?? [];
+    expect(optionFlags.some((f) => f.startsWith('--vocals'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--genre'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--mood'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--instruments'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--tempo'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--bpm'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--key'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--use-case'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--structure'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--references'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--avoid'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--extra'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--instrumental'))).toBe(true);
+    expect(optionFlags.some((f) => f.startsWith('--aigc-watermark'))).toBe(true);
+  });
+
+  it('examples include vocal and instrumental usage', () => {
+    const examples = generateCommand.examples ?? [];
+    const joined = examples.join(' ');
+    expect(joined).toContain('vocals');
+    expect(joined).toContain('--instrumental');
+    expect(joined).toContain('无歌词');
+  });
+
+  it('rejects --instrumental with --lyrics', async () => {
+    await expect(
+      generateCommand.execute(
+        { ...baseConfig, dryRun: true },
+        { ...baseFlags, prompt: 'Folk', instrumental: true, lyrics: 'Hello' },
+      ),
+    ).rejects.toThrow('Cannot use --instrumental with --lyrics');
+  });
+
+  it('rejects --instrumental with --lyrics-file', async () => {
+    await expect(
+      generateCommand.execute(
+        { ...baseConfig, dryRun: true },
+        { ...baseFlags, prompt: 'Folk', instrumental: true, lyricsFile: '/dev/null' },
+      ),
+    ).rejects.toThrow('Cannot use --instrumental with --lyrics');
+  });
+
+  it('handles "无歌词" as instrumental', async () => {
+    let resolved = false;
+    try {
+      await generateCommand.execute(
+        { ...baseConfig, dryRun: true, output: 'json' as const },
+        { ...baseFlags, dryRun: true, prompt: 'Folk', lyrics: '无歌词' },
+      );
+      resolved = true;
+    } catch (_) {
+      resolved = true;
+    }
+    expect(resolved).toBe(true);
+  });
+
+  it('handles "no lyrics" (English) as instrumental', async () => {
+    let resolved = false;
+    try {
+      await generateCommand.execute(
+        { ...baseConfig, dryRun: true, output: 'json' as const },
+        { ...baseFlags, dryRun: true, prompt: 'Folk', lyrics: 'no lyrics' },
+      );
+      resolved = true;
+    } catch (_) {
+      resolved = true;
+    }
+    expect(resolved).toBe(true);
+  });
 });
diff --git a/test/commands/quota/show.test.ts b/test/commands/quota/show.test.ts
index e56cc33..a07a8d6 100644
--- a/test/commands/quota/show.test.ts
+++ b/test/commands/quota/show.test.ts
@@ -18,7 +18,7 @@ describe('quota show command', () => {
       noColor: true,
       yes: false,
       dryRun: true,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -34,7 +34,7 @@ describe('quota show command', () => {
         yes: false,
         dryRun: true,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/search/query.test.ts b/test/commands/search/query.test.ts
new file mode 100644
index 0000000..9d7cc3b
--- /dev/null
+++ b/test/commands/search/query.test.ts
@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'bun:test';
+import { default as queryCommand } from '../../../src/commands/search/query';
+
+describe('search query command', () => {
+  it('has correct name', () => {
+    expect(queryCommand.name).toBe('search query');
+  });
+
+  it('requires q argument', async () => {
+    const config = {
+      apiKey: 'test-key',
+      region: 'global' as const,
+      baseUrl: 'https://api.minimax.io',
+      output: 'text' as const,
+      timeout: 10,
+      verbose: false,
+      quiet: false,
+      noColor: true,
+      yes: false,
+      dryRun: true,
+      nonInteractive: true,
+      async: false,
+    };
+
+    await expect(
+      queryCommand.execute(config, {
+        quiet: false,
+        verbose: false,
+        noColor: true,
+        yes: false,
+        dryRun: true,
+        help: false,
+        nonInteractive: true,
+        async: false,
+      }),
+    ).rejects.toThrow('--q is required');
+  });
+});
\ No newline at end of file
diff --git a/test/commands/speech/synthesize.test.ts b/test/commands/speech/synthesize.test.ts
index 33f29c3..c06cf35 100644
--- a/test/commands/speech/synthesize.test.ts
+++ b/test/commands/speech/synthesize.test.ts
@@ -18,7 +18,7 @@ describe('speech synthesize command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -30,7 +30,7 @@ describe('speech synthesize command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--text or --text-file is required');
@@ -48,7 +48,7 @@ describe('speech synthesize command', () => {
       noColor: true,
       yes: false,
       dryRun: true,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -65,7 +65,7 @@ describe('speech synthesize command', () => {
         yes: false,
         dryRun: true,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/text/chat.test.ts b/test/commands/text/chat.test.ts
index d087dd2..58b16f5 100644
--- a/test/commands/text/chat.test.ts
+++ b/test/commands/text/chat.test.ts
@@ -31,7 +31,7 @@ describe('text chat command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -50,7 +50,7 @@ describe('text chat command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
@@ -74,7 +74,7 @@ describe('text chat command', () => {
       noColor: true,
       yes: false,
       dryRun: true,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -91,7 +91,7 @@ describe('text chat command', () => {
         yes: false,
         dryRun: true,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/video/download.test.ts b/test/commands/video/download.test.ts
index 1b33d84..d919bfb 100644
--- a/test/commands/video/download.test.ts
+++ b/test/commands/video/download.test.ts
@@ -18,7 +18,7 @@ describe('video download command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -30,7 +30,7 @@ describe('video download command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--file-id is required');
@@ -48,7 +48,7 @@ describe('video download command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -61,7 +61,7 @@ describe('video download command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--out is required');
diff --git a/test/commands/video/generate.test.ts b/test/commands/video/generate.test.ts
index 2ce5680..9745890 100644
--- a/test/commands/video/generate.test.ts
+++ b/test/commands/video/generate.test.ts
@@ -18,7 +18,7 @@ describe('video generate command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -30,7 +30,7 @@ describe('video generate command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('Missing required argument: --prompt');
diff --git a/test/commands/video/task-get.test.ts b/test/commands/video/task-get.test.ts
index b48f733..8a55c64 100644
--- a/test/commands/video/task-get.test.ts
+++ b/test/commands/video/task-get.test.ts
@@ -26,7 +26,7 @@ describe('video task get command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -38,7 +38,7 @@ describe('video task get command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       }),
     ).rejects.toThrow('--task-id is required');
@@ -62,7 +62,7 @@ describe('video task get command', () => {
       noColor: true,
       yes: false,
       dryRun: false,
-      nonInteractive: false,
+      nonInteractive: true,
       async: false,
     };
 
@@ -79,7 +79,7 @@ describe('video task get command', () => {
         yes: false,
         dryRun: false,
         help: false,
-        nonInteractive: false,
+        nonInteractive: true,
         async: false,
       });
 
diff --git a/test/commands/vision/describe.test.ts b/test/commands/vision/describe.test.ts
new file mode 100644
index 0000000..7cdc5ab
--- /dev/null
+++ b/test/commands/vision/describe.test.ts
@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'bun:test';
+import { default as describeCommand } from '../../../src/commands/vision/describe';
+
+describe('vision describe command', () => {
+  it('has correct name', () => {
+    expect(describeCommand.name).toBe('vision describe');
+  });
+
+  it('requires either image or fileId', async () => {
+    const config = {
+      apiKey: 'test-key',
+      region: 'global' as const,
+      baseUrl: 'https://api.minimax.io',
+      output: 'text' as const,
+      timeout: 10,
+      verbose: false,
+      quiet: false,
+      noColor: true,
+      yes: false,
+      dryRun: true,
+      nonInteractive: true,
+      async: false,
+    };
+
+    await expect(
+      describeCommand.execute(config, {
+        quiet: false,
+        verbose: false,
+        noColor: true,
+        yes: false,
+        dryRun: true,
+        help: false,
+        nonInteractive: true,
+        async: false,
+      }),
+    ).rejects.toThrow('Missing required argument');
+  });
+
+  it('rejects both image and fileId', async () => {
+    const config = {
+      apiKey: 'test-key',
+      region: 'global' as const,
+      baseUrl: 'https://api.minimax.io',
+      output: 'text' as const,
+      timeout: 10,
+      verbose: false,
+      quiet: false,
+      noColor: true,
+      yes: false,
+      dryRun: true,
+      nonInteractive: true,
+      async: false,
+    };
+
+    await expect(
+      describeCommand.execute(config, {
+        image: 'test.jpg',
+        fileId: 'file-123',
+        quiet: false,
+        verbose: false,
+        noColor: true,
+        yes: false,
+        dryRun: true,
+        help: false,
+        nonInteractive: true,
+        async: false,
+      }),
+    ).rejects.toThrow('Conflicting arguments');
+  });
+});
\ No newline at end of file