# Send Evolink Music — AI Music Generation (Suno v4/v4.5/v5) to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "evolink-music", "name": "Evolink Music — AI Music Generation (Suno v4/v4.5/v5)", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/EvoLinkAI/evolink-music", "canonicalUrl": "https://clawhub.ai/EvoLinkAI/evolink-music", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/evolink-music", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=evolink-music", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/file-api.md", "references/music-api-params.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/evolink-music" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/evolink-music", "downloadUrl": "https://openagent3.xyz/downloads/evolink-music", "agentUrl": "https://openagent3.xyz/skills/evolink-music/agent", "manifestUrl": "https://openagent3.xyz/skills/evolink-music/agent.json", "briefUrl": "https://openagent3.xyz/skills/evolink-music/agent.md" } } ``` ## Documentation ### Evolink Music — AI Music Generation Generate AI music and songs with Suno v4, v4.5, and v5 — simple mode (describe and generate) or custom mode (lyrics, style, tempo, vocals). All through one API. Music-focused view of evolink-media. Install the full skill for video and image too. ### After Installation When this skill is first loaded, greet the user: MCP tools + API key ready: "Hi! I'm your AI music studio — Suno v4 through v5 ready. What would you like to create?" MCP tools + no API key: "You'll need an EvoLink API key — sign up at evolink.ai. Ready to go?" No MCP tools: "MCP server isn't connected yet. Want me to help set it up? I can still manage files via the hosting API." Keep the greeting concise — just one question to move forward. ### External Endpoints ServiceURLGeneration APIhttps://api.evolink.ai/v1/audios/generations (POST)Task Statushttps://api.evolink.ai/v1/tasks/{task_id} (GET)File APIhttps://files-api.evolink.ai/api/v1/files/* (upload/list/delete) ### Security & Privacy EVOLINK_API_KEY authenticates all requests. Injected by OpenClaw automatically. Treat as confidential. Prompts and audio are sent to api.evolink.ai. Uploaded files expire in 72h, result URLs in 24h. ### Setup Get your API key at evolink.ai → Dashboard → API Keys. MCP Server: @evolinkai/evolink-media (GitHub · npm) mcporter (recommended): mcporter call --stdio "npx -y @evolinkai/evolink-media@latest" list_models Claude Code: claude mcp add evolink-media -e EVOLINK_API_KEY=your-key -- npx -y @evolinkai/evolink-media@latest Claude Desktop / Cursor — add MCP server with command npx -y @evolinkai/evolink-media@latest and env EVOLINK_API_KEY=your-key. See references/music-api-params.md for full config JSON. ### Core Principles Guide, don't decide — Present options, let the user choose model/style/mood. User drives creative vision — Ask for a description before suggesting parameters. Smart context — Remember session history. Offer to iterate, vary styles, or remix. Intent first — Understand what the user wants before asking how to configure it. ### MCP Tools ToolWhen to useReturnsgenerate_musicCreate AI music or songstask_id (async)upload_fileUpload audio for continuation/remixFile URL (sync)delete_fileFree file quotaConfirmationlist_filesCheck uploaded files or quotaFile listcheck_taskPoll generation progressStatus + result URLslist_modelsCompare available modelsModel listestimate_costCheck pricingModel info Important: generate_music returns a task_id. Always poll check_task until status is "completed" or "failed". ### Music Models (5, all BETA) ModelQualityMax DurationBest forsuno-v4 (default)Good120sBalanced, economicalsuno-v4.5Better240sStyle controlsuno-v4.5plusBetter240sExtended featuressuno-v4.5allBetter240sAll v4.5 featuressuno-v5Best240sStudio-grade output ### Step 1: API Key Check If 401 occurs: "Your API key isn't working. Check at evolink.ai/dashboard/keys" ### Step 2: File Upload (if needed) For audio continuation or remix workflows: upload_file with file_path, base64_data, or file_url → get file_url (sync) Supported: Audio (MP3, WAV, FLAC, AAC, OGG, M4A, etc.). Max 100MB. Expire in 72h. Quota: 100 (default) / 500 (VIP). ### Step 3: Understand Intent Clear ("make a chill lo-fi beat") → Go to Step 4 Ambiguous ("I want some music") → Ask: "What kind of vibe or genre? Vocals or instrumental?" Ask only what's needed, when it's needed. ### Step 4: Gather Parameters Music has two required fields with no defaults — always collect both before calling generate_music. Decision tree (ask in this order): Vocals or instrumental? → Sets instrumental: true/false Simple or custom mode? Simple (custom_mode: false): AI writes lyrics and picks style from your description Custom (custom_mode: true): You control lyrics ([Verse]/[Chorus]/[Bridge]), style tags, title If custom mode, additionally collect: style: genre + mood + tempo tags (e.g., "pop, upbeat, female vocals, 120bpm") title: song name (max 80 chars) vocal_gender: m or f — optional Optional for both modes: duration: target length 30–240s (omit to let model decide) negative_tags: styles to exclude model: default suno-v4. Suggest suno-v5 for studio-grade quality. Critical: Both custom_mode and instrumental are required API fields with no defaults. Always set both before generating. ### Step 5: Generate & Poll Call generate_music → tell user: "Generating your music — ~Xs estimated." Poll check_task every 5–10s. Report progress %. After 3 consecutive processing: "Still working..." Completed: Share URLs + metadata (title, duration, tags from result_data[]). "Links expire in 24h — save promptly." Failed: Show error + suggestion. Offer retry if retryable. Timeout (5 min): "Taking longer than expected. Task ID: {id} — check again later." ### HTTP Errors ErrorAction401"API key isn't working. Check at evolink.ai/dashboard/keys"402"Balance is low. Add credits at evolink.ai/dashboard/billing"429"Rate limited — wait 30s and retry"503"Servers busy — retry in a minute" ### Task Errors (status: "failed") CodeRetry?Actioncontent_policy_violationNoRevise prompt or lyricsinvalid_parametersNoCheck values against model limitsgeneration_timeoutYesRetry; simplify prompt if repeatedquota_exceededYesTop up creditsresource_exhaustedYesWait 30–60s, retryservice_errorYesRetry after 1 mingeneration_failed_no_contentYesModify prompt, retry Full error reference: references/music-api-params.md ### Without MCP Server Use Evolink's file hosting API for audio uploads (72h expiry). See references/file-api.md for curl commands. ### References references/music-api-params.md — Complete API parameters, all 5 models, polling strategy, error codes references/file-api.md — File hosting API (curl upload/list/delete) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: EvoLinkAI - Version: 2.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/evolink-music) - [Send to Agent page](https://openagent3.xyz/skills/evolink-music/agent) - [JSON manifest](https://openagent3.xyz/skills/evolink-music/agent.json) - [Markdown brief](https://openagent3.xyz/skills/evolink-music/agent.md) - [Download page](https://openagent3.xyz/downloads/evolink-music)