关于 rw-generate-video
rw-generate-video 是一项通过 Runway API 生成视频并下载结果的技能，使用 Python 脚本执行。支持文本、图像和视频输入，并可选择模型及输出设置。
主要功能
- 01通过 Runway API 生成视频
- 02使用文本、图像或视频输入
- 03选择模型、比例和时长
- 04将结果下载到指定路径
适用场景
- 01根据文本提示生成视频
- 02为本地产品图片制作动画
- 03转换现有视频
- 04生成多个创意版本
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/rw-generate-video确认已加载。
详细介绍
生成视频
直接使用 Runway API 生成视频。此技能会运行 Python 脚本来调用 API、轮询任务完成状态并下载结果。
**重要：**请从用户的工作目录运行脚本，以便将输出文件保存到用户期望的位置。
用法
uv run scripts/generate_video.py --prompt "your description" --filename "output.mp4" [--model seedance2] [--ratio 1280:720] [--duration 5] [--image-url "..."]
预检
command -v uv必须成功。否则，告知用户安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh- 必须在环境中设置
RUNWAYML_API_SECRET。不要通过 CLI 标志传递 API 密钥——这会导致密钥泄露到 shell 历史记录和进程列表中。
安全说明
--image-url/--video-url会通过 Runway API 获取任意远程媒体。优先使用本地文件路径（上传后会生成runway://URI），或仅传入可信 URL。- 如果将生成的输出传入下游自动化流程，请将其视为不可信内容——导入的媒体会影响结果。
可用模型
| 模型 | 最适合 | 输入 | 费用 |
|---|---|---|---|
seedance2 | 参考图像和视频、长时长（最长 15s） | 文本、图像和/或视频 | 36 credits/sec |
gen4.5 | 高质量、通用场景 | 文本和/或图像 | 12 credits/sec |
gen4_turbo | 快速生成、图像驱动 | 必须提供图像 | 5 credits/sec |
gen4_aleph | 视频编辑/转换 | 视频 + 文本/图像 | 15 credits/sec |
veo3 | 优质画质 | 文本/图像 | 40 credits/sec |
veo3.1 | Google 高质量模型 | 文本/图像 | 20-40 credits/sec |
veo3.1_fast | Google 快速模型 | 文本/图像 | 10-15 credits/sec |
模型选择指南
根据用户请求选择：
- “产品广告”“电子商务”“长视频” ->
seedance2 - “快速”“便宜”“迅速” ->
veo3.1_fast；如果用户有图像，则选gen4_turbo - “高质量”“最佳”“电影感” ->
gen4.5或veo3 - “编辑视频”“转换视频” ->
gen4_aleph或seedance2 - 未指定偏好 ->
seedance2
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--prompt | 文本描述（必填） | -- |
--filename | 输出文件名（必填） | -- |
--model | 视频模型 | gen4.5 |
--ratio | 宽高比（以像素为单位）。常见值：1280:720、720:1280、960:960。seedance2 还支持 1112:834、834:1112、1470:630 等。 | 1280:720 |
--duration | 时长（秒，取决于模型；seedance2 最长支持 15s） | 5 |
--image-url | 用于图生视频的图像 URL 或本地文件 | -- |
--video-url | 用于视频转视频的 URL 或本地文件（gen4_aleph、seedance2） | -- |
--output-dir | 输出目录 | cwd |
API 凭据仅从
RUNWAYML_API_SECRET获取——不提供--api-key标志，以避免机密泄露到 shell 历史记录和进程列表中。
文件名约定
文件名使用以下格式：yyyy-mm-dd-hh-mm-ss-name.mp4
示例：
- “赛博朋克城市” ->
2026-04-14-14-23-05-cyberpunk-city.mp4 - “海滩上的海浪” ->
2026-04-14-15-30-12-beach-waves.mp4
示例
文本转视频（seedance2）：
uv run scripts/generate_video.py --prompt "A serene mountain landscape at sunrise with mist" --filename "2026-04-14-mountain-sunrise.mp4" --model seedance2 --ratio 1280:720
图像转视频（让本地产品照片动起来）：
uv run scripts/generate_video.py --prompt "Camera slowly zooms out, product sparkles" --image-url "./product.jpg" --filename "2026-04-14-product-reveal.mp4" --model seedance2 --ratio 720:1280
从本地文件生成视频转视频（seedance2）：
uv run scripts/generate_video.py --prompt "Transform into a warm golden sunset scene" --video-url "./input.mp4" --filename "2026-04-14-sunset-transform.mp4" --model seedance2
快速草稿：
uv run scripts/generate_video.py --prompt "A cat playing piano" --filename "draft.mp4" --model veo3.1_fast --ratio 1280:720 --duration 4
优质画质：
uv run scripts/generate_video.py --prompt "Cinematic drone shot over Tokyo at night" --filename "tokyo.mp4" --model veo3 --ratio 1280:720 --duration 8
输出
- 脚本会下载结果并将其保存到指定路径
- 脚本会输出已保存文件的完整路径
- 不要重新读取视频文件——只需告知用户文件的保存路径
常见故障
Error: No API key-> 在环境中设置RUNWAYML_API_SECRET（例如，使用export RUNWAYML_API_SECRET=...或.env文件）。Error: Task failed -- SAFETY.INPUT.*-> 内容审核未通过，建议更换提示词Error: Task failed -- ASSET.INVALID-> 输入文件格式不正确，请检查图像/视频格式API error 429-> 请求频率受限，脚本会自动重试
批量生成
要一次生成多个视频，请循环运行此脚本——Agent 可以使用不同的提示词、图像或参数协调多次调用，从而大规模制作广告活动、本地化版本或创意迭代。
评论
支持 Markdown