image-to-video
Skill33 starsChanged 5 months agoMITView on GitHub
以图片驱动生成动态视频,覆盖单图生成、多图参考融合(1–9 图)、首尾帧过渡(1–2 图)。当用户提到图生视频、图片变视频、让图片动起来、照片活化、多图融合、首尾帧、过渡视频、从 A 到 B、把这张图变成视频时触发。
- Reads credentials
15 other projects use a version of this.
Adopted by
Most recently taken up by
- notque/vexjoy-agenttheir own version, first seen Nov 10, 2026
- EvoLinkAI/evolink-agent-skillstheir own version, first seen Nov 8, 2026
- 439436269-ctrl/video-pipeline-skillstheir own version, first seen Oct 15, 2026
- notque/claude-code-toolkittheir own version, first seen Oct 8, 2026
- PrunaAI/pruna-skillstheir own version, first seen Sep 29, 2026
- AngelescuCiprian/claude-skillstheir own version, first seen Aug 22, 2026
Used with
Projects with it also use flux-2-klein, flux-kontext and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
agentspace-soSkillflux-2-klein
Generate images with Flux 2 Klein (Black Forest Labs' distilled fast variant of Flux 2) on RunComfy — bundled with the model's documented prompting patterns so the skill gets sharper output than naive prompting against the same model. Documents Flux 2 Klein's strengths (sub-second latency, multi-reference brand styling, declarative subject-first prompts), the step-count strategy (4–8 for fast iteration, ~25 for polish), the 9B vs 4B variant trade-off, and when to route to Flux 2 Pro / Seedream 5 / GPT Image 2 instead. Calls `runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image` (or `/4b/`) through the local RunComfy CLI. Triggers on "flux 2 klein", "flux-2-klein", "flux klein", "BFL flux 2", or any explicit ask to generate with this model.
Also in 4 projects that use this
agentspace-soSkillflux-kontext
Edit images with Flux 1 Kontext Pro (Black Forest Labs' precise local image-edit model) on RunComfy — bundled with the model's documented prompting patterns so the skill gets sharper output than naive prompting against the same model. Documents Flux Kontext's strengths (single-reference precise local edits, strong prompt control, consistent high-fidelity outputs), the schema (single image + prompt), and when to route to Nano Banana Edit / GPT Image 2 edit / Flux 2 Klein instead. Calls `runcomfy run blackforestlabs/flux-1-kontext/pro/edit` through the local RunComfy CLI. Triggers on "flux kontext", "flux-kontext", "flux 1 kontext", "kontext", "BFL kontext", or any explicit ask to edit with this model.
Also in 4 projects that use this
prime-skillsSkillimage-inpainting
Mask-driven image inpainting on RunComfy via the `runcomfy` CLI. Routes to Tongyi MAI Z-Image Turbo Inpainting (the dedicated inpainting endpoint with mask, strength, and control-scale) and to identity-preserving edit models (Nano Banana 2 Edit, GPT Image 2 Edit, FLUX Kontext Pro) when a mask isn't available and the region must be described instead. Use for object removal, watermark removal, region replacement, blemish cleanup, and any controlled local edit where a binary mask defines the target area. Triggers on "inpaint", "inpainting", "image inpaint", "remove from image", "fill region", "mask-driven edit", "remove watermark", "remove object", "patch the photo", "fill the hole", or any explicit ask to edit a specific masked region of a still.
Also in 4 projects that use this
prime-skillsSkillace-step
Generate, inpaint, and outpaint music with ACE Step on RunComfy via the `runcomfy` CLI. ACE Step is StepFun-AI's open-weights music foundation model — tag-driven composition (genre, mood, instruments), multilingual lyrics with section markers, 5 s to 4 min stereo output, $0.0002–0.0003 per second (≈ 27× cheaper than ElevenLabs Music). Four endpoints: ACE Step text-to-audio (the default), ACE Step 1.5 text-to-audio (50+ language lyrics, refined structured-lyric handling), ACE Step audio-inpaint (regenerate a time range inside an existing track), ACE Step audio-outpaint (extend an existing track before or after). Triggers on "ace step", "ace-step", "acestep", "ACE music", "open music model", "cheap AI music", "inpaint audio", "audio inpaint", "extend music", "audio outpaint", "lengthen track", "music with tags", or any explicit ask to generate or edit music with ACE Step.
Also in 3 projects that use this
- +3 more from agentspace-so
- +5 more from prime-skills
Other versions15 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 15
- notque/vexjoy-agent★ 450same name
- notque/claude-code-toolkit★ 448same name
- eachlabs/skills★ 46same name
- prime-skills/runcomfy-agent-skills★ 41same name
- genmedia-labs/skills★ 26same name
- PrunaAI/pruna-skills★ 20same name
- aiagentwithdhruv/skills★ 16same name
- runcomfy-com/skills★ 16same name
- agentspace-so/runcomfy-skills★ 4same name
- EvoLinkAI/evolink-agent-skills★ 4same name
5 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository55 other files it gives its agents.
- meitu-toolsSkill
- SKILL.mdSkill
- audio-music-generateSkill
- audio-song-generateSkill
- image-background-replaceSkill
- image-cutoutSkill
- image-denoise-enhanceSkill
- image-editSkill
- image-element-removeSkill
- image-face-swapSkill
- image-grid-splitSkill
- image-id-photo-generateSkill
- image-lowlight-enhanceSkill
- image-outfit-swapSkill
- image-portrait-generateSkill
- image-poster-generateSkill
- image-searchSkill
- image-style-transferSkill
- image-superres-enhanceSkill
- image-text-replaceSkill
- image-transformSkill
- meitu-beautySkill
- meitu-carouselSkill
- meitu-cutoutSkill
- meitu-game-2d-assetsSkill
- meitu-id-photoSkill
- meitu-image-adaptSkill
- meitu-image-fixSkill
- meitu-posterSkill
- meitu-product-swapSkill
- meitu-product-viewSkill
- meitu-stickersSkill
- meitu-upscaleSkill
- meitu-video-danceSkill
- meitu-visual-meSkill
- text-code-editSkill
- text-codeSkill
- text-generateSkill
- text-to-imageSkill
- text-to-videoSkill
- video-audio-addSkill
- video-canvas-expandSkill
- video-content-replaceSkill
- video-denoise-enhanceSkill
- video-effect-applySkill
- video-element-removeSkill
- video-framerate-enhanceSkill
- video-logo-addSkill
- video-lowlight-enhanceSkill
- video-motion-transferSkill
- video-multimodal-generateSkill
- video-quality-enhanceSkill
- video-resolution-upscaleSkill
- video-stitchSkill
- video-to-gifSkill
The file
Files
Image to Video
Overview
以图片为驱动生成动态视频。3 类场景:单图生成视频(支持音频/比例/分辨率,默认 toffee 失败兜底 bonbon)、多图参考融合(1–9 图)、首尾帧过渡(1–2 图)。时长 4–15s。
API Mapping
- 单图默认:
video_toffee_i2v_v20 - 单图兜底:
video_bonbon_img2vid_v30(支持智能分镜/多镜头,不支持 aspect_ratio) - 多图参考融合(1–9 图):
video_toffee_mi2v_v20 - 首尾帧过渡(1–2 图):
video_toffee_flf_v20 - mode 映射:
auto(默认)/i2v/mi2v/flf - model 映射:
auto(默认)/toffee/bonbon - mode 与 model 同时指定且冲突时,mode 优先
Dependencies
- meitu-cli:
>=2.0.6 - 凭证:CONFIG AKSK →
meitu tools update;EXEC AKSK → 实际执行(见根CONFIG.md) - 环境变量:
MEITU_OPENAPI_TOOL_TASK_MODE=command
路径别名:
$VISUAL={OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → Execute → DeliverPreflight
meitu --version≥ 2.0.6- 已用 CONFIG AKSK 跑过
meitu tools update - 当前 AKSK = EXEC,
MEITU_OPENAPI_TOOL_TASK_MODE=command - output_dir:openclaw.yaml →
./output/|else →$VISUAL/output/image-to-video/;mkdir -p
Execute
触发信号 / 路由规则
核心维度:mode(优先) → 图片数量 + 意图。
| 条件 | 图片数 | 路由 |
mode=i2v | 任意 | video_toffee_i2v_v20 → 失败兜底 video_bonbon_img2vid_v30 |
mode=mi2v | 任意 | video_toffee_mi2v_v20 |
mode=flf | 任意 | video_toffee_flf_v20 |
mode=auto,1 张,"参考元素/角色/风格" | 1 | video_toffee_mi2v_v20 |
mode=auto,1 张,其他(默认) | 1 | video_toffee_i2v_v20 → 兜底 video_bonbon_img2vid_v30 |
mode=auto,2 张,未说融合(默认) | 2 | video_toffee_flf_v20 |
mode=auto,2 张,说了融合/参考 | 2 | video_toffee_mi2v_v20 |
mode=auto,3–9 张 | 3–9 | video_toffee_mi2v_v20 |
参数定义(统一工具层)
| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
image_list | ARRAY[STRING] | 是 | 1–9 张 | -- | 输入图片 URL 列表 |
prompt | STRING | 是 | -- | -- | 视频内容描述 |
mode | STRING | 否 | auto / i2v / mi2v / flf | auto | 路由模式;与 model 冲突时 mode 优先 |
model | STRING | 否 | auto / toffee / bonbon | auto | 底层模型 |
aspect_ratio | STRING | 否 | adaptive/1:1/3:4/4:3/9:16/16:9/21:9 | adaptive | 画面比例(i2v/mi2v/flf 支持;bonbon 不支持) |
video_duration | NUMBER | 否 | 4–15 | 5 | 时长(秒)。bonbon 默认 5;i2v/mi2v/flf 内部默认 10 |
sound | STRING | 否 | off / on | off | 是否生成音频 |
multi_shot | BOOLEAN | 否 | true/false | true | 多镜头切换(仅 bonbon 生效) |
其余参数(shot_type/resolution/reference_video_list/reference_audio_list 等)由 combo-tool 内部管理,不对外暴露。
API 映射关键点:
video_toffee_i2v_v20:sound→generate_audio(on→true/off→false BOOL),aspect_ratio→ratio,resolution内部默认 720pvideo_bonbon_img2vid_v30:image_list[0]→image_url,sound直传 STRING,aspect_ratio不支持降级时静默丢弃video_toffee_mi2v_v20:image_list直传(≤9),sound→generate_audioBOOLvideo_toffee_flf_v20:image_list1–2 张([0]=首帧,[1]=尾帧可选)
工具调用
meitu image-to-video --image_list <img1>[,<img2>,...] --prompt "<desc>" [--mode auto] [--video_duration 5] [--sound off] [--aspect_ratio adaptive] --json --download-dir {output_dir} --skill_name skill_image-to-video错误降级
| 场景 | 处理方式 |
mode 非法 | 回退 auto |
model 非法 | 回退 auto |
mode=flf 但图片数 >2 | 提示"首尾帧模式最多 2 张图片,当前 {n} 张" |
prompt 缺失 | 提示"请描述你想生成的视频内容" |
| 无图片输入 | 拒绝,能力范围外 |
| 图片数 >9 | 拒绝,能力范围外 |
| 时长 <4s | 钳位到 4s 并告知 |
| 时长 >15s | 钳位 15s |
| 智能分镜 + i2v/mi2v/flf | 静默忽略分镜参数 |
video_toffee_i2v_v20 调用失败 | 降级到 video_bonbon_img2vid_v30(aspect_ratio 丢弃,image_list[0]→image_url) |
| 任一 API 调用失败(含兜底) | 同一 API 重试 1 次 → 仍失败返回错误 |
| 超时(>600s) | 降低时长/尺寸重试 1 次 → 仍失败返回错误 |
| 部分图片不可访问 | 过滤不可访问,用剩余图片重新匹配子能力 |
| 全部图片不可访问 | 返回错误 |
| mode + model 冲突 | mode 优先 |
mode=i2v + 多图 | 取 image_list[0],忽略多余图片 |
| 内容合规拦截 | 直接返回合规提示,不重试、不降级 |
Deliver
- 使用 Preflight 解析的 output_dir
- 从
downloaded_files[0].saved_path读取已下载的视频文件路径 mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-to-video.mp4
Output
- 格式:MP4
- 位置:项目 →
./output/,一次性 →$VISUAL/output/image-to-video/
基线 Task ID
见 references/task-id-baseline.md 中对应行。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

