视频放大
4 倍视频超分辨率
上传视频,下载放大四倍的版本。
ESRGAN 4 倍视频放大
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
模型许可证
Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause
Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.
Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0
NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.
API 参考
通过 REST 提交
使用您的个人 API 密钥(msk_…),从您自己的工具为此工作负载创建任务。以这种方式启动的任务会在您于您的设备中连接的同一批设备上运行——至少需要有一台在线。
https://cp.meshlabs.cloud/v1/organizations/jobs使用 X-Organization-Api-Key: msk_your_personal_api_key 进行身份验证。该请求头名称与组织密钥相同;个人密钥使用相同的端点。
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign,将文件上传到返回的 upload_url,然后在 job_spec 中传入 download_url(例如作为 input_image_url)。请求体
{
"workload_type": "esrgan-video-upscale",
"job_spec": {
"max_height": 480,
"halo": 64,
"overlap_frames": 0,
"temporal_overlap": false,
"crf": 18,
"frames_per_unit": 3,
"fps": 24,
"input_video_url": "https://…/your-input.png",
"scale_factor": 4,
"variant": "ultrasharp"
}
}job_spec 字段
| 字段 | 必填 | 默认值 | 说明 |
|---|---|---|---|
max_height | 否 | 480 | 解码后(输入)帧高度上限;更大的源会在放大前先缩小。480 -> 输出高度最高 1920px。 |
halo | 否 | 64 | 每条边上的分块重叠(混合区),以 LR 像素计。 |
overlap_frames | 否 | 0 | 相邻分块共享这么多帧;合成时会对这些副本做余弦混合,避免分块边界闪烁。0 = 关闭。每个单元仍然处理 frames_per_unit 帧(3 帧 / 2 分钟租约的经验教训)。分块大小始终由任务规格决定,从不取决于 deviceCaps。 |
temporal_overlap | 否 | false | 为 true 且 overlap_frames 为 0 时,启用 1 帧重叠混合。默认 false:需主动选择开启,不会悄悄打开。 |
crf | 否 | 18 | 合成 MP4 的 H.264 CRF(越低质量越高)。 |
frames_per_unit | 否 | 3 | 每个工作单元处理的帧数(分块粒度)。 |
frame_count | 否 | — | 以 `fps` 处理的总帧数(= ceil(duration * fps),有上限)。已解码视频元数据的客户端应提供此值:它能让服务器把任务分发到多个节点。否则回退到 duration_seconds,再否则由单个工作单元处理整段视频。 |
duration_seconds | 否 | — | 源视频时长,以秒计。选择视频文件时由解决方案中心自动填写;用于推算 frame_count。 |
fps | 否 | 24 | 帧采样率。输出以相同的 fps 播放。 |
input_video_url | 是 | — | 待放大的源(低分辨率)视频的预签名 URL。 |
scale_factor | 否 | 4 | 空间放大倍数(Real-ESRGAN RRDBNet 固定为 4 倍)。 |
variant | 否 | ultrasharp | ESRGAN 模型变体(UltraSharp,推荐用于视频)。 |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "esrgan-video-upscale",
"job_spec": {
"max_height": 480,
"halo": 64,
"overlap_frames": 0,
"temporal_overlap": false,
"crf": 18,
"frames_per_unit": 3,
"fps": 24,
"input_video_url": "https://…/your-input.png",
"scale_factor": 4,
"variant": "ultrasharp"
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}使用同一 API 密钥轮询,直到 status 进入终态(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。启用内容审核时,任务可能会先处于 MODERATION_PENDING 状态,然后才进入计算队列。已完成的任务会在每个输出上包含预签名的 download_url 值。
创建响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "esrgan-video-upscale",
"status": "PENDING",
"job_spec_json": {
"max_height": 480,
"halo": 64,
"overlap_frames": 0,
"temporal_overlap": false,
"crf": 18,
"frames_per_unit": 3,
"fps": 24,
"input_video_url": "https://…/your-input.png",
"scale_factor": 4,
"variant": "ultrasharp"
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}完成响应
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "esrgan-video-upscale",
"status": "COMPLETED",
"job_spec_json": {
"max_height": 480,
"halo": 64,
"overlap_frames": 0,
"temporal_overlap": false,
"crf": 18,
"frames_per_unit": 3,
"fps": 24,
"input_video_url": "https://…/your-input.png",
"scale_factor": 4,
"variant": "ultrasharp"
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}上传视频,下载约放大四倍的版本。在您连接的设备上免费放大视频。首次运行会下载模型,之后的片段启动更快。