视频后处理台 11 个能力一个命令

本包不内嵌 Key:用你自己在 api.a7w.cn 注册的 Key,扣你自己的余额。填 Key:python3 scripts/a7w.py login --key sk-你的key。

一句话

9 点一秒起,11 个视频工序一条命令。 去台标、擦字幕、校色、增强、修复、换脸、抠像、卡通化、提人像、认字幕、找镜头 —— 全部走 api.a7w.cn,异步两步、零依赖。

价目表(按点/秒从低到高,1 元 = 100 点)

能力--tier单价10 分钟干什么
校色 / 黑白上色colorize9 点/秒5,400 点黑白片自动上色,还原自然色调
人像抠像 / 绿幕segment9 点/秒5,400 点输出人像 mask 视频,换背景用
字幕擦除subtitle9 点/秒5,400 点擦掉硬字幕,二创换字幕的第一步
画质综合增强enhance15 点/秒9,000 点清晰度 / 对比度 / 细节整体提一档
人像增强portrait18 点/秒10,800 点只提人脸清晰度,GPEN 路线
换脸 / 人脸融合faceswap20 点/秒12,000 点视频里最大的人脸换成你的人脸图
镜头检测shot20 点/次20 点按镜头切分,返回切点帧号
人像卡通化cartoon24 点/秒14,400 点真人转动漫风
硬字幕 / 演职员表 OCRcastcrew25 点/次25 点抽硬字幕与滚动演职员表,附 SRT
台标 / Logo 擦除delogo25 点/次25 点擦台标、平台 logo(最多 2 个区域)
视频修复restore36 点/秒21,600 点去划痕 / 噪点 / 闪烁,老片抢救

shot / castcrew / delogo 的价签写「点/次」,引擎规则却是 per_second —— 本包按价签收一次,cost 会把两种口径都打出来,最终以账单为准。

--tier 怎么选

你要干什么用哪个
老片发灰、偏色、黑白片要上色colorize(9 点/秒,最便宜)
二创要换字幕,先把原字幕抹掉subtitle(9 点/秒)
换背景 / 做绿幕素材segment(9 点/秒,输出人像 mask)
片子糊、要整体提一档enhance;只想把人脸提清楚用 portrait
画面有划痕、噪点、闪烁restore(36 点/秒,修复强度最高)
视频里换一张脸faceswap(还要 --face-url 人脸图)
真人转动漫风cartoon
去台标 / 平台 logodelogo(25 点/次)
要分镜点、要按镜头切片shot(20 点/次,纯结构化结果)
要硬字幕文本、要演职员表 SRTcastcrew(25 点/次)

三步上手

# 1) 自检:Key / 11 个端点 / 价目表 / 查询 / 上传,全免费
python3 scripts/run.py doctor

# 2) 上传本地片子,拿一个能直接提交的地址(免费,单文件默认 512 MB)
python3 scripts/run.py upload --file input.mp4
#    → https://oss.gpu.likeadmin.cn/openapi/18/20261107/xxxx.mp4   (最长 24 小时)

# 3) 先算钱,再提交,再查
python3 scripts/run.py cost --tier delogo
python3 scripts/run.py submit --tier delogo --video-url "https://oss.gpu.likeadmin.cn/openapi/18/20261107/xxxx.mp4" --yes
python3 scripts/run.py status --task-id task_xxx

三条别人不会告诉你的

一、11 档走的不是同一条路径。 空 body 实测:/api/v1/video/viapi/restore 返回 404 unknown_tool(「未知的视频工具:restore」)—— 修复只有扁平那条 /api/v1/video/restore。反过来 faceswap / segment / cartoon 的扁平路径是 404(落到 SPA 首页),只有 viapi 那条通。路径表写死在包里,catalog 逐档打出来,doctor 逐档探一遍。

二、videoUrl 用平台托管的地址。 外站地址会被挡在门口:400 url_not_allowed,原文三选一 —— 本站 vr.a7w.cn、本站七牛 cdn2.jiujiushuyuan.cn/vr/、本站上传接口 oss.gpu.likeadmin.cn/openapi/。所以 upload 是标配:传完拿 data.url 直接喂 submit,全程免费,只受 512 MB 单文件上限约束。

三、按秒档「先冻结、后结算」。 提交时按 duration 预冻结(缺省 5 秒),完成后按实际时长结算,任务失败全额退回。submit 不传 --duration 也能跑,cost 就按 5 秒估;想算准就显式传秒数。

常用命令

python3 scripts/run.py catalog                                    # 11 档 + 路径 + 单价
python3 scripts/run.py cost                                       # 全档 1/10/30 分钟价目
python3 scripts/run.py submit --tier restore --video-url "..." --duration 180 --budget 8000 --yes
python3 scripts/run.py submit --tier faceswap --video-url "..." --face-url "..." --yes
python3 scripts/run.py submit --tier colorize --video-url "..." --dry-run   # 只看请求
python3 scripts/run.py status --task-id task_xxx --tier colorize
python3 scripts/run.py log --limit 10

不加 --yes 退 4 并告诉你这次要花多少点;预计点数 > --budget 退 5,一个请求都不发(--budget 单位是点,默认 5000 = 50 元)。

参数

参数默认说明
--tier必填11 档之一,见 catalog
--video-url必填平台托管的视频地址(先 upload)
--duration5视频秒数,用于预冻结;按次档不需要
--face-url—人脸参考图,任意 http(s) 图片地址(只 faceswap)
--seed / --callback-url—只 restore 用
--file—upload 用,本地文件路径
--route / --allow-any-urlauto / —强制路径 / 跳过本地白名单预检
--budget5000点数上限(单位:点,1 元 = 100 点)
--yes / --dry-run—确认真实提交 / 只打印请求

子命令

子命令扣费吗干什么
catalog免费11 档能力 + 每档实际路径 + 单价
cost免费1 / 10 / 30 分钟价目
doctor免费自检 Key / 11 个端点 / 价目表 / 查询 / 上传
upload免费上传本地视频,拿可提交的地址
submit按档计费提交任务(要 --yes)
status免费查任务(video/viapi/result/{id},带 refund)
log免费本地台账

退出码

码含义
0 / 2成功 / 用法错(参数缺失、地址预检没过、选项缩写)
3 / 4doctor 出现 × / 没给 --yes
5 / 6预算不足(一个请求都不发)/ 调用失败
1 / 130内部错误 / 被 Ctrl-C 中断

--json 契约

{"ok": true, "tier": "colorize", "taskId": "task_xxx", "status": "PENDING",
 "duration": 30, "cost": 270, "balance": 999999, "estimatedPoints": 270}

失败:{"ok": false, "exit": 5, "error": {"kind": "budget", "message": "…"}};kind 取 usage|gate|confirm|budget|call|interrupt|internal。--json 写在子命令前后都可以,stdout 只有一个 JSON 文档。

文件结构

sanjianke-video-lab/{SKILL.md, README.md, LICENSE.md,
  references/{api-contract.md, troubleshooting.md},
  scripts/{a7w.py, run.py}}

计费口径与保底

  • 成品链接有效期约 30 分钟,status 拿到就转存。
  • shot / castcrew / delogo 按次结算,与素材时长无关;按秒档最小计 1 秒。
  • portrait 价签写 18 点/秒、注里写「公测免费」,以实际账单为准。
  • --budget 与 --yes 是本地闸门:预算内才发请求,--yes 到了才提交。

联系我们

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

同类文章