工作原理
视频放大使用与视频生成相同的异步队列系统:- 排队 —— 使用
topaz-video-upscale模型将视频提交至/video/queue - 轮询 —— 使用返回的
queue_id调用/video/retrieve,直到状态为completed - 完成 —— 调用
/video/complete进行收尾并获取输出 URL
放大倍数
对于放大模型,
upscale_factor 参数取代了 resolution。传入 resolution 将返回错误。这是因为输出分辨率取决于输入视频的尺寸 —— 对 720p 视频进行 2x 放大与对 480p 视频进行 2x 放大会产生不同的结果。支持的输入格式
- 格式:MP4、MOV、WebM
- 输入方式:HTTPS URL 或
data:video/...;base64,...data URL - 最长时长:300 秒(5 分钟)
API 使用
排队一个放大作业
queue_id:
轮询完成状态
通过 complete 完成收尾
检索到结果后,调用/video/complete 完成收尾:
API 参数
放大模型不使用的参数
以下参数对topaz-video-upscale 不接受,如果提供将返回错误:
duration 参数也会被忽略 —— 服务器直接从视频文件检测时长以确保计费准确。
定价
定价基于时长、输出分辨率等级和帧率。输出分辨率等级由输入视频的高度乘以放大倍数决定。输出分辨率等级
帧率超过 48fps 的视频费用为每秒费率的 2 倍。
定价示例
使用 Video Quote API 在提交作业前获得准确定价。
获取报价
input_height,以便估算输出分辨率等级。这是可选的 —— 若省略,报价将采用保守估算。