동영상업스케일링
4배 동영상 업스케일러
동영상을 업로드하고 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/jobsX-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 | 아니요 | — | 원본 동영상 길이(초)입니다. 동영상 파일을 선택하면 Solutions Hub가 자동으로 채우며 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}status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 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>"
}동영상을 업로드하면 약 4배 크기의 버전을 다운로드할 수 있습니다. 연결한 기기에서 무료로 동영상을 업스케일하세요. 처음 실행할 때는 모델을 내려받으며, 이후 클립은 더 빠르게 시작됩니다.