调用方式
本站提供两条等价入口，任选其一（均已实测可用）：
① 按能力分路径：POST /api/v1/video/viapi/<tool>（tool = superres / segment / faceswap / …），参数直接放在 body 里。
② 统一入口：POST /api/v1/video/viapi/submit，body 里用 tool 字段指定能力。
# ① 分路径（实测 202）
POST /api/v1/video/viapi/faceswap
Authorization: Bearer <API_KEY>
Content-Type: application/json
{ "videoUrl": "https://vr.a7w.cn/result/in.mp4",
"faceUrl": "https://hq.a7w.cn/showcase/yuye_hero.jpg",
"duration": 5 }
# ② 统一入口（实测 201）
POST /api/v1/video/viapi/submit
{ "tool": "faceswap", "videoUrl": "…", "faceUrl": "…", "duration": 5 }轮询结果：GET /api/v1/video/viapi/result/<taskId>（返回任务状态与成片链接；/result/ 与 /query/ 为等价路径，由同一处理器处理。成片链接有效期约 30 分钟，请及时转存）。
人脸 / 图片素材（faceUrl）：可传任意 http(s) 图片地址，服务端会自动镜像转存到本站阿里云上海 OSS 后再提交上游，无需先上传；单张 ≤15MB、抓取超时 20 秒，获取失败会返回明确错误码（mirror_failed / image_too_large / image_fetch_timeout）而非静默失败。视频素材（videoUrl）当前仍仅支持本站（vr.a7w.cn）或本站七牛（cdn2.jiujiushuyuan.cn/vr/）地址，或请先上传，视频体积较大暂不放开外部域名。
等价写法：POST /api/v1/video/viapi/<tool> 与 POST /api/v1/video/viapi/submit 由同一处理器处理，GET /api/v1/video/viapi/<tool>/<taskId> 为其等价轮询写法。
计费与退点规则
- 点数口径：1 元 = 100 点；表中「元」按 100 点 = ¥1 换算。
- 视频类能力按输出视频秒计费，向上取整、最小计 1 秒；提交时按预估时长预冻结，任务完成后按实际时长结算。
- 任务失败全额退回（含上游超时、算法报错、转存失败等）。
- 图像类能力（图像增强与分割、人脸人体、OCR、内容安全、图像识别）计划按次计费，单价在对接完成后公布，当前一律标注「待定」。
- 表内「站点另有」非 VIAPI 能力：
4K旗舰版（POST /api/v1/video/upscale，百炼 PixVerse，30 点/秒）与视频修复（POST /api/v1/video/restore，百炼视频编辑，36 点/秒），不计入本目录。
注：视频插帧（InterpolateVideoFrame）为阿里云侧限量开放能力，若上游不可用，本站按失败处理全额退回。
老照片修复 · 档位选择与点数
接口：POST /api/v1/apps/aigc_photo_restore/generate/index（body 传 image_url 与 size）· 上游为阿里云百炼 qwen-image-3.0-pro 同步图像编辑。
尺寸档： 本次点数：105 点 （¥1.05 / 张）
算式：1K = 上游 0.27 元（27 点）×3 ×1.3 = 105 点/张；2K = 上游 0.52 元（52 点）×3 ×1.3 = 203 点/张。
示例：{"image_url":"https://…/old.jpg","size":"2k"} → 返回 data.image_url / data.size / data.tier / data.points。未知 size 默认按 1K 计费；超过 2048×2048 的请求按 2K 计费并自动夹到 2048（实测 4096 与 2560 均被上游拒绝，没有 4K 档）。
Key 策略：能力白名单 + 每 KEY 配额（2026-10-03 上线）
同一账号可签发多把 Key，并**按 Key** 限制可用能力与用量；**未设置策略的 Key 行为完全不变**（全部放行、不限量）。
能力名（分层，支持整线通配 video:* / app:* / *）：chat、tts、asr、clone、image、video:superres、video:faceswap、video:segment、app:file_qa、app:pic_lipsync、models。
配额：dailyPoints（自然日，服务器本地时区 00:00 重置）、monthlyPoints（自然月 1 日重置）、maxInflight（并发任务数）。
错误码：未授权能力 → 403 capability_not_allowed（响应含 capability 与实际缺失能力名）；点数配额用尽 → 402 key_quota_exceeded（含 period/used/limit）；并发超限 → 429 key_inflight_exceeded（含 inflight/limit）。
管理：POST /admin/keys/<keyFp>/policy 设置，GET /admin/keys/<keyFp>/policy 读策略与实时用量，GET /admin/key-policies 查看全部。用量落 data/key-usage.json，策略落 data/key-policy.json（均原子写、不依赖账本窗口）。