菜单
基于 Seedance 2.0 模型的 AI 视频生成器，输入关键词/描述文案即可生成 MP4 视频。支持文生视频、分辨率/比例/时长控制、预置虚拟人像引用。使用 Seedance 视频生成、AI 视频、text-to-video 时调用此 Skill。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/redfox-data/redfox-community --skill seedance-video-gen命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
文旅B站信息源 — 搜索文旅相关B站热门视频，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅B站、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅B站、文旅信息源、文旅资讯、旅游B站、景区视频、文旅爆款。
文旅抖音信息源 — 搜索文旅相关抖音热门作品，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅抖音、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅抖音、文旅信息源、文旅资讯、旅游抖音、景区视频、文旅爆款。
文旅公众号信息源 — 搜索文旅相关公众号热门文章，按阅读量筛选最火内容，生成精美 HTML 报告。当用户需要文旅公众号、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅公众号、文旅信息源、文旅资讯、旅游公众号、景区文章、文旅爆款。
基于 SOC 职业分类
正在显示 SKILL.md
| name | seedance-video-gen |
| description | 基于 Seedance 2.0 模型的 AI 视频生成器，输入关键词/描述文案即可生成 MP4 视频。支持文生视频、分辨率/比例/时长控制、预置虚拟人像引用。使用 Seedance 视频生成、AI 视频、text-to-video 时调用此 Skill。 |
Seedance2.0是一款基于火山方舟 Seedance 2.0 模型的 AI 视频生成工具。通过 redfox.hk 平台封装了复杂的 ARK API 鉴权流程，一行命令即可生成视频。
Skill 特色
- 支持命令行参数化控制分辨率、比例、时长
- 文生视频 + 虚拟人像引用双模式
社交媒体创作者、产品经理、内容运营人员、AI 爱好者，以及任何需要快速将文案转化为视频的用户。
asset:// 格式引用预置虚拟人像，无需上传真实人脸素材doubao-seedance-2-0-260128| 参数 | 说明 | 默认值 |
|---|---|---|
prompt | 视频提示词（必填，中英文均可） | — |
--resolution | 分辨率：480p / 720p / 1080p | 720p |
--ratio | 画面比例：16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive | 16:9 |
--duration | 视频时长（秒）：4-15 或 -1（智能） | 5 |
--seed | 随机种子：-1 到 2147483647 | -1 |
--no-audio | 不生成声音 | 默认生成 |
--watermark | 添加水印 | 默认不添加 |
--return-last-frame | 返回尾帧图片 URL | 默认不返回 |
--image-url | 参考图 URL（asset:// 格式） | — |
-o, --output-dir | 输出目录 | ~/Downloads/QoderVideos |
--prefix | 文件名前缀 | video |
--no-download | 仅提交不等待 | — |
--task-id | 查询已有任务 | — |
角色：短视频博主 / 小红书运营
需求：快速生成竖屏（9:16）视频素材，用于抖音/小红书/视频号发布
使用方式：
python3 "$SKILL_PATH/scripts/videogen.py" "美妆产品展示，柔和的灯光，产品缓缓旋转" --ratio 9:16
预期收益：降低素材制作成本，从数小时缩短到几分钟
角色：产品经理 / 创业者
需求：快速生成产品概念视频，用于提案、路演或展示
使用方式：
python3 "$SKILL_PATH/scripts/videogen.py" "一款智能手表在桌面上展示，表盘切换不同功能界面" --resolution 1080p --duration 8
预期收益：无需专业视频制作能力，文案即视频
角色：内容运营 / 市场人员
需求：批量生成品牌配景视频，搭配文案制作品牌宣传短片
使用方式：
python3 "$SKILL_PATH/scripts/videogen.py" "品牌主题色背景，文字渐变浮现，专业大气" --ratio 16:9 --no-audio
预期收益：提升内容产出效率，统一品牌视觉风格
角色：设计师 / 创意人员
需求：将脑中的画面用自然语言快速变成可视化视频，验证创意方向
使用方式：
python3 "$SKILL_PATH/scripts/videogen.py" "赛博朋克风格的城市夜景，霓虹灯闪烁，雨滴落在镜头上的效果" --duration 6
预期收益：降低创意门槛，想法到视频只需一行命令
角色：教师 / 培训师
需求：将抽象知识点转化为可视化短片，提升教学效果
使用方式：
python3 "$SKILL_PATH/scripts/videogen.py" "太阳系行星围绕太阳旋转的动画，标注每颗行星的名称" --duration 10
预期收益：无需动画制作技能，知识可视化零门槛
配置 API Key 后即可使用：
# 设置环境变量
export REDFOX_API_KEY=ak_你的密钥
# 运行
python3 "$SKILL_PATH/scripts/videogen.py" "一只橘猫在窗台上打哈欠，阳光温暖地照在它的毛上"
前往 redfox.hk 注册获取 API Key。
可前往 redfox.hk 注册账号获取自己的 API Key，三种配置方式任选其一：
| 配置方式 | 说明 | 命令 |
|---|---|---|
| 环境变量（推荐） | 设置一次，全局生效 | export REDFOX_API_KEY=ak_你的密钥 |
| 命令行参数 | 临时使用，单次生效 | python3 "$SKILL_PATH/scripts/videogen.py" "prompt" --api-key ak_你的密钥 |
| 配置文件 | 持久化存储，跨会话保留 | mkdir -p ~/.qoder/apis && echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json |
pip3 install requests
| 变量名 | 必填 | 说明 |
|---|---|---|
REDFOX_API_KEY | — | redfox.hk 平台的 API 访问密钥 |
python3 "$SKILL_PATH/scripts/videogen.py" "一只橘猫在窗台上打哈欠，阳光温暖地照在它的毛上"
脚本会自动提交任务、轮询等待（约 3-15 分钟），完成后下载到 ~/Downloads/QoderVideos/。
生成成功后会显示视频信息和文件路径：
[✓] Video ready: 5s, 720p, 16:9
[✓] Token usage: 108900
[→] Downloading video: video.mp4
[✓] Done!
/Users/you/Downloads/QoderVideos/video.mp4 (2.5 MB)
python3 "$SKILL_PATH/scripts/videogen.py" "时尚都市夜景，霓虹灯闪烁" --ratio 9:16
python3 "$SKILL_PATH/scripts/videogen.py" "海浪拍打岩石的慢动作" --resolution 1080p --duration 10
python3 "$SKILL_PATH/scripts/videogen.py" "一位年轻女性在图书馆安静阅读" --image-url "asset://female_student_01"
更多预置虚拟人像 ID 请参考火山方舟「素材&虚拟人像库」文档。
# 仅提交任务，返回 taskId 后立即退出
python3 "$SKILL_PATH/scripts/videogen.py" "复杂场景" --no-download
# 稍后用 taskId 查询结果
python3 "$SKILL_PATH/scripts/videogen.py" "ignored" --task-id vg_abc123def456
# 1. 生成第一段，获取尾帧
python3 "$SKILL_PATH/scripts/videogen.py" "开场画面" --return-last-frame
# 2. 将返回的 lastFrameUrl 作为下一段的首帧
python3 "$SKILL_PATH/scripts/videogen.py" "转场到第二个场景" --image-url "上一步的lastFrameUrl"
| 命令 | 功能 |
|---|---|
python3 videogen.py "提示词" | 基础文生视频 |
--ratio 9:16 | 竖屏比例 |
--resolution 1080p | 高清分辨率 |
--duration 10 | 指定时长 |
--no-audio | 静音视频 |
--watermark | 添加水印 |
--seed 42 | 固定种子可复现 |
--image-url "asset://..." | 引用虚拟人像 |
--no-download | 仅提交任务 |
--task-id <id> | 查询已有任务 |
--api-key <key> | 指定 API Key |
-o ~/Desktop | 指定输出目录 |
seedance-video-gen/
├── SKILL.md # Skill 定义与文档
└── scripts/ # 工具脚本
└── videogen.py # 视频生成主程序
| 组件 | 技术 |
|---|---|
| 运行环境 | Python 3.6+ |
| HTTP 库 | requests |
| API 平台 | redfox.hk |
| 底层模型 | 火山方舟 Seedance 2.0 (doubao-seedance-2-0-260128) |
| 输出格式 | MP4 |
| 模块 | 职责 |
|---|---|
get_api_key() | 三级优先级获取 API Key：CLI > 环境变量 > 配置文件 |
submit_video_task() | 构建 content 数组，提交视频生成任务 |
poll_video_result() | 轮询任务状态（queued/running/succeeded/failed/expired），最多 20 分钟 |
download_video() | 流式下载 MP4 视频，带进度条显示 |
main() | CLI 入口：参数解析、API Key 校验、双分支（提交/查询）流程 |
用户输入提示词 → submit_video_task() → redfox.hk API → 火山方舟 Seedance 2.0
↓
用户获得 MP4 ← download_video() ← poll_video_result() ← 任务完成回调
Q1：需要 API Key 吗？
A：需要。前往 redfox.hk 注册获取自己的 API Key，通过环境变量 REDFOX_API_KEY 或 --api-key 参数配置。
Q2：配置文件放在哪里？
A：放在 ~/.qoder/apis/redfox.json，内容格式为：{"api_key": "ak_你的密钥"}。
Q3：如何验证 API Key 是否配置成功？
A：运行 python3 videogen.py "测试" --no-download，如果能返回 taskId 则配置成功。
Q4：生成一个视频需要多久？
A：通常 3-15 分钟，复杂场景可能更长。脚本会自动轮询等待，最多等待 20 分钟。
Q5：支持上传自己的参考图吗？
A：Seedance 2.0 不支持直接上传含真人人脸的参考图/视频。如需指定人物外观，可在提示词中描述（如"一位戴眼镜的亚洲女性"），或使用预置虚拟人像库的 asset:// URL。更多信息请参考火山方舟「素材&虚拟人像库」文档。
Q6：支持哪些提示词语言？
A：中英文均可，API 内部会自动处理。
Q7：输出文件保存在哪里？
A：默认保存到 ~/Downloads/QoderVideos/video.mp4，可通过 -o 参数指定目录。
Q8：任务超时了怎么办？
A：脚本最多等待 20 分钟。超时后会打印 taskId，你可以稍后通过 --task-id 参数重新查询并下载结果。
Q9：提示"API request failed"？
A：检查网络连接是否正常，确认 redfox.hk 服务可访问。如果持续失败，可能是 API Key 已过期或余额不足。
Q10：视频下载失败？
A：确认输出目录有写入权限，磁盘空间充足。如果 OSS 链接过期，可以用 --task-id 重新查询获取新的下载链接。
如有其他问题，可前往 redfox.hk 查看平台文档或联系客服。