Suno AI Songwriting

Problems to Solve

In daily content creation, creators often face the pain point of having a theme or lyrics but lacking music production skills, or facing a high barrier to tools. Whether preparing a catchy BGM for short videos or turning Chinese lyrics into a complete pop song, manual web operations often require frequent tab-switching and parameter copying, making it hard to seamlessly complete the task within an AI chat flow. This skill aims to eliminate such friction, allowing the AI agent to take over the entire process from text/reference audio to previewable and downloadable songs. The generated works are automatically synced to the Haimian Music account for further management via the mini-program or web portal.

Core Capabilities and Key Steps

• Local CLI Driven: This skill is based on a generic Node CLI (recommended tool name aimv, entry bin/aimv.js) rather than an MCP server. The agent can directly execute initialization, generation, query, and download commands in the Shell without requiring users to manually copy commands or open web pages (unless lacking execution permissions).
• Initial Connection: If not logged in, the agent runs node /bin/aimv.js init to get the connect_url. After the user logs in (auto-registration for new users) and copies the API Key, the agent executes node /bin/aimv.js init --api-key <key> to complete a long-term valid connection.
• Trigger and Generation: When users mention "suno songwriting", "AI song generation", "lyrics to song", or specify Suno-related needs, the agent can call logical commands like aimv song create or directly run the CLI with themes, lyrics, styles, or reference audio to obtain two candidate songs.
• Structured Error Handling: The CLI outputs [error] and [hint] tags. The agent must guide based on the code:
• auth_required: Send the connection link to guide the user to get the Key.
• insufficient_points (402) or quota_limited (429): Send pay_url to guide users to recharge or upgrade membership.
• wait_timeout / reference_not_ready: Prompt that the task is still running in the background or assets are not ready; check status later.
• not_found: Suggest using aimv session tail to search recent projects.

Boundaries and Cautions

• Restricted Sandbox Environments: If the agent runs in a sandbox that only allows whitelisted tools like curl, causing aimv to report network errors or HTTP 400, it is recommended to first set the environment variable AIMV_FORCE_CURL=1 to force the CLI to use system curl for transmission. If the CLI is completely unavailable, direct curl calls to the API are required for generation and authentication, with the response envelope format consistent with the CLI.
• Account System Binding: Accounts, credits, memberships, and song libraries are integrated with the Haimian Music ecosystem. Generating songs consumes corresponding credits, and hitting the limit requires recharging or upgrading membership via the web portal.
• Candidate Result Display: Each generation project outputs exactly two candidate songs. The agent must present both results completely to the user without omission.