Skip to content
Back to search

wan3-video-prime

SkillWorks with Claude CodeGitHub

万相 3.0-Prime(wan3.0-video-prime)视频生成:用千问AI平台按量计费 Key 出片,文生视频 / 首帧图生视频,时长 ≤30 秒,480P/720P/1080P。触发词:万相、万相3.0、Wan3.0-Video-Prime、千问生视频、文生视频、生成视频片段、分镜素材、参考图生成视频。硬性规则:该 Key 只允许调用 wan3.0-video-prime,禁止任何会话/文本/图像/其他模型调用;使用前必须先检测本机是否已配置千问 API,缺失就停下来问用户「是否安装并提供 API」,不得用别的厂商 Key 顶替;任何任务提交前必须报方案与预估费用并取得明确同意。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jacksonlyon--wan3-video-prime/badge.svg)](/listings/jacksonlyon--wan3-video-prime)

HTML

<a href="/listings/jacksonlyon--wan3-video-prime"><img src="/api/listings/jacksonlyon--wan3-video-prime/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

复制到目标机的 DSH 技能目录(`~/.dsh/skills/`)即可,目录名保持 `wan3-video-prime`:

# macOS / Linux
git clone https://github.com/JacksonLyon/wan3-video-prime.git ~/.dsh/skills/wan3-video-prime

# Windows PowerShell
git clone https://github.com/JacksonLyon/wan3-video-prime.git "$env:USERPROFILE\.dsh\skills\wan3-video-prime"

或用仓库自带安装脚本:

bash install.sh          # macOS / Linux
powershell -File install.ps1   # Windows

装好后**新开一个 DSH 会话**(老会话不会热加载新技能),在技能清单里看到 `万相 3.0-Prime` 即成功。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 85 lines
  1. ---
  2. name: wan3-video-prime
  3. description: 万相 3.0-Prime(wan3.0-video-prime)视频生成:用千问AI平台按量计费 Key 出片,文生视频 / 首帧图生视频,时长 ≤30 秒,480P/720P/1080P。触发词:万相、万相3.0、Wan3.0-Video-Prime、千问生视频、文生视频、生成视频片段、分镜素材、参考图生成视频。硬性规则:该 Key 只允许调用 wan3.0-video-prime,禁止任何会话/文本/图像/其他模型调用;使用前必须先检测本机是否已配置千问 API,缺失就停下来问用户「是否安装并提供 API」,不得用别的厂商 Key 顶替;任何任务提交前必须报方案与预估费用并取得明确同意。
  4. metadata:
  5. version: "1.0.0"
  6. author: "本地自建"
  7. model: "wan3.0-video-prime"
  8. updated: "2026-11-20"
  9. license: "MIT"
  10. ---
  11. # 万相 3.0-Prime 视频生成
  12. 只做一件事:调千问AI平台的 `wan3.0-video-prime` 生成视频。不做对话、不做文本、不做图像,不接第二个模型。
  13. ## 硬性规则(随技能走,任何主机、任何 Agent 都不放宽)
  14. - **R1 唯一用途**:本技能可用 `DASHSCOPE_API_KEY` 调用的端点只有 `POST /api/v1/services/aigc/video-generation/video-synthesis`(`model` 必须为 `wan3.0-video-prime`)与 `GET /api/v1/tasks/{task_id}`。禁止 `/chat/completions`、`/compatible-mode/v1`、图像生成、embedding、以及其他任何 wan/qwen 模型——即使同一把 Key 有权限。
  15. - **R2 不进模型选择器**:不得把千问 Key 注册成 DSH 的对话 provider(不写 `llm-pi-ai.providers`、不进 picker、不参与会话路由)。这是用户定死的规则;要改必须先问用户。
  16. - **R3 主机预检(每次开工第一步)**:先跑 `node {baseDir}/scripts/wan_prime.mjs check`。它会按 `env DASHSCOPE_API_KEY / QIANWEN_API_KEY → $DSH_HOME/.credentials.yaml → ~/.dsh/.credentials.yaml` 找 Key,并做一次零计费自检。
  17. - 若返回 `code: "NO_QIANWEN_KEY"`(退出码 3):**立即停手**,用下面原话问用户,得到答复前不得生成、不得换别的视频服务、不得猜 Key。
  18. > 本机 DSH 里没有检测到千问AI平台的 API Key(DASHSCOPE_API_KEY)。要不要现在安装?如果要,请把千问AI平台(platform.qianwenai.com,按量计费)的 Key 发我,我只登记到凭据库供万相视频使用,不会注册成对话模型。
  19. - 用户给了 Key:`echo <key> | node {baseDir}/scripts/wan_prime.mjs save-key` 写入 `refs.DASHSCOPE_API_KEY`,然后重跑 `check` 确认 `code: "OK"`。
  20. - 返回 `AUTH_FAILED` / 403:Key 无效或未开通「Wan 系列模型」,让用户去平台开通,不要重试猜测。
  21. - **R4 密钥不落地**:Key 只留在凭据库;不得写进 SKILL.md、脚本、日志、回复正文、仓库或截图。对外只显示脱敏形式(`sk-ws-****`)。
  22. - **R5 提交前报价**:任何 `generate` 之前,先 `plan` 拿方案与预估费用,把「提示词 / 分辨率 / 比例 / 时长 / 预估¥」发给用户并取得明确同意,再加 `--yes` 执行。脚本不带 `--yes` 会拒绝提交(退出码 2),这是硬闸门,不要绕过。
  23. - **R6 一次一条**:默认只出 1 条 5 秒 720P(≈¥4.5)。要多条、要 >10 秒、要 1080P,逐条确认。
  24. - **R7 跨主机一致**:技能复制到别的电脑后,R1–R6 原样成立。不能因为宿主没配 Key 就改成「用别家模型凑一段视频」;正确动作永远是 R3 的提问安装。
  25. ## 执行流程
  26. 1. **预检**(R3):`node {baseDir}/scripts/wan_prime.mjs check`
  27. - 完成判据:输出 `ok: true, code: "OK"`,且 `model` 为 `wan3.0-video-prime`。
  28. 2. **收需求**:画面内容、用途(分镜/封面/成片镜头)、画幅(`16:9` / `9:16` / `adaptive`)、时长、分辨率。
  29. - 用户没说画幅与分辨率就按 720P + `adaptive`,并在报价里写明,等用户改。
  30. 3. **报价**:`plan --prompt "..." --resolution 720P --duration 5`
  31. - 完成判据:拿到 `estimate.total`,并把方案原样报给用户。
  32. 4. **出片**:用户同意后 `generate --prompt "..." --resolution 720P --ratio adaptive --duration 5 --yes --out <目标目录>`
  33. - 完成判据:输出 `ok: true`,带上 `file` 本地路径与 `videoUrl`。
  34. 5. **交付**:给出本地文件路径 + 时长/分辨率/实际花费,说明可继续生成下一镜。不要用 base64 塞视频、不要只给 URL 让用户自己去下。
  35. ## 命令速查
  36. `{baseDir}` = 本技能目录(`~/.dsh/skills/wan3-video-prime`)。
  37. ```bash
  38. node {baseDir}/scripts/wan_prime.mjs check
  39. node {baseDir}/scripts/wan_prime.mjs plan --prompt "..." [--resolution 720P] [--ratio adaptive] [--duration 5]
  40. node {baseDir}/scripts/wan_prime.mjs generate --prompt "..." --yes [--out DIR] [--timeout 900]
  41. node {baseDir}/scripts/wan_prime.mjs task <task_id>
  42. node {baseDir}/scripts/wan_prime.mjs download <task_id> [--out DIR]
  43. node {baseDir}/scripts/wan_prime.mjs save-key # 从 stdin 或 DSH_KEY 读,写 refs.DASHSCOPE_API_KEY
  44. ```
  45. 首帧图生视频:`--image <本地路径或 https URL>`(会以 `input.media=[{type:"first_frame",url}]` 提交;若平台拒绝该字段,按返回的参数错误如实回报,不要反复重试烧钱)。
  46. ## 计价与上限
  47. | 分辨率 | 单价 | 5 秒 | 10 秒 |
  48. | --- | --- | --- | --- |
  49. | 480P | ¥0.45/秒 | ¥2.25 | ¥4.50 |
  50. | 720P | ¥0.90/秒 | ¥4.50 | ¥9.00 |
  51. | 1080P | ¥1.80/秒 | ¥9.00 | ¥18.00 |
  52. 上限:单条 ≤30 秒;异步队列 500 任务;RPM 300。任务失败(`FAILED` + `InvalidParameter`)不计费;`SUCCEEDED` 才计费。
  53. ## 退出码与错误码
  54. | 码 | 含义 | 动作 |
  55. | --- | --- | --- |
  56. | 0 | 成功 | — |
  57. | 2 | `NEEDS_CONFIRMATION` | 把 plan+费用报给用户,同意后加 `--yes` |
  58. | 3 | `NO_QIANWEN_KEY` | 按 R3 提问是否安装并提供 Key,停手等答复 |
  59. | 4 | `AUTH_FAILED` | Key 无效/未开通 Wan 服务:让用户处理,不重试 |
  60. | 5 | `MODEL_UNAVAILABLE` | 该账号无此模型权限:如实回报 |
  61. | 1 | 其它(`TIMEOUT` / `NO_VIDEO_URL` / 参数错误) | 回报原始 `code/message`,不自行改参数连打 |
  62. ## 移植到其它主机
  63. 1. 整目录复制到目标机器的 `~/.dsh/skills/wan3-video-prime`(Windows:`C:\Users\<用户>\.dsh\skills\`)。
  64. 2. 新会话里技能即被发现;老会话需重开才看到。
  65. 3. 目标机器没有 Key 时,`check` 会返回 `NO_QIANWEN_KEY` —— 按 R3 问用户要 Key,再 `save-key`,不要沿用本机的 Key 文本。
  66. 4. 目标机器若已有 `refs.DASHSCOPE_API_KEY`,直接用;若该主机把它配成了对话 provider,按 R2 提示用户移除。
  67. 细节(端点、参数、返回结构、错误样例)见 `references/api.md`。
README.md · README · 106 lines
  1. # 万相 3.0-Prime · DSH Skill
  2. 用**千问AI平台**(QwenCloud / 千问)按量计费 Key 调用 `wan3.0-video-prime` 生成视频的 DeepSeek Harness 技能:文生视频 / 首帧图生视频,时长 ≤ 30 秒,480P / 720P / 1080P。
  3. > 仓库已开源(Public),克隆即可用。本仓库只放技能本体与调用脚本,**不放任何 API Key**。Key 由使用者的 DSH 凭据库提供。
  4. ## 硬性规则(随技能移植,任何主机都不放宽)
  5. 技能内的每一条规则都写在 `SKILL.md` 的「硬性规则」里,并由脚本以退出码硬性拦截:
  6. | 规则 | 含义 | 脚本兜底 |
  7. | --- | --- | --- |
  8. | R1 唯一用途 | 这把 Key 只允许调 `POST /api/v1/services/aigc/video-generation/video-synthesis`(`model` 必须为 `wan3.0-video-prime`)和 `GET /api/v1/tasks/{id}`;禁止 `/chat/completions`、图像、embedding、其它 `wan*`/`qwen*` 模型 | `MODEL` 写死,无 `--model` 参数 |
  9. | R2 不进模型选择器 | 不得把千问 Key 注册成 DSH 对话 provider | 技能只提供 CLI,不写 `llm-pi-ai.providers` |
  10. | R3 主机预检 | 使用前先查本机有没有千问 API;没有就**停手问用户是否安装并提供 Key** | `check` 返回 `NO_QIANWEN_KEY`,退出码 3 |
  11. | R4 密钥不落地 | Key 只留在凭据库,不进代码/日志/回复 | 脚本只读 `refs.DASHSCOPE_API_KEY` |
  12. | R5 提交前报价 | 报方案 + 预估费用,拿到明确同意才提交 | 不带 `--yes` 直接拒绝,退出码 2 |
  13. | R6 一次一条 | 默认 5 秒 720P 单条(≈¥4.5) | 默认值即此 |
  14. | R7 跨主机一致 | 换机器也不得改用别家视频服务凑结果 | 逻辑同上 |
  15. ## 安装
  16. 复制到目标机的 DSH 技能目录(`~/.dsh/skills/`)即可,目录名保持 `wan3-video-prime`:
  17. ```bash
  18. # macOS / Linux
  19. git clone https://github.com/JacksonLyon/wan3-video-prime.git ~/.dsh/skills/wan3-video-prime
  20. # Windows PowerShell
  21. git clone https://github.com/JacksonLyon/wan3-video-prime.git "$env:USERPROFILE\.dsh\skills\wan3-video-prime"
  22. ```
  23. 或用仓库自带安装脚本:
  24. ```bash
  25. bash install.sh # macOS / Linux
  26. powershell -File install.ps1 # Windows
  27. ```
  28. 装好后**新开一个 DSH 会话**(老会话不会热加载新技能),在技能清单里看到 `万相 3.0-Prime` 即成功。
  29. ## 首次使用:配 Key
  30. ```bash
  31. node scripts/wan_prime.mjs check
  32. ```
  33. - 返回 `ok:true, code:"OK"` → 本机已有可用 Key,直接开工。
  34. - 返回 `NO_QIANWEN_KEY`(退出码 3)→ 说明本机还没装千问 API。技能会按 R3 停下来问你要不要装、并索取 Key:
  35. ```bash
  36. echo "<你的 Key>" | node scripts/wan_prime.mjs save-key
  37. ```
  38. Key 写入 `~/.dsh/.credentials.yaml` 的 `refs.DASHSCOPE_API_KEY`,权限 600。也支持环境变量 `DASHSCOPE_API_KEY` / `QIANWEN_API_KEY` 直接提供。
  39. > Key 要到 <https://platform.qianwenai.com>(按量计费)创建,形如 `sk-ws-…` / `sk-sp-…`;账号还需开通「Wan 系列模型」。
  40. ## 使用
  41. ```bash
  42. # 1. 报价:只出方案和费用,不提交
  43. node scripts/wan_prime.mjs plan --prompt "一只小猫在月光下的屋顶上奔跑" --resolution 720P --duration 5
  44. # 2. 用户同意后出片
  45. node scripts/wan_prime.mjs generate --prompt "一只小猫在月光下的屋顶上奔跑" \
  46. --resolution 720P --ratio adaptive --duration 5 --yes --out ./wan3-videos
  47. # 首帧图生视频
  48. node scripts/wan_prime.mjs generate --prompt "镜头缓慢推进" --image ./first-frame.png --yes
  49. # 查任务 / 补下载
  50. node scripts/wan_prime.mjs task <task_id>
  51. node scripts/wan_prime.mjs download <task_id> --out ./wan3-videos
  52. ```
  53. 脚本每步都输出单行 JSON,方便 Agent 解析;失败时不自动重试,如实回报 `code` / `message`。
  54. ## 计价(2026-11 平台价,以官方为准)
  55. | 分辨率 | 单价 | 5 秒 | 10 秒 |
  56. | --- | --- | --- | --- |
  57. | 480P | ¥0.45/秒 | ¥2.25 | ¥4.50 |
  58. | 720P | ¥0.90/秒 | ¥4.50 | ¥9.00 |
  59. | 1080P | ¥1.80/秒 | ¥9.00 | ¥18.00 |
  60. 任务在参数校验阶段失败(如 `InvalidParameter`)不计费;只有 `SUCCEEDED` 才按秒计费。异步队列上限 500,RPM 300。
  61. ## 目录
  62. ```
  63. SKILL.md 技能说明与硬性规则
  64. scripts/wan_prime.mjs 唯一调用入口(check/plan/generate/task/download/save-key)
  65. references/api.md 端点、参数、轮询、返回结构、错误样例
  66. install.sh / install.ps1 复制到 ~/.dsh/skills/ 的安装脚本
  67. ```
  68. ## 安全
  69. - 仓库内不含密钥;`.gitignore` 会挡住本地生成的视频、日志与临时 Key 文件。
  70. - 脚本只在被要求时联网:`check` 会做一次**零计费**自检(空 prompt,任务在校验阶段失败)。
  71. - 平台对 Wan 系列有独立的服务开关;403 `AccessDenied` 时先确认账号是否开通该服务。
  72. ## License
  73. [MIT](LICENSE) © 2026 JasonTAO (JacksonLyon)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.