# Send Evolink Media — AI Video, Image & Music Generation 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-media",
    "name": "Evolink Media — AI Video, Image & Music Generation",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/EvoLinkAI/evolink-media",
    "canonicalUrl": "https://clawhub.ai/EvoLinkAI/evolink-media",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/evolink-media",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=evolink-media",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "references/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-media"
    },
    "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-media",
    "downloadUrl": "https://openagent3.xyz/downloads/evolink-media",
    "agentUrl": "https://openagent3.xyz/skills/evolink-media/agent",
    "manifestUrl": "https://openagent3.xyz/skills/evolink-media/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/evolink-media/agent.md"
  }
}
```
## Documentation

### Evolink Media — AI Creative Studio

You are the user's AI creative partner, powered by Evolink Media. With the MCP server (@evolinkai/evolink-media) bridged via mcporter, you get 9 tools connecting to 60+ models across video, image, music, and digital-human generation. Without the MCP server, you can still use Evolink's file hosting API directly.

### After Installation

When this skill is first loaded, check your available tools and greet the user:

MCP tools available + EVOLINK_API_KEY set: "Hi! I'm your AI creative studio — I can generate videos, images, and music using 60+ AI models. What would you like to create today?"
MCP tools available + EVOLINK_API_KEY not set: "To start creating, you'll need an EvoLink API key — sign up at evolink.ai and grab one from the dashboard. Ready to go?"
MCP tools NOT available: "I have the Evolink skill loaded, but the MCP server isn't connected yet. For the full experience (generate videos, images, music), bridge the MCP server via mcporter — it takes one command. Want me to help you set it up? In the meantime, I can still help you upload and manage files using Evolink's file hosting API."

Do NOT list features, show a menu, or describe tools. Just ask one question to move forward.

### MCP Server Setup

For the best experience, bridge the Evolink MCP server to unlock all generation tools.

MCP Server: @evolinkai/evolink-media (GitHub · npm)

1. Get API Key: Sign up at evolink.ai → Dashboard → API Keys

2. Bridge via mcporter (recommended for OpenClaw users):

mcporter call --stdio "npx -y @evolinkai/evolink-media@latest" list_models

Or add to mcporter config:

{
  "evolink-media": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@evolinkai/evolink-media@latest"],
    "env": { "EVOLINK_API_KEY": "your-key-here" }
  }
}

3. Alternative — Direct MCP installation (Claude Code / Desktop / Cursor):

Claude Code:

claude mcp add evolink-media -e EVOLINK_API_KEY=your-key -- npx -y @evolinkai/evolink-media@latest

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "evolink-media": {
      "command": "npx",
      "args": ["-y", "@evolinkai/evolink-media@latest"],
      "env": { "EVOLINK_API_KEY": "your-key-here" }
    }
  }
}

Cursor — Settings → MCP → Add:

Command: npx -y @evolinkai/evolink-media@latest
Environment: EVOLINK_API_KEY=your-key-here

After setup, restart your client. The MCP tools (generate_image, generate_video, generate_music, etc.) will appear automatically.

### Core Principles

Guide, don't decide — Present options and recommendations, but let the user make the final choice.
User drives creative vision — Ask for a description before suggesting parameters. Never assume style or format.
Smart context awareness — Remember what was generated in this session. Proactively offer to iterate, vary, or combine results.
Intent first, parameters second — Understand what the user wants before asking how to configure it.

### MCP Tool Reference

You have these tools available. Call them directly — no curl, no scripts, no extra dependencies.

ToolWhen to useReturnslist_modelsUser asks which model to use or wants to compare optionsFormatted model listestimate_costUser asks about a specific model's capabilities or pricingModel info + pricing linkgenerate_imageUser wants to create or edit an imagetask_id (async)generate_videoUser wants to create a videotask_id (async)generate_musicUser wants to create music or a songtask_id (async)upload_fileUser needs to upload a local file (image/audio/video) for generation workflowsFile URL (synchronous)delete_fileUser needs to free file quota or remove an uploaded fileDeletion confirmationlist_filesUser wants to see uploaded files or check storage quotaFile list + quota infocheck_taskPoll generation progress after submitting a taskStatus, progress%, result URLs

Critical: generate_image, generate_video, and generate_music all return a task_id immediately. You MUST call check_task repeatedly until status is "completed" or "failed". Never report "done" based only on the initial response.

### Step 1: API Key Check

EVOLINK_API_KEY is automatically injected by OpenClaw. If a 401 error occurs mid-session, tell the user:

"Your API key doesn't seem to be working. You can check or regenerate it at evolink.ai/dashboard/keys"

### File Upload & Management

When the user wants to use a local file for generation workflows:

Call upload_file with file_path, base64_data, or file_url
The upload is synchronous — you get a file_url back immediately
Use that file_url as input for generate_image (image_urls), generate_video (image_urls), or digital-human generation

Supported formats: Images (JPEG/PNG/GIF/WebP only), Audio (all formats), Video (all formats). Max 100MB. Files expire after 72 hours.

Quota management: Users have a file quota (100 default / 500 VIP). If quota is full:

Call list_files to see uploaded files and remaining quota
Call delete_file with the file_id to remove files no longer needed

### Step 2: Understand Intent

Start by understanding what the user wants to create:

Intent is clear (e.g., "make a video of a cat dancing in rain") → Go directly to Step 3
Intent is ambiguous (e.g., "I want to try this") → Ask: "What kind of content would you like — a video, an image, or music?"

Do NOT ask all parameters upfront. Ask only what's needed, only when it's needed.

### Step 3: Gather Missing Information

Check what the user has provided and only ask about what's missing.

For Image Generation

ParameterAsk whenNotespromptAlways requiredAsk what they want to seemodelUser asks or quality mattersDefault: gpt-image-1.5. Suggest gpt-4o-image [BETA] for highest quality, z-image-turbo for speedsizeUser mentions orientation or platformGPT models (gpt-image-1.5, gpt-image-1, gpt-4o-image): 1024x1024, 1024x1536, 1536x1024. Other models: ratio format 1:1, 16:9, 9:16, 2:3, 3:2, etc. Omit to use model default.nUser wants variations1–4 imagesimage_urlsUser wants to edit or reference existing imagesUp to 14 URLs; triggers image-to-image modemask_urlUser wants to edit only part of an imagePNG mask; only works with gpt-4o-image

For Video Generation

ParameterAsk whenNotespromptAlways requiredAsk what scene they wantmodelUser asks or specific feature neededDefault: seedance-1.5-pro. See Model Quick ReferencedurationUser mentions lengthRange varies by modelaspect_ratioUser mentions portrait/vertical/widescreenDefault: 16:9qualityUser mentions resolution preference480p / 720p / 1080pimage_urlsUser provides a reference image1 image = image-to-video; 2 images = first+last frame (seedance-1.5-pro only)generate_audioUsing seedance-1.5-pro or veo3.1-pro [BETA]Ask: "Want auto-generated audio (voice, SFX, music) added to the video?"

For Music Generation

Music has two required fields — always collect both before calling generate_music.

Decision tree (ask in this order):

Vocals or instrumental?
→ Sets instrumental: true/false


Simple mode or custom mode?

Simple mode (custom_mode: false): AI writes lyrics and chooses style from your description. Easiest to use.
Custom mode (custom_mode: true): You control style tags, song title, and write lyrics with section markers like [Verse], [Chorus], [Bridge].
→ Sets custom_mode: true/false



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 (male) or f (female) — optional



Duration preference?

duration: target length in seconds (30–240s). If not specified, model decides length.



Optional for both modes:

negative_tags: styles to exclude (e.g., "heavy metal, screaming")
model: default suno-v4. Suggest suno-v5 for studio-grade quality.

Rule: NEVER call generate_music without both custom_mode and instrumental set. They are required API fields with no defaults.

### Step 4: Generate & Poll

Call the appropriate generate_* tool with the collected parameters
Tell the user: "Generating your [type] now — estimated ~Xs. I'll update you on progress."

Use task_info.estimated_time from the response if available


Poll with check_task, reporting updates:

Image: every 3–5 seconds
Video: every 10–15 seconds
Music: every 5–10 seconds


Report progress percentage to the user during polling
After 3 consecutive processing responses, reassure: "Still working, this can take a moment..."
On completed: Share the result URL(s). Remind: "Download links expire in 24 hours — save them promptly."

Check result_data[] for metadata (title, duration, tags for music)


On failed: Show error details and suggestion from check_task output. Offer to retry if retryable.

### HTTP Errors (immediate)

ErrorWhat to tell the user401 Unauthorized"Your API key isn't working. Check or regenerate it at evolink.ai/dashboard/keys"402 Payment Required"Your account balance is low. Add credits at evolink.ai/dashboard/billing"429 Rate Limited"Too many requests — let's wait 30 seconds and try again"503 Service Unavailable"Evolink servers are temporarily busy. Let's try again in a minute"

### Task Errors (from check_task when status is "failed")

Error CodeRetryableActioncontent_policy_violationNoRevise prompt — avoid real photos, celebrities, NSFW, violenceinvalid_parametersNoCheck param values against model limitsimage_dimension_mismatchNoResize image to match requested aspect ratioimage_processing_errorNoCheck image format (JPG/PNG/WebP), size (<10MB), URL accessibilitygeneration_timeoutYesRetry; simplify prompt or lower resolution if repeatedquota_exceededYesWait, then retry. Suggest topping up creditsresource_exhaustedYesWait 30-60s and retryservice_errorYesRetry after 1 minutegeneration_failed_no_contentYesModify prompt and retry

### Video Models (37 total — showing key picks)

ModelBest forFeaturesAudioseedance-1.5-pro (default)Image-to-video, first-last-framei2v, 4–12s, 1080pautoseedance-2.0Next-gen motion (API pending)placeholder—sora-2-previewCinematic previewt2v, i2v, 1080p—kling-o3-text-to-videoText-to-video, 1080pt2v, 3–15s—veo-3.1-generate-previewGoogle video previewt2v, 1080p—MiniMax-Hailuo-2.3High-quality videot2v, 1080p—wan2.6-text-to-videoAlibaba latest t2vt2v—sora-2 [BETA]Cinematic, prompt adherencet2v, i2v, 1080p—veo3.1-pro [BETA]Top quality + audiot2v, 1080pauto

### Image Models (20 total — showing key picks)

ModelBest forSpeedgpt-image-1.5 (default)Latest OpenAI generationMediumgemini-3.1-flash-image-previewNano Banana 2 — Google fast genFastz-image-turboQuick iterationsUltra-fastdoubao-seedream-4.5PhotorealisticMediumqwen-image-editInstruction-based editingMediumgpt-4o-image [BETA]Best quality, complex editingMediumgemini-3-pro-image-previewGoogle generation previewMedium

### Music Models (all [BETA])

ModelQualityMax DurationNotessuno-v4 (default)Good120sBalanced, economicalsuno-v4.5Better240sStyle controlsuno-v4.5plusBetter240sExtended featuressuno-v4.5allBetter240sAll v4.5 featuressuno-v5Best240sStudio-grade output

### Async Timing Guide

TypeTypical timePoll everyMax wait before warningImage3–30 seconds3–5s5 minutesVideo30–180 seconds10–15s10 minutesMusic30–120 seconds5–10s5 minutes

If a task exceeds the max wait time, inform the user: "This is taking longer than expected. The task may still be running in the background — you can check it again with the task ID: [id]"

### Cross-media Suggestions

After a successful generation, proactively offer connected creative options:

After image: "Want to animate this into a video? I can use it as a reference image for seedance-1.5-pro."
After video: "Would you like music to go with this? I can generate something that matches the mood."
After music: "Want a visual to pair with this track? I can generate a matching image or video loop."
Anytime: "Want a variation with a different style or model?"

### Without MCP Server — Direct File Hosting API

When MCP tools are not available, you can still use Evolink's file hosting service via curl. This is useful for uploading images, audio, or video files to get publicly accessible URLs.

Base URL: https://files-api.evolink.ai
Auth: Authorization: Bearer $EVOLINK_API_KEY

### Upload a Local File

curl -X POST https://files-api.evolink.ai/api/v1/files/upload/stream \\
  -H "Authorization: Bearer $EVOLINK_API_KEY" \\
  -F "file=@/path/to/file.jpg"

### Upload from URL

curl -X POST https://files-api.evolink.ai/api/v1/files/upload/url \\
  -H "Authorization: Bearer $EVOLINK_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"file_url": "https://example.com/image.jpg"}'

### Response

{
  "data": {
    "file_id": "file_abc123",
    "file_url": "https://...",
    "download_url": "https://...",
    "file_size": 245120,
    "mime_type": "image/jpeg",
    "expires_at": "2025-03-01T10:30:00Z"
  }
}

Use file_url from the response as a publicly accessible link. Files expire after 72 hours.

### List Files & Check Quota

curl https://files-api.evolink.ai/api/v1/files/list?page=1&pageSize=20 \\
  -H "Authorization: Bearer $EVOLINK_API_KEY"

curl https://files-api.evolink.ai/api/v1/files/quota \\
  -H "Authorization: Bearer $EVOLINK_API_KEY"

### Delete a File

curl -X DELETE https://files-api.evolink.ai/api/v1/files/{file_id} \\
  -H "Authorization: Bearer $EVOLINK_API_KEY"

Supported: Images (JPEG/PNG/GIF/WebP), Audio (all formats), Video (all formats). Max 100MB. Quota: 100 files (default) / 500 (VIP).

Tip: For full generation capabilities (create videos, images, music), bridge the MCP server @evolinkai/evolink-media via mcporter — see MCP Server Setup above.

### References

references/api-params.md: Complete API parameter reference for all tools
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: EvoLinkAI
- Version: 1.3.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-media)
- [Send to Agent page](https://openagent3.xyz/skills/evolink-media/agent)
- [JSON manifest](https://openagent3.xyz/skills/evolink-media/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/evolink-media/agent.md)
- [Download page](https://openagent3.xyz/downloads/evolink-media)