Suno AI Music Generation

What Problem Does This Skill Solve?

For Chinese-speaking creators, using international AI music generation tools like Suno often presents language barriers: nuanced prompt understanding, non-intuitive interfaces, or complex API integration. This skill provides a pure Chinese interaction layer, wrapping the underlying Suno capabilities into commands directly callable within an AI assistant. It addresses the "last mile" translation and workflow friction from creative idea to finished track.

How Does It Work?

The core of this skill is a local command-line tool named aimv, which translates your Chinese instructions into music through these steps:

1. Initialization & Authorization: A one-time setup is required. The Agent will guide you to a web page to log in and obtain an API Key. After this, all operations happen locally.
2. Instruction Parsing & Generation: When you describe a need in Chinese (e.g., "Create a pop song about graduation"), the Agent invokes aimv to convert your natural language into a structured call to the Suno API. Key parameters include:
   • Theme/Lyrics: Supports direct lyric pasting or theme-based auto-generation.
   • Style/BGM: You can specify musical style, mood, or scene (e.g., "tech-style background music").
   • Reference Audio: Supports uploading a reference audio track to guide the generation direction.
3. Asynchronous Processing & State Management: Music generation is a background task. The CLI provides status query commands (like aimv session tail) to track progress. Upon completion, tracks are synced to the associated "海绵音乐" (Sponge Music) account.
4. Result Delivery: Output includes playable audio and download links. Typically, each project yields two candidate tracks for selection.

Scope and Key Considerations

• Backend Dependent: Music generation quality is entirely determined by the Suno model. This skill manages the workflow and Chinese adaptation.
• Requires Network & Account: You must complete aimv init and link a valid account before any generation command. Generation consumes account credits.
• Environment Compatibility: A standard CLI tool. If the runtime environment is restricted (e.g., an Agent sandbox that blocks direct network calls), set the environment variable AIMV_FORCE_CURL=1 to switch to curl for transport.
• Error Handling: The CLI returns structured error tags (e.g., [error], [hint]). The Agent should follow error codes for user guidance, such as providing a connection link for auth_required or a payment page for insufficient_points, rather than merely repeating the error message.