Sanjian Ke · Wan 视频生成

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install sanjianke-wan-video
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 sanjianke-wan-video。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

此 Openclaw Skills 集成将 api.a7w.cn 的 Wan 视频 API 封装成实用且适合开发者使用的软件包。它支持使用文本提示、角色或图像参考、音频输入和视频编辑输入来生成视频，并通过 model 参数选择 Wan 版本及其功能。
使用随附的 Python 客户端检查 API 架构、提交生成任务，并获取任务状态和结果。此技能还提供端点文档、参数参考、设置指南和计费说明。需要 api.a7w.cn API 密钥；生成费用按照适用的租户定价收取，任务查询免费。

应用场景

根据文本提示生成视频，用于创意概念、营销素材或分镜脚本。
在需要视觉一致性时，使用角色或图像参考创建视频。
使用兼容的模型提供视频以及可选的图像或音频输入，以编辑现有视频。
添加音频驱动的生成，选择输出分辨率和宽高比，或配置提示词扩展和负面提示词。
提交长时间运行的生成任务，并使用平台的
task_id
稍后检查状态或结果。
使用 HTTPS 回调 URL 将任务完成或失败通知集成到应用程序中。

工作原理

使用随附的客户端配置 api.a7w.cn API 密钥。
检查 wan 架构，查看可用操作和请求参数。
选择兼容的 Wan 模型，并提交带有提示词及任何受支持输入（例如图像、音频或视频 URL）的 create 请求。
接收平台的 task_id；生成任务会异步运行，计费依据适用租户定价下的生成用量计算。
使用同步的 query 操作获取任务状态、结果视频 URL 和计费快照，或配置回调 URL 以接收任务完成或失败通知。

配置指南

在 api.a7w.cn 注册以获取 API 密钥。技能中的 references/getting-started.md 介绍了注册、充值和密钥配置。
配置密钥并检查可用的 Wan 操作：
python3 scripts/client.py login --key sk-YOUR_API_KEY
python3 scripts/client.py schema wan
提交生成请求。请将示例提示词和输入替换为所选模型的有效值：
python3 scripts/client.py call wan create --json '{"model":"wan2.7","size":"16:9","prompt":"A vintage car driving along a coastal road, cinematic lighting","resolution":"720p","duration":5}' --no-wait
使用返回的平台任务 ID 检查任务：
python3 scripts/client.py call wan query --json '{"task_id":"task_xxxxxxxxxxxx"}'
该客户端采用零依赖设计。请妥善保管 API 密钥，并查阅针对具体模型的 API 参考文档，了解受支持的输入和参数限制。
Sanjian Ke · Wan 视频生成 数据架构与分类体系
此技能将集成材料组织为可运行的客户端和参考文档；它没有描述本地视频或任务数据库。
文件或资源 用途
scripts/client.py 用于登录、架构检查和 API 调用的零依赖 Python CLI。
references/getting-started.md 注册、充值、获取 API 密钥和配置指南。
references/api-create.md 完整的 create 操作文档和架构。
references/api-query.md 完整的 query 操作文档和架构。
references/通用说明.md 权限、异步任务行为、常见错误、功能限制和计费指南。
生成请求使用 model、prompt、duration、resolution、size、seed、watermark、prompt_extend 和 negative_prompt 等字段。可选媒体输入包括 audio_url、image_urls、video_urls 和 image_with_roles；metadata 可携带业务信息，callback_url 可用于接收任务通知。输入限制和支持的字段因模型而异。create 操作会返回平台的 task_id；query 结果会提供任务状态，并在可用时提供视频 URL 和计费快照。

高级特性

model
参数支持多个 Wan 模型变体，包括文本生成视频、角色参考生成，以及适用时的视频编辑功能。
支持异步生成和独立的同步任务查询，客户端可通过平台的
task_id
跟踪长时间运行的任务。
接受图像、角色参考、音频和视频输入，具体取决于各模型的兼容性及文档所述限制。
支持通过 HTTPS 回调通知任务完成或失败，也可通过 query 操作轮询任务。
提供时长、分辨率、宽高比、用于确保结果可复现的 seed、水印、提示词扩展和负面提示词等生成控制项。
提供架构检查和详细的端点参考，帮助开发者在调用 API 前验证参数。
说明按用量计费的生成费用以及免费的任务查询；实际生成价格取决于适用的租户定价表。

name: wan-video slug: sanjianke-wan-video
displayName: 三剪客 · Wan 视频生成
description: "Wan 模型族视频生成应用。版本通过 model 参数选择，支持文生视频、角色参考生视频与视频编辑。支持 查询视频任务、创建视频任务。使用时需要你自己的 api.a7w.cn API Key。遇到问题可加技术微信 9872659。" version: 1.0.5
summary: "「Wan 视频生成」的完整调用封装：2 个接口的官方文档、参数表与一个零依赖客户端。需要自带 api.a7w.cn 的 API Key，调用按点数计费。遇到问题可加技术微信 9872659。"
license: MIT
tags:

• 三剪客
• 设计多媒体
• 视频生成
• 文生视频

Wan 视频生成

api.a7w.cn 插件 wan，共 2 个接口。按平台 task_id 查询 Wan 任务状态与结果。

本 Skill 是它的完整调用封装：逐接口参数表、平台官方文档摘录、真实计费口径，以及一个零依赖、可直接跑的 client.py。

快速开始

# 1. 配置你自己的 api.a7w.cn API Key（只需一次）
python3 scripts/client.py login --key sk-你的key

# 2. 看这个插件的接口与参数
python3 scripts/client.py schema wan

# 3. 调用（示例）
python3 scripts/client.py call wan query --json '{"task_id": "task_xxxxxxxxxxxx"}'

没有 Key？ 见 references/getting-started.md——注册、充值、取 Key 的完整步骤。也可以直接去 算力集市 注册。

接口一览
接口 名称 模式 计费
query 查询视频任务 同步 免费
create 创建视频任务 异步 免费
接口详情
query · 查询视频任务

请求：POST /api/v1/apps/v1/tasks/{task_id}

模式：同步（直接返回结果） ｜ 计费：免费

按平台 task_id 查询 Wan 任务状态与结果。

按平台 task_id 查询 Wan 视频任务状态、视频 URL 和计费快照。本接口只读取平台任务表中的数据。

基本信息

Authorization: Bearer GET /api/v1/apps/wan/query?task_id={task_id} | 参数 | 类型 | 必填 | 示例 | 说明 | | task_id | string | 是 | task_xxxxxxxxxxxx | 创建接口返回的平台任…

参数 类型 必填 默认 说明
task_id string 否 创建任务后返回的平台任务 ID。　例：task_xxxxxxxxxxxx

python3 scripts/client.py call wan query --json '{"task_id": "task_xxxxxxxxxxxx"}'

官方文档全文：references/api-query.md

create · 创建视频任务

请求：POST /api/v1/apps/v1/videos/generations

模式：异步（提交后轮询任务） ｜ 计费：免费

提交 Wan 视频生成任务。model 用于选择 Wan 版本与能力。

输入上限：参考图 ≤ 9 张，参考音频 ≤ 5 个，参考视频 ≤ 5 个

分档：models={'720p': {'with_video': 47.81, 'without_video': 47.81}, '1080p': {'with_video': 78.91, 'without_video': 78.91}}

提交 Wan 模型族视频任务。用户只对接平台统一接口；平台会按 model 选择对应能力，并负责参数过滤、任务入库、扣点冻结和轮询转存。

基本信息

Authorization: Bearer Content-Type: application/json 提交成功后返回平台 task_id。请使用 GET /api/v1/apps/wan/query?task_id={task_id}…

参数 类型 必填 默认 说明
seed integer 否 随机种子，用于结果复现。范围：0-2147483647。
size string 否 视频画幅比例。　例：16:9
model string 否 Wan 模型版本。不同版本支持的素材输入略有差异。　例：wan2.7
prompt string 否 视频画面与运动描述。　例：一辆复古跑车沿着海岸公路行驶，电影感光影
duration integer 否 5 生成视频时长，单位秒。wan2.7、wan2.7-r2v 支持 2-15；wan2.7-videoedit 支持 2-10。　例：5