剪狐 · VIDEO UPSCALE API

视频高清 API,
连接你的画质增强流程

使用 REST API 将已有视频增强至 1080p、2K 或 4K。异步创建、查询与下载,保留帧率、声音与比例,使用独立人民币 API 钱包。

视频高清 API 提供什么?

提交 type=video_upscale 的异步任务,选择 1080p、2k 或 4k 档位。服务端探测实际素材尺寸、时长与帧率,核验费用后处理;结果通过 result.url 下载,有 API 充值或额度发放记录时免剪狐水印。提高分辨率不等于恢复真实丢失的细节。

输入与输出
最大 2 GiB、60 分钟;支持横竖屏和同分辨率增强,输出档位不能低于原片。
计费条件
按实际秒数向上取整,最低 15 秒;超过 30 FPS 单价翻倍,API 钱包与网页积分独立。
自动化接入
API Key、幂等请求、状态查询和 Webhook;高清创建通过 REST 提供,暂未增加 MCP 创建工具。

视频高清 API 怎么收费?

以下为不超过 30 FPS 的人民币标准价,超过 30 FPS 单价翻倍。服务端使用真实平均帧率判断:29.97 FPS 不翻倍,59.94 FPS 翻倍;客户端不能指定帧率或计费倍率。

档位标准价 / 秒折合 / 分钟
1080p¥0.032¥1.92
2K¥0.048¥2.88
4K¥0.080¥4.80

每个视频最低计费 15 秒,之后按实际秒数向上取整,不采用网页 30 秒档位或 1 秒缓冲。实际账户折扣价读取 GET /api/v1/balance 的 amounts.upscale_rates,最终以任务价格快照为准。

核验素材后冻结足额费用,成功交付结算,未交付的失败或允许取消部分释放冻结金额。API 不使用网页会员、赠送积分或试用截断规则。查看充值与折扣档位 ↗

四步接入视频高清 API

  1. 创建密钥并准备 API 余额

    在 API 控制台创建服务端 API Key,为独立人民币 API 钱包充值。密钥保存在你的服务端,申请上传前须具备最低计费余额。

  2. 上传素材或导入 HTTPS 直链

    申请上传后将视频直传至返回地址,或导入可直接下载的公网 HTTPS 视频直链;等待上传资源为 uploaded,再使用其 upload_id。

  3. 选择档位并创建幂等任务

    向 POST /api/v1/jobs 提交 video_upscale、input.upload_id 和 upscale.target,携带 Authorization 与唯一 Idempotency-Key。目标档位不能低于原片,元数据由服务端核验。

  4. 查询结果或接收完成回调

    通过 GET /api/v1/jobs/{job_id} 查询任务,或接收并验证 Webhook。成功后在有效期内获取 result.url,下载原尺寸成片并检查尺寸、声音及连续画面。

创建 4K 高清任务示例

curl 'https://unmarkai.cn/api/v1/jobs' \
  -H "Authorization: Bearer $UNMARKAI_API_KEY" \
  -H 'Idempotency-Key: replace-with-unique-job-id' \
  -H 'Content-Type: application/json' \
  -d '{"type":"video_upscale","input":{"upload_id":"upl_REPLACE"},"upscale":{"target":"4k"}}'

视频高清 API 常见问题

支持哪些输出分辨率?

upscale.target 支持 1080p、2k、4k。16:9 对应 1920×1080、2560×1440、3840×2160;竖屏对应交换宽高,其他比例等比例适配。支持同分辨率增强,不接受低于原片的输出档位。

60 FPS 视频与 30 FPS 视频价格一样吗?

不一样。服务端探测真实平均帧率,超过 30 FPS 单价翻倍,保留原帧率,不通过降帧降低费用。客户端不能传入 FPS 或倍率来改变计费。

会改变原声或给结果加水印吗?

API 高清结果保留原声和画面比例,有 API 充值或额度发放记录时免剪狐水印;无音轨的原片仍输出无声视频。多声道素材建议先转成立体声,下载后核对实际输出。

8 秒视频会按多少秒收费?

API 每任务最低计费 15 秒,所以 8 秒视频按 15 秒计算。超过最低时长后按实际秒数向上取整,超过 30 FPS 再应用单价倍率。

可以调用 MCP 创建高清任务吗?

高清创建目前通过 REST 的 POST /api/v1/jobs 提供,暂未增加 MCP 高清创建工具。MCP 现有能力以公开文档列出的工具为准。

失败、取消及重试如何计费?

成功交付结算,未交付的失败或允许的取消释放冻结金额。沿用任务幂等与排队取消规则,重复请求使用相同 Idempotency-Key,避免重复创建任务。

哪里可以先看实际增强效果?

视频高清功能页提供真人、动画与动态画面的原片、实际输出、同帧细节和素材来源。案例为已公开的网页处理证据,页面记录的积分不等于 API 费用。

开始接入你的视频流程

更新于 2026-11-16