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

工作原理

视频放大使用与视频生成相同的异步队列系统:
  1. 排队 —— 使用 topaz-video-upscale 模型将视频提交至 /video/queue
  2. 轮询 —— 使用返回的 queue_id 调用 /video/retrieve,直到状态为 completed
  3. 完成 —— 调用 /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 在提交作业前获得准确定价。

获取报价

对于放大模型的报价,video_url必填的 —— 报价端点会获取文件并从字节中检测时长、FPS 和高度,因此无需另行提供这些信息。省略它会返回 400“video_url is required for quotes on this model”
报价端点和排队端点目前对放大倍数的命名不同:/video/queue 使用 upscale_factor124),而 /video/quoteresolution"2x""4x")中读取倍数。向报价端点发送 upscale_factor 没有任何效果——它会回退到 "2x" 默认值,从而为可能是 4x 的作业返回 2x 的价格。为 4x 放大报价时,请传入 resolution: "4x"

故障排查