javimosch Evolink Video — AI Video Generation
Generate AI videos with 37 models including Sora, Kling, Veo 3, Seedance, Hailuo, WAN, and Grok — text-to-video, image-to-video, first-last-frame, and audio generation. All through one API.
Video-focused view of evolink-media. Install the full skill for image and music too.
After Installation
When this skill is first loaded, greet the user:
- MCP tools + API key ready: "Hi! I'm your AI video studio — 37 models 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
| Service | URL |
|---|---|
| Generation API | https://api.evolink.ai/v1/videos/generations (POST) |
| Task Status | https://api.evolink.ai/v1/tasks/{task_id} (GET) |
| File API | https://files-api.evolink.ai/api/v1/files/* (upload/list/delete) |
Security & Privacy
EVOLINK_API_KEYauthenticates all requests. Injected by OpenClaw automatically. Treat as confidential.- Prompts and images 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/video-api-params.md for full config JSON.
Core Principles
- Guide, don't decide — Present options, let the user choose model/style/duration.
- User drives creative vision — Ask for a description before suggesting parameters.
- Smart context — Remember session history. Offer to iterate, extend, or remix results.
- Intent first — Understand what the user wants before asking how to configure it.
MCP Tools
| Tool | When to use | Returns |
|---|---|---|
generate_video |
Create a video from text or images | task_id (async) |
upload_file |
Upload image for i2v or reference | File URL (sync) |
delete_file |
Free file quota | Confirmation |
list_files |
Check uploaded files or quota | File list |
check_task |
Poll generation progress | Status + result URLs |
list_models |
Compare available models | Model list |
estimate_cost |
Check pricing | Model info |
Important: generate_video returns a task_id. Always poll check_task until status is "completed" or "failed".
Video Models (37)
Top Picks
| Model | Best for | Features | Audio |
|---|---|---|---|
seedance-1.5-pro (default) |
i2v, first-last-frame | i2v, 4–12s, 1080p | auto |
sora-2-preview |
Cinematic preview | t2v, i2v, 1080p | — |
kling-o3-text-to-video |
Text-to-video | t2v, 3–15s, 1080p | — |
veo-3.1-generate-preview |
Google video preview | t2v, 1080p | — |
MiniMax-Hailuo-2.3 |
High-quality video | t2v, 1080p | — |
wan2.6-text-to-video |
Alibaba latest t2v | t2v | — |
sora-2 [BETA] |
Cinematic, prompt adherence | t2v, i2v, 1080p | — |
veo3.1-pro [BETA] |
Top quality + audio | t2v, 1080p | auto |
26 Stable — Seedance (3), Sora Preview (1), Kling (10), Veo 3.1 (2), Hailuo (3), WAN (7) 11 Beta — Sora 2/Pro/Max/Character (4), Veo 3/3.1 (5), Grok Imagine (2)
Full model list with descriptions: references/video-api-params.md
Generation Flow
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 image-to-video or first-last-frame workflows:
upload_filewithfile_path,base64_data, orfile_url→ getfile_url(sync)- Use
file_urlasimage_urlsforgenerate_video
Supported: JPEG/PNG/GIF/WebP. Max 100MB. Expire in 72h. Quota: 100 (default) / 500 (VIP).
Step 3: Understand Intent
- Clear ("make a video of a cat dancing") → Go to Step 4
- Ambiguous ("I want a video") → Ask: "Text-to-video, or do you have a reference image to animate?"
Ask only what's needed, when it's needed.
Step 4: Gather Parameters
Only ask about what's missing:
| Parameter | Ask when | Notes |
|---|---|---|
| prompt | Always | Scene description |
| model | Specific feature needed | Default seedance-1.5-pro. See Top Picks for alternatives |
| duration | User mentions length | Range varies by model (4–15s typical) |
| aspect_ratio | Portrait/widescreen | Default 16:9. Options: 9:16, 1:1, 4:3, 3:4, 21:9 |
| quality | Resolution preference | 480p / 720p / 1080p / 4k |
| image_urls | Reference image provided | 1 image = i2v; 2 images = first+last frame (seedance-1.5-pro only) |
| generate_audio | Using seedance/veo3.1 | Ask: "Want auto-generated audio added?" |
Step 5: Generate & Poll
- Call
generate_video→ tell user: "Generating your video — ~Xs estimated." - Poll
check_taskevery 10–15s. Report progress %. - After 3 consecutive
processing: "Still working — video generation takes a moment..." - Completed: Share URLs. "Links expire in 24h — save promptly."
- Failed: Show error + suggestion. Offer retry if retryable.
- Timeout (10 min): "Taking longer than expected. Task ID:
{id}— check again later."
Error Handling
HTTP Errors
| Error | Action |
|---|---|
| 401 | "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")
| Code | Retry? | Action |
|---|---|---|
content_policy_violation |
No | Revise prompt (no celebrities, NSFW, violence) |
invalid_parameters |
No | Check values against model limits |
image_dimension_mismatch |
No | Resize image to match aspect ratio |
image_processing_error |
No | Check format/size/URL accessibility |
generation_timeout |
Yes | Retry; simplify prompt if repeated |
quota_exceeded |
Yes | Top up credits |
resource_exhausted |
Yes | Wait 30–60s, retry |
service_error |
Yes | Retry after 1 min |
generation_failed_no_content |
Yes | Modify prompt, retry |
Full error reference: references/video-api-params.md
Without MCP Server
Use Evolink's file hosting API for image uploads (72h expiry). See references/file-api.md for curl commands.
References
references/video-api-params.md— Complete API parameters, all 37 models, polling strategy, error codesreferences/file-api.md— File hosting API (curl upload/list/delete)