Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
AI music generation with Suno v4, v4.5, v5. Text-to-music, custom lyrics, instrumental, vocal control. 5 models, one API key.
AI music generation with Suno v4, v4.5, v5. Text-to-music, custom lyrics, instrumental, vocal control. 5 models, one API key.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
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.
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.
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)
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.
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.
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.
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".
ModelQualityMax DurationBest forsuno-v4 (default)Good120sBalanced, economicalsuno-v4.5Better240sStyle controlsuno-v4.5plusBetter240sExtended featuressuno-v4.5allBetter240sAll v4.5 featuressuno-v5Best240sStudio-grade output
If 401 occurs: "Your API key isn't working. Check at evolink.ai/dashboard/keys"
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).
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.
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.
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."
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"
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
Use Evolink's file hosting API for audio uploads (72h expiry). See references/file-api.md for curl commands.
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)
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.