Seedance 2.0 文生视频（Redfox）

要解决什么问题

把文案变成带同步音频的短视频，通常意味着去火山方舟申请白名单、配置 AK/SK，并自己实现 ARK 鉴权与任务轮询。对只想试一条 prompt 的开发者或运营来说，这条链路往往比「写提示词」还长。

本技能通过 redfox.hk 封装 Seedance 2.0 的调用：你在本地用 Python 脚本提交 prompt，由平台完成鉴权；脚本负责提交任务、轮询状态（排队/生成中/完成），并在成功后把 MP4 下载到指定目录（默认 ~/Downloads/QoderVideos/）。

核心能力与工作方式

• 文生视频：中英文提示词均可；底层模型为 doubao-seedance-2-0-260128，输出 MP4，默认带同步音频（可用 --no-audio 关闭）。
• 参数控制：分辨率 480p / 720p / 1080p，比例含 16:9、9:16 等七种，--duration 支持 4–15 秒或 -1 智能时长；--seed 可固定随机种子以便复现。
• 虚拟人像：通过 asset:// 引用预置虚拟人像，无需上传真实人脸素材；--return-last-frame 可拿尾帧 URL，便于多段连续生成。
• 任务模式：默认自动轮询（脚本最长约 20 分钟）；--no-download 只提交拿 taskId，之后用 --task-id 查询并下载。

API Key 通过环境变量 REDFOX_API_KEY、命令行 --api-key 或 ~/.qoder/apis/redfox.json 三选一配置，优先级为 CLI > 环境变量 > 配置文件。

适用边界与注意点

• 生成耗时常见 3–15 分钟，复杂场景更长；超时后仍可用 --task-id 追结果。
• 不支持直接上传含真人人脸的参考图/视频；人物外观靠提示词描述或使用官方虚拟人像库。
• 按次消费依赖 redfox.hk 账号余额；出现 API request failed 时需检查 Key、网络与余额。
• OSS 下载链接可能过期，下载失败时用 --task-id 重新查询获取新链接。