1080P视频超分与自然肤色

增强画面细节，按镜头稳定校正白平衡与肤色。保留完整画幅、原帧率和原声音轨，输出短边1080P，不额外插帧。

费用与确认

先探测视频并提供预估价及预留上限。提交任务时确认最高金额，系统冻结该额度；成功后按确认的报价规则结算，剩余冻结款退回。失败不收费。最终收费不会超过已确认的上限，预估价并非固定的按视频秒数报价。

任务等待期间可查询状态；等待超过1小时将取消并释放冻结金额。处理时间随视频长度和规格变化。

1. 提交视频报价

curl -X POST https://puream.cn/api/ai/video-upscale/quotes \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"video_url":"https://your-cdn.example/input.mp4"}'

返回HTTP 202与 quote_id。使用同一密钥查询 GET /api/ai/video-upscale/quotes/{quote_id}，直到 status=ready，读取 estimated_charge_cents 和 reservation_cents。报价就绪后15分钟内可提交。

输入为可公开访问的视频URL；接受8位SDR、逐行扫描、方形像素、恒定帧率1–60fps、最长10分钟、最大2GB的单视频轨素材。可选单条AAC声音轨以便原样保留。旋转标签素材需先转正，超宽画幅、HDR或报价超过可用额度会明确拒绝，不会裁剪主体或改帧率。

2. 确认上限并创建任务

curl -X POST https://puream.cn/api/ai/video-upscale/tasks \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"quote_id":"vsq_..."}'

max_charge_cents 的单位为分，可省略以使用报价的预留上限，或给出更低的最高金额。余额不足返回402，尚未启动处理。重复提交同一报价会返回同一任务，不会重复生成或扣费；改变已使用报价的确认金额会返回409。

3. 查询、结算与下载

GET /api/ai/video-upscale/tasks/{task_id}
Authorization: Bearer YOUR_API_KEY

状态包括 queued、running、settling、completed、failed。只有 billing_status=charged 时，charge_cents 才是最终费用；未结算时为null，失败为0。

完成后用同一账户密钥请求返回的 download_url。下载地址受鉴权保护，支持Range断点续传，结果保存24小时。下架新建能力后，已经受理的任务仍可查询、结算和下载。

curl 'https://puream.cn/api/ai/video-upscale/tasks/vsr_.../download' \
  -H 'Authorization: Bearer YOUR_API_KEY' -o enhanced.mp4

本能力不会替内容恢复原本不存在的真实细节；自然肤色属于受限的镜头校色，重要素材应审看结果。其他画幅保持比例，以短边1080P交付。