三剪客 · 动作迁移

动作迁移，基于参考图片和输入视频生成动作迁移后的视频结果。支持 提交任务、查询任务。使用时需要你自己的 api.a7w.cn API Key。遇到问题可加技术微信 9872659。

动作迁移

动作迁移，基于参考图片和输入视频生成动作迁移后的视频结果。

权限与用途说明

能力	是否申请	用途
网络访问	申请	调用 api.a7w.cn 的插件接口（本 Skill 唯一的联网行为）
读取文件	仅读取用户指定的输入文件（图片/音频/视频）	作为接口的素材入参
写入文件	仅在传入 --out 时	保存接口返回的 JSON 结果
凭证	读取使用者自己提供的 API Key	从 ~/.a7w/config.json 或环境变量读取
子进程 / 后台常驻	不申请	脚本执行完即退出

不内嵌任何密钥。 脚本只把 Key 发往 api.a7w.cn，不发送到其他任何地址。

快速开始

bash

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

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

# 3. 提交任务（file_url 与 video_url 都是必填，且必须是公网可达地址）
python3 scripts/client.py call action_transfer submit --param file_url="https://你的图床/人物.png" \
    --param video_url="https://你的图床/素材.mp4" --param mode=fast
# 也可以把参数写进文件，避开 shell 引号问题：
#   python3 scripts/client.py call action_transfer submit --json-file body.json

# 4. 只想先拿 task_id、不等结果
python3 scripts/client.py call action_transfer submit --json-file body.json --no-wait
# 之后用 task_id 查
python3 scripts/client.py task <task_id>

两个地址都必须是公网可访问的 URL，本地文件传不进去——先传到图床/对象存储/自己的服务器。 另外外部站点不一定抓得动：实测 download.samplelib.com 会返回 502 upstream timeout， 换成平台自己 OSS 上的地址（图/视频都可）就正常。

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

接口一览

接口	名称	模式	计费	说明
submit	提交任务	异步（需轮询）	输入 2.000000 点/1k	创建一条动作迁移任务，返回平台任务 ID
query	查询任务	同步	免费（查询类接口）	按平台任务 ID 查询状态与结果

接口详情

submit · 提交任务

模式：异步（提交后轮询任务） ｜ 计费：输入 2.000000 点/1k ｜ 请求：POST /api/v1/apps/action_transfer/submit

创建一条动作迁移任务，返回平台任务 ID

参数	类型	必填	默认值	说明
file_url	string / array	是	-	参考人物图片 URL。单图传字符串，多图传数组
video_url	string	是	-	输入视频 URL，也是计费时长的来源
prompt	string	否	-	动作 / 人物 / 场景的补充描述
mode	string	否	standard	fast（1 点/秒）/ standard（2 点/秒）/ max（3 点/秒）
face_count	integer	否	1	处理人数，1~7
duration	number	否	-	视频时长（秒）；不传由平台探测

计费按输入视频秒数。实测：4 秒视频走 fast 冻结 4.46 点，约 3 分钟出片。

完整文档（含请求/响应示例）：references/api-submit.md

query · 查询任务

模式：同步（直接返回结果） ｜ 计费：免费（查询类接口） ｜ 请求：POST /api/v1/apps/action_transfer/query

按平台任务 ID 查询状态与结果

（该接口无参数）

完整文档（含请求/响应示例）：references/api-query.md

关于异步任务

标记为「异步」的接口是任务制：提交后返回 task_id，需要轮询到完成。 client.py call 默认自动轮询到结束再返回，你也可以手动控制：

bash

# 只提交，不等结果
python3 scripts/client.py call action_transfer <api> --json '{...}' --no-wait

# 之后用 task_id 查状态
python3 scripts/client.py task <task_id>

异步任务在提交时会预冻结点数，任务完成后按实际用量结算。 不要重复提交同一个任务——每次提交都可能产生费用。

常见错误

返回	含义	处理
HTTP 401	Key 无效或过期	重新创建 Key 后 login
HTTP 402 / code:402	点数不足	去算力中心充值；错误信息里有本次所需点数
Invalid.Params	参数不合法	用 schema action_transfer 核对参数与必填项
任务 status: failed	上游处理失败	看 error.message；换素材或稍后重试

实测记录（2026-09）

项	结果
提交	action_transfer/submit 正常返回 task_id，冻结 4.46 点（4 秒视频 / fast 档）
出片	completed，约 3 分钟；产物是标准 MP4（ftyp/free/mdat/moov 结构完整，约 0.6 MB）
查询	action_transfer/query 免费，轮询间隔建议 15~20 秒
外链	download.samplelib.com 的样片 → 502 upstream timeout；平台自身 OSS 地址正常

所以「能不能直接用」的答案是：能用，但两个输入地址必须先放到公网，且要选平台抓得动的站点。

能力边界

• 不提供 API Key：Key 必须由使用者自己获取
• 不代付费用：调用消耗的是使用者自己账号的点数
• 不保证可用性：接口由第三方平台提供，可用性、限流与计费以站内为准
• 不替代内容合规审查：生成内容的合规责任由使用者承担

参考文件

文件	用途
references/getting-started.md	注册、充值、获取与配置 API Key
references/api-submit.md	submit 的官方文档
references/api-query.md	query 的官方文档
scripts/client.py	通用客户端（零依赖）

---

联系我们

• 技术微信：9872659 —— 加好友时说一下是从哪个 Skill 找过来的，直接给你配套的 API Key 与能跑的示例。
• 要算力 / 要 API Key：算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力，注册、充值、创建 Key 都在这里。
• 更多 AI 插件与接口：AI 插件市场。

---

相关链接

链接	地址	说明
算力集市 · 注册领 API Key	api.a7w.cn	一个 Key 调用全部 AI 算力；注册、充值、创建 Key 都在这
AI 插件市场	aigc.a7w.cn	浏览全部 AI 插件与接口说明
三剪客 · 一句话批量出片	ks.a7w.cn	短剧二创 / 影视解说 / 矩阵号批量混剪桌面客户端
视频超清 · 在线批量超分	vr.a7w.cn	网页版视频超分，批量处理，最高 4K
0人公司 · AI Agent 平台	a7w.cn	主站，了解整套 AI Agent 生态