Vidu 视频生成
用 Vidu 官方开放平台 API 生成视频。核心是 scripts/vidu_generate.py，一个零第三方依赖的 Python 脚本，直调 api.vidu.cn。
前置条件
- 有 Vidu 开放平台 API Key（
vda_前缀）。在 platform.vidu.cn 的 API Key 管理中创建。 - 把 Key 放入环境变量（不要硬编码进脚本、不要写进任何文件）：
bash
export VIDU_API_KEY="vda_xxx"
- 沙箱内 Python 用
python3（3.11+，仅标准库即可运行）。
快速开始
export VIDU_API_KEY="vda_xxx"
cd scripts
# 1) 查余额（只读，不扣费，先确认 Key 有效）
python3 vidu_generate.py balance
# 2) 文生视频（创建任务 → 自动轮询 → 输出视频 URL）
python3 vidu_generate.py generate --prompt "一只橘猫在草地上奔跑"
# 3) 指定参数 + 下载成片
python3 vidu_generate.py generate \
--prompt "一只橘猫在草地上奔跑，阳光明媚" \
--model viduq3-turbo --duration 5 --resolution 540p --aspect-ratio 16:9 \
--output /tmp/cat.mp4
# 4) 查询某个任务（轮询超时或被中断后继续查）
python3 vidu_generate.py query <task_id>
参数说明（generate 子命令）
| 参数 | 默认值 | 可选值 / 说明 |
|---|---|---|
--prompt |
（必填） | 提示词，≤20000 字符，中英文均可 |
--model |
viduq3-turbo |
viduq3-pro / viduq3-turbo / viduq2 / viduq1 |
--duration |
5 |
秒；Q3 为 1–16，Q2 为 1–10，Q1 固定 5 |
--resolution |
540p |
540p / 720p / 1080p（小写 p） |
--aspect-ratio |
16:9 |
1:1 / 16:9 / 9:16 / 4:3 / 3:4 |
--seed |
随机 | 固定种子可提升可复现性 |
--audio |
关 | 开启则输出有声视频（音画同步） |
--no-watermark |
带水印 | 去除「内容由 AI 生成」水印 |
--off-peak |
关 | 错峰生成，更省积分，但可能延迟（48h 内） |
--output |
不下载 | 传本地路径则把成片下载保存 |
关键 API 事实（踩坑点）
- 鉴权是
Token不是Bearer：Authorization: Token <key>。用Bearer会 401。 - 分辨率枚举是小写
p：540p/720p/1080p（区别于阿里云百炼托管版的540P大写）。 - 模型名无前缀：官方 API 直接用
viduq3-turbo（区别于百炼版的vidu/viduq3-turbo_text2video）。 - 异步两段式：
POST /ent/v2/text2video创建 → 返回task_id→GET /ent/v2/tasks/{id}/creations轮询。状态created→queueing/processing→success/failed。 - 成片 URL 24 小时有效，拿到后及时下载保存。
- 每次生成扣积分：创建响应里
credits字段是本次消耗。跑真实生成前先balance确认余额。
端点清单
| 用途 | 方法 + 路径 |
|---|---|
| 查余额 | GET /ent/v2/credits |
| 文生视频（创建） | POST /ent/v2/text2video |
| 查询生成物 | GET /ent/v2/tasks/{id}/creations |
附录：通过 Octop 内建工具走 Vidu（可选）
Octop 的 generate_video 内建 provider 只有 volcengine/dashscope/minimax，不内置 Vidu。若想用内建工具，只能走「阿里云百炼托管 Vidu」桥接（需要百炼 sk- Key + 改服务器 dashscope.py 源码打补丁），成本高、步骤多。多数场景直接用本 skill 的脚本即可，无需动服务器。
使用示例
用户输入：「帮我处理 Vidu 视频生成、vidu-video、视频处理 相关的任务」
技能执行：
1. 前置条件
2. 快速开始
3. 参数说明（generate 子命令）
4. 关键 API 事实（踩坑点）
预期输出：围绕「用 Vidu（生数科技）官方 API 生成视频」的可直接使用的结构化结果。
