VideoUpscaling
Upscaler di video 4x
Carica un video e scaricalo ingrandito quattro volte.
Upscaling video 4x ESRGAN
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
Licenze del modello
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.
Riferimento API
Invia tramite REST
Usa la tua chiave API personale (msk_…) per creare job per questo workload dai tuoi strumenti. I job avviati in questo modo vengono eseguiti sugli stessi dispositivi che hai collegato in I tuoi dispositivi: almeno uno deve essere online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutenticati con X-Organization-Api-Key: msk_your_personal_api_key. Il nome dell'intestazione corrisponde a quello delle chiavi dell'organizzazione; le chiavi personali usano lo stesso endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign con la stessa chiave API, carica il tuo file su upload_url restituito, poi passa download_url in job_spec (ad esempio come input_image_url).Corpo della richiesta
{
"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"
}
}Campi di job_spec
| Campo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|
max_height | No | 480 | Limite all'altezza del fotogramma decodificato (di input); le sorgenti più grandi vengono ridotte prima dell'upscaling. 480 -> fino a 1920px di altezza in output. |
halo | No | 64 | Sovrapposizione dei tile (zona di fusione) in pixel LR su ogni bordo. |
overlap_frames | No | 0 | I chunk adiacenti condividono questo numero di fotogrammi; l'assemblaggio fonde le copie con un coseno, così i confini tra chunk non sfarfallano. 0 = disattivato. Ogni unità elabora comunque frames_per_unit fotogrammi (la lezione del lease da 3 fotogrammi / 2 minuti). La dimensione del tile resta nelle specifiche del job, mai in deviceCaps. |
temporal_overlap | No | false | Se true e overlap_frames è 0, attiva una fusione con sovrapposizione di 1 fotogramma. Predefinito false: è opt-in, non viene attivata in silenzio. |
crf | No | 18 | CRF H.264 per l'MP4 assemblato (più basso = qualità più alta). |
frames_per_unit | No | 3 | Fotogrammi elaborati per unità di lavoro (granularità dei chunk). |
frame_count | No | — | Fotogrammi totali da elaborare a `fps` (= ceil(durata * fps), con limite massimo). I client che hanno decodificato i metadati del video dovrebbero fornirlo: permette al server di distribuire il lavoro tra i nodi. In assenza, si usa duration_seconds, altrimenti una singola unità di lavoro elabora l'intero video. |
duration_seconds | No | — | Durata del video di origine in secondi. Compilata automaticamente dal Solutions Hub quando si seleziona un file video; usata per ricavare frame_count. |
fps | No | 24 | Frequenza di campionamento dei fotogrammi. L'output viene riprodotto con gli stessi fps. |
input_video_url | Sì | — | URL prefirmato del video di origine (a bassa risoluzione) da ingrandire. |
scale_factor | No | 4 | Fattore di upscaling spaziale (fisso a 4x per Real-ESRGAN RRDBNet). |
variant | No | ultrasharp | Variante del modello ESRGAN (UltraSharp — consigliata per i 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}Fai polling con la stessa chiave API finché status non è terminale (COMPLETED, FAILED, CANCELED o MODERATION_BLOCKED). Quando la moderazione dei contenuti è abilitata, i job possono iniziare in MODERATION_PENDING prima di entrare nella coda di calcolo. I job completati includono valori download_url presigned su ogni output.
Risposta di creazione
{
"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"
}Risposta di completamento
{
"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>"
}Carica un video e scarica una versione circa quattro volte più grande. Upscaler video gratis sui dispositivi che colleghi. La prima esecuzione scarica il modello; le clip successive partono più velocemente.