跳转到主要内容
视频放大让您可以将现有视频提升至更高分辨率,同时改善视觉质量。Topaz Video Upscale 模型使用 AI 驱动的放大技术将分辨率提升 2 倍或 4 倍,或在原分辨率(1 倍)上进行质量增强。

工作原理

视频放大使用与视频生成相同的异步队列系统:
  1. 排队 —— 使用 topaz-video-upscale 模型将视频提交至 /video/queue
  2. 轮询 —— 使用 model 和返回的 queue_id 调用 /video/retrieve。作业运行期间,它返回包含 "status": "PROCESSING" 的 JSON。作业完成后,响应体就是放大后的 MP4(Content-Type: video/mp4),因此请将其保存为文件。不会提供输出 URL。
  3. 清理(可选) —— 保存文件后,调用 /video/complete 删除存储的输出
服务器会自动从上传的文件中检测输入视频的时长、帧率和尺寸。您无需提供这些值 —— 计费根据实际视频元数据计算。

放大倍数

对于放大模型,upscale_factor 参数取代了 resolution。传入 resolution 将返回错误。这是因为输出分辨率取决于输入视频的尺寸 —— 对 720p 视频进行 2x 放大与对 480p 视频进行 2x 放大会产生不同的结果。

支持的输入格式

  • 格式:MP4、MOV、WebM
  • 输入方式:HTTPS URL 或 data:video/...;base64,... data URL
  • 最长时长:300 秒(5 分钟)

API 使用

排队一个放大作业

响应包含用于跟踪作业的 queue_id:

轮询并保存结果

放大完成后的结果就是响应体本身,而不是某个 JSON 字段,因此请在解析之前检查 Content-Type。cURL 示例会打印每个响应的内容类型:重复执行,直到它打印出 video/mp4,此时 upscaled.mp4 中保存的就是视频。如果排队响应中包含 download_url,retrieve 会改为返回包含 "status": "COMPLETED" 的 JSON,您需要从该 URL 下载文件。请参阅私有下载链接。

清理(可选)

保存 MP4 之后,您可以调用 /video/complete 删除存储的输出。它不会返回视频或 URL。

API 参数

放大模型不使用的参数

以下参数对 topaz-video-upscale 不接受,如果提供将返回错误: duration 参数也会被忽略 —— 服务器直接从视频文件检测时长以确保计费准确。

定价

定价基于时长、输出分辨率等级和帧率。输出分辨率等级由输入视频的高度乘以放大倍数决定。

输出分辨率等级

帧率超过 48fps 的视频费用为每秒费率的 2 倍。

定价示例

使用 Video Quote API 在提交作业前获得准确定价。

获取报价

对于放大模型的报价,video_url 是必填的 —— 报价端点会获取文件并从字节中检测时长、FPS 和高度,因此无需另行提供这些信息。省略它会返回 400 及 “video_url is required for quotes on this model”。 放大模型的报价需要 API 密钥。不带 API 密钥的请求会返回 403。 向 /video/quote 传入与您将发送到 /video/queue 相同的 upscale_factor(1、2 或 4),以使报价与作业一致。对于放大模型,报价端点也接受 resolution("2x" 或 "4x")作为已弃用的别名;如果两者同时发送,以 upscale_factor 为准。

故障排查