影片放大
4 倍影片放大器
上傳影片,即可下載放大四倍的版本。
ESRGAN 4x 影片放大
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 固定為 4x)。 |
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>"
}上傳影片,即可下載約放大四倍的版本。在您連接的裝置上免費放大影片。首次執行會下載模型,之後的片段啟動更快。