腾讯云超分台 · 2 点一秒,4K 也能提

一句话:1080P 2 点/秒、2K 4 点/秒、4K 8 点/秒,走 api.a7w.cn 的腾讯云 MPS 音视频增强,
异步任务(提交拿 task_id → 轮询取成片)。一条 10 分钟的片子提满 4K,48 块。

先申请你自己的 API Key:本包不内嵌 Key,用的是你自己在 api.a7w.cn 注册的 Key,扣的是你自己账户的余额。一条命令存好:python3 scripts/a7w.py login --key sk-你的key

价目表

档位接口单价保底10 分钟30 分钟
1080PPOST /api/v1/video/tencent10802 点/秒(¥0.02)10 点1200 点 = ¥123600 点 = ¥36
2KPOST /api/v1/video/tencent2k4 点/秒(¥0.04)10 点2400 点 = ¥247200 点 = ¥72
4KPOST /api/v1/video/tencent4k8 点/秒(¥0.08)10 点4800 点 = ¥4814400 点 = ¥144
  • 按输入视频秒数计费(不是输出),1 元 = 100 点;单笔保底 10 点(2 秒 4K 也只收 10 点)
  • 任务失败 全额退回;查询接口 不扣费;成品链接保留 24 小时
  • 选档:1080P 走老片 / 录屏 / 竖屏短剧;2K 上大屏投影;4K 交付级母版

为什么选腾讯线

同一条产线(阿里 VIAPI)的报价是 1080P 9 点/秒、2K 15 点/秒、4K 20 点/秒:

档位腾讯 MPS阿里 VIAPI便宜
1080P2 点/秒9 点/秒4.5 倍
2K4 点/秒15 点/秒3.75 倍
4K8 点/秒20 点/秒2.5 倍

10 分钟 4K:VIAPI 12000 点(¥120),这里 4800 点(¥48),一条片子省 72 块。
10 分钟 1080P 差得更多:¥54 → ¥12。

干货一:duration 必须显式传

平台会拿 video_url 自己 ffprobe 探时长,探不到就直接拒单。实测原样:

POST /api/v1/video/tencent1080   {"videoUrl": "https://example.invalid/x.mp4"}
400 {"error":{"code":"duration_unknown","message":"无法探测视频时长,请显式传 duration(秒)","type":"relay"}}

所以本包把 --duration 做成必填,--url 只收 http(s):// 公网地址。
缺 --duration 直接退 2,一个请求都不发;给了就先按 duration × 单价 算点数过闸门,
提交前你就知道这一单多少钱,不用等账单。duration 接受小数(实测 "12.5" 被当成 12.5 秒)。

干货二:计费按输入秒数、失败全退

按输入秒数算钱,不是输出秒数 —— 4K 输出体积是 1080P 的几倍,秒单价只差 4 倍,
不存在「清晰度越高越亏」的隐藏倍率。任务失败(含上游报错)全额退回,status 有 netPoints 可对账。

干货三:查询三级回退,全都免费

status 依次试 GET /api/v1/video/{tier}/{task_id}(文档写的)、
GET /api/v1/videos/{task_id}(统一任务对象,实测通)、/api/v1/me/tasks(本人台账)。
三条都是只读、不扣费;tasks 直接把最近任务连 netPoints 一起列出来。

三步上手

# 1) 自检(不扣费)  2) 先算钱(不扣费)
python3 scripts/run.py doctor
python3 scripts/run.py cost --tier 4k --duration 600
#   算账:600 秒 × 8 点/秒 = 4800 点  →  **4800 点 = 48.00 元**

# 3) 提交 + 自动等结果
python3 scripts/run.py submit --url https://example.com/low.mp4 --tier 4k \
    --duration 600 --yes

常用命令

python3 scripts/run.py catalog                       # 三档清单 + 单价 + 保底
python3 scripts/run.py submit --url ... --tier 2k --duration 300 --yes
python3 scripts/run.py submit --url ... --tier 4k --duration 600 --no-wait   # 只提交
python3 scripts/run.py submit --url ... --duration 600 --dry-run             # 只看请求
python3 scripts/run.py status task_xxx --tier 4k     # 查一个任务(免费)
python3 scripts/run.py tasks --limit 10              # 我最近的任务(免费)

参数

参数默认说明
--url必填公网可访问的 http(s) 视频地址
--tier4k1080p / 2k / 4k
--duration必填视频秒数(按它计费)
--callback-url—任务完成回调地址
--wait / --no-wait等提交后是否轮询到完成
--interval / --timeout10 / 3600轮询间隔 / 总超时(秒)
--out—把成片下载到这个本地路径
--budget6000点数上限(单位:点,1 元 = 100 点)
--yes—确认真实扣费

子命令

catalog 三档清单 + 单价 + 保底(免费)· cost 先算钱(免费)· doctor 自检 Key / 余额 / 三档端点 / 查询路由(免费)·
submit 提交任务(按秒计费,要 --yes)· status 查一个任务(免费)· tasks 我最近的任务(免费)· log 本地台账(免费)。

退出码

码含义
0 成功 · 2 用法错(缺 --url / --duration、档位错、选项缩写)· 4 缺 --yes
5 预算不足(一个请求都不发)· 6 调用失败 / 任务失败 · 1 内部错 · 130 中断

--json 契约

{"ok": true, "tier": "tencent4k", "resolution": "4K", "taskId": "task_xxx",
 "status": "success", "seconds": 600, "points": 4800, "yuan": 48.0,
 "videoUrl": "https://.../superres/xxx.mp4", "route": "/api/v1/videos/task_xxx"}

失败是 {"ok": false, "exit": 5, "error": {"kind": "budget", "message": "…"}}。
--json 写在子命令前面或后面都可以,stdout 只有一个 JSON 文档。

实测记录(2026-11-07)

提交    POST /api/v1/video/tencent1080   {"video_url": "...", "duration": "12.5"}
返回    502 {"error":{"code":"FailedOperation.InvalidMpsUser",
             "message":"腾讯云超分提交失败:[FailedOperation.InvalidMpsUser] invalid mps user"}}

这是本次唯一触到上游提交的探针(duration 传字符串 "12.5",平台照收并转发给腾讯云),被上游凭据侧拦下 —— 报错即不建单、不扣点;平台侧配通后本包代码零改动即可用。三档端点与查询路由也都用零成本探针验过(详见 references/api-contract.md):400 duration_unknown = 端点对了,400 task_not_exist = 查询路由对了。

关于 tsc_* 系列

价目表里还有 tsc_teshd(短剧增强)、tsc_shortplay 等 **11 个 tsc_* 档位**,
路由尚未开放(实测 /api/v1/video/tsc_teshd、/video/tencent/tsc_teshd、
/apps/media_services_33/teshd 等路径变体都是 404)。本包先把 1080P / 2K / 4K 做扎实,
网关开放后第一时间接上。

文件结构

正好 7 个文件:SKILL.md · README.md · LICENSE.md · references/api-contract.md ·
references/troubleshooting.md · scripts/a7w.py(全家族逐字节一致)· scripts/run.py(本包命令层)。

联系我们

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

同类文章