三剪客 · 视频增强台

api.a7w.cn 在架的那 10 档视频增强能力,共用一个「上传 → 提交 → 轮询 → 下载」流程,
只是路径和单价不同 —— 所以做成一个台子,而不是 10 个包。

## ⚠️ 先申请你自己的 API Key
本 Skill 不内嵌任何密钥,也不代付费用。 请到
算力集市 api.a7w.cn 注册并创建你自己的 API Key
(新用户有赠送点数,可以先免费试跑几条)。
拿到后填进环境变量 A7W_API_KEY,或用 login 子命令保存,或直接传给 --key。
请勿使用他人提供的 Key —— 用量与费用都记在 Key 所属账号上。


10 档(单价 = 点/秒,1 元 = 100 点)

档位 id中文名路径点/秒元/秒单条上限素材要求
upscale4K旗舰版POST /api/v1/video/upscale30¥0.3030 秒任意公网地址
superres标准超分 1080PPOST /api/v1/video/viapi/superres9¥0.09600 秒本站素材
superres2k高清超分 2K.../viapi/superres2k15¥0.15600 秒本站素材
superres4k超清超分 4K.../viapi/superres4k20¥0.20600 秒本站素材
portrait人像增强.../viapi/portrait18¥0.18600 秒本站素材
subtitle字幕擦除.../viapi/subtitle9¥0.09600 秒本站素材
cartoon人像卡通化.../viapi/cartoon24¥0.24600 秒本站素材
segment人像抠像.../viapi/segment9¥0.0960 秒本站素材
enhance画质综合增强.../viapi/enhance15¥0.15600 秒本站素材
colorize视频校色.../viapi/colorize9¥0.09600 秒本站素材

但它有输入门槛 —— 输入需 <1920×1080。


⚠️ 三件事必须在动手前知道

1. upscale 档不校验素材可达性 —— 这是最容易白花钱的一档

给它一个 404 的地址,它照样返回 201 并冻结点数(30 点/秒,2 秒就 60 点)。
所以:本包对每一档都先探素材可达性 + 本地 ffprobe,探不到就拒绝提交,
要强行绕过必须显式 --force。

2. duration 不传就会被「按 5 秒收费」

服务端逻辑是:

let d = Math.ceil(Number(payload.duration) || 0);
if (!d) d = Math.ceil(await probeVideoDuration(url));   // 服务端自己 ffprobe
if (!(d > 0)) d = 5;                                    // ← 探测不到就按 5 秒

本包一律先本地探测;拿不到时长就报错要求显式 --duration,
绝不静默按 5 秒提交(那等于为未知时长付费)。

3. viapi/* 那 9 档只收「本网关素材」 —— 先 upload

素材通道只有一条:用本网关的 upload 把本地文件传上来,再把返回的地址交给 --url。
不再需要任何第三方站点。

POST api.a7w.cn/api/v1/upload      multipart/form-data,字段名 file
      ↓ 200 返回
https://oss.gpu.likeadmin.cn/openapi/…      ← 把这个地址原样交给 --url 即可
python3 scripts/run.py upload 你的视频.mp4       # 免费,不建任务
python3 scripts/run.py doctor                    # 零成本实测线上入口判据
python3 scripts/run.py enhance --tier colorize --url <上面返回的地址> \
    --duration 12 --budget 200 --yes --wait --out out.mp4
你的素材地址upscale其余 9 档
本网关 upload 返回的 oss.gpu.likeadmin.cn/openapi/…✅ 可用由线上入口判据决定(跑 doctor 实测)
任意第三方公网地址✅ 可用❌ 400 url_not_allowed(未扣费)
本站素材地址✅ 可用✅ 可用

⚠️ 入口判据以线上为准。 doctor 的「入口白名单」一项会零成本实测:
拿一个上传域里根本不存在的地址去打这一档 ——
未放行 → 400 url_not_allowed;已放行 → 502 oss_mirror_failed。
两条路都在冻结扣费之前返回,所以不建任务、不扣费。

本包还会在本地提前用人话拦住,不会让你白撞一次请求:

✗ **标准超分 1080P**(`superres`)只收**本网关素材**,你的地址不在入口判据内;提交必然被拒
  (好在服务端是在扣费之前拒的,不会花钱)。
      → 先把本地文件用本网关 `upload` 传上来,再用它返回的地址:
          python3 scripts/run.py upload 你的视频.mp4
      → 或换 `sanjianke-vr-upscale-4k`(4K旗舰版,不需要判据,收任意公网地址);
      → 或跑 `doctor` 看「入口白名单」这一项的零成本实测结果。

⚖️ 字幕擦除(subtitle)的合规边界

subtitle 档做的是去除画面上的硬字幕 / 文字。使用它意味着你承诺:

  • 你对素材拥有合法权利 —— 是你自己拍摄/制作的,或已获得权利人明确授权;
  • 不得用于去除他人作品的权利管理信息(水印、署名、版权标识等),

也不得用于规避平台原创声明、盗用他人内容后伪装成原创;

  • 需要保留原始素材与授权凭证,以备平台或权利人核查。

本包不判断你的授权,授权责任在使用者。 拿不准就不要做这一档。


快速开始

# 0) 看看有哪些档位、各多少钱(免费、连 Key 都不用)
python3 scripts/run.py tiers

# 1) 配一次 Key(验证 + 保存到 ~/.a7w/config.json)
python3 scripts/run.py login --key sk-你的key

# 2) 环境体检:Key / 档位表 / 上传入口 / 素材白名单 / 本机 ffprobe(免费,不建任务)
python3 scripts/run.py doctor

# 3) 先算钱:这条 12 秒的片子要多少钱(纯本地,一次请求都不发)
python3 scripts/run.py cost --for superres:12
python3 scripts/run.py cost --for upscale:10 --for subtitle:120

# 4) 白验一遍:把能免费验的全验掉,但**不提交**
python3 scripts/run.py enhance --tier superres \
    --url https://cdn2.jiujiushuyuan.cn/vr/demo/your.mp4 \
    --duration 12 --dry-run

# 5) 正式提交(--yes 才真花钱),并一次轮询到出片
python3 scripts/run.py enhance --tier superres \
    --url https://cdn2.jiujiushuyuan.cn/vr/demo/your.mp4 \
    --duration 12 --budget 500 --yes --wait --out out.mp4

# 6) 也可以先提交、稍后再查
python3 scripts/run.py enhance --tier upscale --url <地址> --duration 8 --yes
python3 scripts/run.py status task_xxxx --out out.mp4
python3 scripts/run.py tasks

闸门顺序(为什么 --dry-run 能免费验这么多)

线上服务端的判定顺序是:

空 URL  →  素材白名单  →  素材可达性/转存  →  ffprobe 时长  →  单条上限
        →  输入规格预检  →  冻结扣费  →  提交上游

扣费点很靠后,所以参数错、地址不在白名单、规格不符,全部在扣费之前返回,天然免费。
本包再在此之上补了「素材可达性」(替 upscale 补课)、「本机 ffprobe」、「预算」三道,
全部发生在提交之前:

[闸门1] 用法      --url / --tier / --duration / --budget 合法性                  exit 2
[闸门2] 白名单    9 档要求本站素材(本包提前拦,服务端也会拦)                   exit 3
[闸门3] 可达性    探素材 HTTP(**替 upscale 补的课**,它自己不看)               exit 3
[闸门4] 时长      本地 ffprobe;拿不到就报错,绝不静默 5 秒                      exit 3
[闸门5] 上限      单条时长上限(upscale 30s / segment 60s / 其余 600s)          exit 3
[闸门6] 规格      超分与人像增强输入需 <1920×1080                                exit 3
[闸门7] 预算      --budget(**单位:点**)                                       exit 5
[闸门8] 确认      不加 --yes 只报价,不提交                                      exit 4
                   ↓
              才真正 POST 提交(这一步之后才会花钱)

子命令一览

子命令作用花钱
tiers列出 10 档:单价 / 单条上限 / 素材要求免费
login --key sk-x验证并保存 Key 到 ~/.a7w/config.json免费
whoami确认 Key 有效免费
doctor体检:Key / 档位表 / 上传入口 / 白名单 / ffprobe免费,不建任务
cost [秒数] --tier X / --for X:秒只算钱,一次请求都不发免费
upload <文件>把本地视频传到本站,拿地址免费,不建任务
enhance --tier --url --duration提交增强任务(--dry-run 白验 / --wait 等出片)真花钱
status <taskId> [--out]查状态;成片转存完成后可下载免费
tasks列出本包提交过的任务(本地台账)免费

--json 机读契约

// 成功
{"ok": true, ...}
// 失败
{"ok": false, "exit": 3, "error": {"kind": "gate", "message": "..."}}
exit含义error.kind
0成功—
1内部错误internal
2用法错误usage
3闸门没过(白名单 / 可达性 / 时长 / 上限 / 规格)gate
4需要 --yes(报价已打印,未提交)confirm
5预算超限budget / insufficient_points
130被中断interrupt

--json 写在子命令前面或后面都可以(--json tiers 与 tiers --json 等价)。


计费口径(必须与中继完全一致)

冻结 = ceil(输入秒数) × 单价        先向上取整到整秒,再乘费率
结算 = 完成后按实际时长结算,多退少补
失败 = 全额自动退回(有幂等保护)
1 元 = 100 点

例:12 秒 → superres 108 点(¥1.08)/upscale 360 点(¥3.60)/subtitle 108 点(¥1.08)。


报错 → 人话


查询为什么要带档位

查询接口是路径形式:

GET /api/v1/video/upscale/<taskId>
GET /api/v1/video/viapi/<tier>/<taskId>

所以 status 需要知道档位(--tier)。本包提交过的任务会记进本地台账
~/.a7w/video-vr-tasks.json,status 会自己去找,不用你手动填。

⚠️ 不要用 GET /api/v1/tasks/<id> 查这 10 档 —— 那是网关自有层,
返回 {"code":0,"msg":"任务不存在"},查不到 relay 的任务。


和其它超分包的区别(避免重复劳动)

包走什么用途
本包 sanjianke-video-vrrelay 的 /api/v1/video/*(api.a7w.cn 在架的 10 档)按秒计费的多档视频增强,含字幕擦除/抠像/卡通化/校色
sanjianke-video-upscaleapi.a7w.cn 的 flashvsr 插件 + 本地 ffmpeg超分专题:糊片救 4K 的判断标准与两条路线
a7w-flashvsr网关自有 app flashvsrFlashVSR 超分插件

别的包都没有的:字幕擦除、人像抠像(mask 视频)、人像卡通化、视频校色、
画质综合增强,以及按秒计费 + 免费档位/报价/白验这一套成本控制。


已知边界(如实说明)

  • 9 档只收本网关素材:先用 upload <文件> 上传、再用返回的地址提交(见上文 §3)。

入口判据以线上为准 —— doctor 会零成本实测并如实报告(400 = 未放行,502 = 已放行,
两条路都在扣费之前,都不花钱)。不需要任何第三方站点。

  • tiers 的在线权威源不稳定:线上 GET /api/v1/video/viapi/tools 早先免鉴权可读,

后来变成 401/404。本包会自动退回内置档位表(单价取自 api.a7w.cn 在架能力),
并把「在线源当前不可达」如实打出来。价格与规格以线上为准。
本包只能提前拦,不能改变上游行为。


相关文件

  • references/api-contract.md —— 10 档完整契约:请求/查询/单价/上限/白名单/闸门顺序
  • references/cost-and-limits.md —— 计费口径、各档上限、输入规格、成本与毛利
  • references/troubleshooting.md —— 报错对照、排错顺序、--json 契约、真机实测记录

联系我们

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

同类文章