Haimian Music AI Song Generator

Integrating Music Generation into AI Workflows

Creators often need customized music for videos, content, or presentations, but switching to dedicated audio software breaks their creative flow. The core problem is embedding music generation capabilities directly into a conversational AI environment, eliminating the friction of tool-switching. The Haimian Music Skill addresses this via a Command-Line Interface (CLI) tool named aimv, allowing you to trigger music generation, downloading, and management directly within a conversation using natural language descriptions.

Core Capabilities and How It Works

The skill offers three primary music generation modes, each mapped to a specific CLI command:

• AI Song Creation / Lyrics-to-Song: Use aimv song create. Provide descriptions of style, mood, lyrics, or usage scenario. The tool invokes a backend model to generate two candidate songs. Upon completion, you receive preview links, download links, and a project management URL.
• BGM Generation: Use aimv bgm create. Ideal for generating instrumental background tracks for specific content like product launches or short videos.
• Reference Audio Adaptation: Use aimv reference create. Upload an audio file as a reference to generate similar-sounding but original work. This requires a prior upload via aimv reference upload.

Key steps revolve around authentication and project management:
1. Initialization: On first use, run node /bin/aimv.js init. The tool outputs a connect_url. The user must log in on the webpage (new users auto-register) to obtain an API Key. This Key is used for all subsequent authentications and is long-lived.
2. Generation and Querying: After executing a generation command, tasks may be processed asynchronously. Use aimv session tail to check the status of recent projects and songs.
3. Status Handling and Error Recovery: The CLI returns structured error codes. For example, code=auth_required necessitates re-authentication; code=insufficient_points or code=quota_limited require visiting a pay_url to top up credits or upgrade membership; code=wait_timeout indicates the task is still processing in the background. Handling these states is crucial for a smooth workflow.

Scope and Considerations

• Account and Resource Interoperability: Generated works, credits, and membership status sync completely with the "海绵音乐AI写歌" WeChat Mini Program and lexuan.club website. Works generated on any platform can be managed on the others.
• Environmental Dependencies: The skill operates via a local Node.js CLI (bin/aimv.js), not an MCP server. Therefore, the runtime environment requires Node.js and the ability to execute shell commands. In restricted sandboxes, you can set the environment variable AIMV_FORCE_CURL=1 to force curl as the network transport layer, or in completely restricted cases, call the API directly with curl.
• Generation Logic: For song creation, each request always returns two candidate songs, both of which must be presented to the user. This provides creators with options for comparison and selection.