VideoPhóng to
Nâng cấp video 4x
Tải video lên và tải về bản lớn hơn gấp bốn lần.
Phóng to video 4x bằng ESRGAN
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
Giấy phép mô hình
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.
Tài liệu tham khảo API
Gửi qua REST
Dùng khóa API cá nhân của bạn (msk_…) để tạo tác vụ cho workload này từ công cụ của riêng bạn. Tác vụ khởi chạy theo cách này chạy trên chính các thiết bị bạn đã kết nối tại Thiết bị của bạn — ít nhất một thiết bị phải trực tuyến.
https://cp.meshlabs.cloud/v1/organizations/jobsXác thực bằng X-Organization-Api-Key: msk_your_personal_api_key. Tên header giống với khóa tổ chức; khóa cá nhân dùng cùng endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign với cùng khóa API, tải tệp của bạn lên upload_url được trả về, rồi truyền download_url trong job_spec (ví dụ dưới dạng input_image_url).Nội dung yêu cầu
{
"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"
}
}Các trường của job_spec
| Trường | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
max_height | Không | 480 | Giới hạn chiều cao khung hình giải mã (đầu vào); nguồn lớn hơn sẽ được thu nhỏ trước khi phóng to. 480 -> chiều cao đầu ra tối đa 1920px. |
halo | Không | 64 | Độ chồng lấn giữa các ô (vùng trộn) tính bằng điểm ảnh LR ở mỗi cạnh. |
overlap_frames | Không | 0 | Các khối liền kề chia sẻ số khung hình này; bước ghép sẽ trộn cosine các bản sao để ranh giới giữa các khối không bị nhấp nháy. 0 = tắt. Mỗi đơn vị vẫn xử lý frames_per_unit khung hình (bài học về lease 3 khung hình / 2 phút). Kích thước ô vẫn theo job-spec, không bao giờ theo deviceCaps. |
temporal_overlap | Không | false | Khi bật và overlap_frames bằng 0, bật trộn chồng lấn 1 khung hình. Mặc định tắt — phải chủ động bật; không tự bật ngầm. |
crf | Không | 18 | CRF H.264 cho tệp MP4 được ghép (thấp hơn = chất lượng cao hơn). |
frames_per_unit | Không | 3 | Số khung hình được xử lý trong mỗi đơn vị công việc (độ chi tiết của khối). |
frame_count | Không | — | Tổng số khung hình cần xử lý ở `fps` (= ceil(duration * fps), có giới hạn trên). Các máy khách đã giải mã siêu dữ liệu video nên cung cấp giá trị này — nó cho phép máy chủ chia tác vụ ra nhiều node. Nếu thiếu sẽ quay về duration_seconds, nếu không thì một đơn vị công việc duy nhất xử lý toàn bộ video. |
duration_seconds | Không | — | Thời lượng video nguồn tính bằng giây. Được Solutions Hub tự động điền khi chọn tệp video; dùng để suy ra frame_count. |
fps | Không | 24 | Tốc độ lấy mẫu khung hình. Đầu ra phát lại ở cùng số fps. |
input_video_url | Có | — | URL được ký trước của video nguồn (độ phân giải thấp) cần phóng to. |
scale_factor | Không | 4 | Hệ số phóng to không gian (cố định 4x cho Real-ESRGAN RRDBNet). |
variant | Không | ultrasharp | Biến thể mô hình ESRGAN (UltraSharp — khuyến nghị cho video). |
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}Thăm dò bằng cùng khóa API cho đến khi status ở trạng thái kết thúc (COMPLETED, FAILED, CANCELED hoặc MODERATION_BLOCKED). Khi kiểm duyệt nội dung được bật, tác vụ có thể bắt đầu ở MODERATION_PENDING trước khi vào hàng đợi tính toán. Tác vụ đã hoàn tất có các giá trị download_url được ký trước trên mỗi đầu ra.
Phản hồi khi tạo
{
"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"
}Phản hồi khi hoàn tất
{
"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>"
}Tải video lên và tải về một phiên bản lớn hơn khoảng bốn lần. Công cụ phóng to video miễn phí trên các thiết bị bạn kết nối. Lần chạy đầu tiên sẽ tải mô hình về; các đoạn sau sẽ bắt đầu nhanh hơn.