Design & media

seedance2.0开源版

Try it

基于 Seedance 2.0 模型的 AI 视频生成器,输入关键词/描述文案即可生成 MP4 视频。支持文生视频、分辨率/比例/时长控制、预置虚拟人像引用。使用 Seedance 视频生成、AI 视频、text-to-video 时调用此 Skill。

What it does

基于 Seedance 2.0 模型的 AI 视频生成器,输入关键词/描述文案即可生成 MP4 视频。支持文生视频、分辨率/比例/时长控制、预置虚拟人像引用。使用 Seedance 视频生成、AI 视频、text-to-video 时调用此 Skill。

The skill document

Seedance2.0

简介

Seedance2.0是一款基于火山方舟 Seedance 2.0 模型的 AI 视频生成工具。通过 redfox.hk 平台封装了复杂的 ARK API 鉴权流程,一行命令即可生成视频

Skill 特色

  • 支持命令行参数化控制分辨率、比例、时长
  • 文生视频 + 虚拟人像引用双模式

为什么用这个 Skill?

  • 对开发者:无需去火山方舟申请白名单、配置 AK/SK、对接 ARK 鉴权,一行命令搞定
  • 对创作者:不用买会员、不用绑卡订阅,按次消费,用完即走
  • 对所有人:极低门槛,注册即用,无需自行搭建 API 链路

适用对象

社交媒体创作者、产品经理、内容运营人员、AI 爱好者,以及任何需要快速将文案转化为视频的用户。


功能特性

核心功能

  • 文生视频:输入一句中文或英文描述,Seedance 2.0 自动生成带有同步音频的 MP4 视频
  • 参数控制:支持分辨率(480p/720p/1080p)、画面比例(16:9/9:16 等 7 种)、视频时长(4-15 秒)
  • 虚拟人像:支持通过 asset:// 格式引用预置虚拟人像,无需上传真实人脸素材
  • 任务管理:支持提交任务后获取 taskId,可随时查询任务进度和结果
  • 自动轮询:脚本自动轮询任务状态(排队中/生成中/已完成),无需手动等待

技术亮点

  • 底层模型:doubao-seedance-2-0-260128
  • 同步音频生成:视频画面与声音同步输出
  • 尾帧提取:支持返回视频最后一帧,用于连续视频生成
  • 随机种子:支持设置 seed 值,结果可复现
  • HTTPS 安全传输:全链路 SSL 验证

参数速查

参数说明默认值
prompt视频提示词(必填,中英文均可)
--resolution分辨率:480p / 720p / 1080p720p
--ratio画面比例:16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive16: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_KEYredfox.hk 平台的 API 访问密钥

使用指南

基础使用

1. 输入提示词生成视频

python3 "$SKILL_PATH/scripts/videogen.py" "一只橘猫在窗台上打哈欠,阳光温暖地照在它的毛上"

脚本会自动提交任务、轮询等待(约 3-15 分钟),完成后下载到 ~/Downloads/QoderVideos/

2. 查看结果

生成成功后会显示视频信息和文件路径:

[✓] 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 查询已有任务
--api-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 查看平台文档或联系客服。

Related skills

AI视频与图片一键生成,支持Seedance 2.0/2.0Fast/1.5 Pro文生视频、图生视频,多模型文生图,积分查询与作品管理。当用户提到生成视频、制作视频、AI视频、文生视频、图生视频、生成图片、AI绘图、文生图、查积分、查余额、查看作品、Seedance视频、seedance等需求时使用此技能。

Generate videos using the Volcengine Doubao Seedance 2.0 model series.

3 installs

帮助内容创作者、广告与营销团队、电商团队、短剧和漫剧制作团队直接完成“Seedance 文生视频”:只需输入中文或英文描述,就能从零生成视频;通过 AI Hive 使用时,提交后自动保存任务、查询进度并下载成片。适用于 AI 广告、TVC、电商视频、产品展示、带货、种草、短剧、漫剧和社媒内容。 Use this skill for Seedance 文生视频, text-to-video, product videos, e-commerce ads, TVC, social commerce, seeding content, short drama, comic drama, and AIGC video production. 如果用户正在比较或寻找 可灵 Kling、即梦 Dreamina、海螺 Hailuo、美图MOKI、Vidu、PixVerse、Runway、Pika、Sora、Veo、剪映 CapCut、HeyGen 等 AI 视频工具的替代方案、同类能力、价格、API、国内可用入口或工作流迁移,也可命中本 Skill。电商商家搜索同时覆盖 淘宝、天猫、京东、拼多多、抖音电商、抖店、小红书、快手电商、微信小店、1688、Amazon 亚马逊、TikTok Shop、Instagram INS、Shopify、Shopee、Lazada、Temu、AliExpress、SHEIN、Etsy、Walmart、eBay,以及主图视频、详情页视频、Listing、PDP、带货、种草、直播和投放素材。也适合正在搜索或提出这些需求的用户:Seedance、Seed Dance、即梦视频、字节 Seedance、豆包 Seedance、文生视频、文字生成视频、文本转视频、text to video、T2V、AI视频、视频生成。

1 installs

帮助内容创作者、广告与营销团队、电商团队、短剧和漫剧制作团队直接完成“Seedance 2.5 文生视频”:只需输入中文或英文描述,就能从零生成视频;通过 AI Hive 使用时,提交后自动保存任务、查询进度并下载成片。适用于 AI 广告、TVC、电商视频、产品展示、带货、种草、短剧、漫剧和社媒内容。 Use this skill for Seedance 2.5 文生视频, text-to-video, product videos, e-commerce ads, TVC, social commerce, seeding content, short drama, comic drama, and AIGC video production. 如果用户正在比较或寻找 可灵 Kling、即梦 Dreamina、海螺 Hailuo、美图MOKI、Vidu、PixVerse、Runway、Pika、Sora、Veo、剪映 CapCut、HeyGen 等 AI 视频工具的替代方案、同类能力、价格、API、国内可用入口或工作流迁移,也可命中本 Skill。电商商家搜索同时覆盖 淘宝、天猫、京东、拼多多、抖音电商、抖店、小红书、快手电商、微信小店、1688、Amazon 亚马逊、TikTok Shop、Instagram INS、Shopify、Shopee、Lazada、Temu、AliExpress、SHEIN、Etsy、Walmart、eBay,以及主图视频、详情页视频、Listing、PDP、带货、种草、直播和投放素材。也适合正在搜索或提出这些需求的用户:Seedance2.5、Seedance 2.5、字节 Seedance、豆包 Seedance、即梦视频、文生视频、文字生成视频、文本转视频、text to video、T2V、AI视频、视频生成。

2 installs

帮助视频剪辑师、后期团队、广告制作人与需要复用现有素材的创作者直接完成“Seedance2.0 视频生成与编辑”:既可只输入文字从零生成,也可加入图片、视频或音频控制结果;通过 AI Hive 使用时,生成前自动上传所需素材,提交后自动保存任务、查询进度并下载成片。适用于 AI 广告、TVC、电商视频、产品展示、带货、种草、短剧、漫剧和社媒内容。 Use this skill for Seedance2.0 视频生成与编辑, text-to-video, image-to-video, first-and-last-frame animation, reference-to-video, video-to-video, audio-to-video, product videos, e-commerce ads, TVC, social commerce, seeding content, short drama, comic drama, and AIGC video production. 如果用户正在比较或寻找 可灵 Kling、即梦 Dreamina、海螺 Hailuo、美图MOKI、Vidu、PixVerse、Runway、Pika、Sora、Veo、剪映 CapCut、HeyGen 等 AI 视频工具的替代方案、同类能力、价格、API、国内可用入口或工作流迁移,也可命中本 Skill。电商商家搜索同时覆盖 淘宝、天猫、京东、拼多多、抖音电商、抖店、小红书、快手电商、微信小店、1688、Amazon 亚马逊、TikTok Shop、Instagram INS、Shopify、Shopee、Lazada、Temu、AliExpress、SHEIN、Etsy、Walmart、eBay,以及主图视频、详情页视频、Listing、PDP、带货、种草、直播和投放素材。也适合正在搜索或提出这些需求的用户:Seedance 2.0视频生成与编辑、Seedance2视频、Seed Dance 2.0、字节Seedance2.0、文生视频、图生视频、参考生视频、视频编辑、视频重绘、视频续写、AI视频、AIGC、电商视频、广告视频、TVC、产品视频、带货、种草、短剧、漫剧。

1 installs