动作迁移
动作迁移，基于参考图片和输入视频生成动作迁移后的视频结果。
权限与用途说明
| 能力 | 是否申请 | 用途 |
|---|---|---|
| 网络访问 | 申请 | 调用 api.a7w.cn 的插件接口（本 Skill 唯一的联网行为） |
| 读取文件 | 仅读取用户指定的输入文件（图片/音频/视频） | 作为接口的素材入参 |
| 写入文件 | 仅在传入 --out 时 |
保存接口返回的 JSON 结果 |
| 凭证 | 读取使用者自己提供的 API Key | 从 ~/.a7w/config.json 或环境变量读取 |
| 子进程 / 后台常驻 | 不申请 | 脚本执行完即退出 |
不内嵌任何密钥。 脚本只把 Key 发往 api.a7w.cn，不发送到其他任何地址。
快速开始
# 1. 配置你自己的 api.a7w.cn API Key（只需一次）
python3 scripts/client.py login --key sk-你的key
# 2. 看这个插件的接口与参数
python3 scripts/client.py schema action_transfer
# 3. 调用（示例）
python3 scripts/client.py call action_transfer submit --json '{}'
没有 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
（该接口无参数）
完整文档（含请求/响应示例）：references/api-submit.md
query · 查询任务
模式：同步（直接返回结果） ｜ 计费：免费（查询类接口） ｜ 请求：POST /api/v1/apps/action_transfer/query
按平台任务 ID 查询状态与结果
（该接口无参数）
完整文档（含请求/响应示例）：references/api-query.md
关于异步任务
标记为「异步」的接口是任务制：提交后返回 task_id，需要轮询到完成。
client.py call 默认自动轮询到结束再返回，你也可以手动控制：
# 只提交，不等结果
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；换素材或稍后重试 |
能力边界
- 不提供 API Key：Key 必须由使用者自己获取
- 不代付费用：调用消耗的是使用者自己账号的点数
- 不保证可用性：接口由第三方平台提供，可用性、限流与计费以站内为准
- 不替代内容合规审查：生成内容的合规责任由使用者承担
参考文件
| 文件 | 用途 |
|---|---|
references/getting-started.md |
注册、充值、获取与配置 API Key |
references/api-submit.md |
submit 的官方文档 |
references/api-query.md |
query 的官方文档 |
scripts/client.py |
通用客户端（零依赖） |