Suno AI Music

The Problem It Solves

Many music creators face challenges when attempting to generate songs, lyrics-to-music, or background music (BGM) in Chinese, such as complex tool integration, insufficient language support, or fragmented management. For instance, using international services like Suno AI may lack optimized Chinese prompts, leading to subpar generation results; or generated audio files might be difficult to manage cohesively, hindering applications in short videos, brand content, and other scenarios. Specific pain points include efficiently transforming Chinese themes into auditable music and handling errors and account synchronization during generation.

How It Works: Core Capabilities and Key Steps

This skill encapsulates Suno AI's music generation capabilities through a local CLI tool aimv, offering the following core features:

• Chinese Prompt and Generation Support: Allows users to input Chinese song themes, lyrics, styles, or reference audio to generate music works directly. The generation capability is powered by Suno, but optimized for Chinese scenarios.
• Key Steps:
  1. Initialize Connection: On first use, run node /bin/aimv.js init; the CLI outputs a connection link (e.g., https://lexuan.club/skills/connect?slug=suno-ai-pro). After the user logs in on the Haimian Music web page and copies the API Key, execute init --api-key to complete the connection. The API Key is long-term valid and requires only one-time setup.
  2. Music Generation: Use commands like aimv song create or aimv bgm create, specifying parameters such as --theme, --lyrics, --style; alternatively, run node /bin/aimv.js followed by relevant arguments. Generated works are synced to the Haimian Music account, manageable on the "Haimian Music AI Songwriting" mini-program or lexuan.club web page.
  3. Error Handling: The CLI outputs structured tags like [error] and [hint]. Agents should handle these based on tags; for example, code=auth_required prompts the user to log in to obtain an API Key, while code=insufficient_points provides a top-up link.

The tool interacts with APIs behind the scenes, using a response format { "code": 0, "data": ... }; in restricted environments, setting AIMV_FORCE_CURL=1 can force transmission via the system curl.

Applicable Boundaries and Considerations

• Environment Limitations: In Agent sandboxes, if the CLI reports network errors, first try setting AIMV_FORCE_CURL=1; if the CLI is completely unavailable, direct API calls via curl are possible but require handling auth headers and response parsing.
• Generation Rules: Each project defaults to generating two candidate songs, which must all be presented to the user; reference audio uploads need specified endpoints (e.g., https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload).
• Account and Points: The skill integrates with the Haimian Music account; connection and sufficient points are required before generation. For error codes like 402 or 429, guide users to top up via pay_url or subscribe for higher quotas.
• Applicable Scenarios: Suitable for Chinese song creation and BGM generation, but does not require manual web operation unless the agent lacks command execution permissions. Not intended for non-music generation tasks.