VidéoAgrandissement
Agrandissement de vidéos 4x
Importez une vidéo et téléchargez-la quatre fois plus grande.
Agrandissement vidéo 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.
Licences du modèle
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.
Référence de l’API
Envoyer via REST
Utilisez votre clé API personnelle (msk_…) pour créer des tâches pour ce workload depuis vos propres outils. Les tâches lancées ainsi s’exécutent sur les mêmes appareils que ceux que vous avez connectés dans Vos appareils ; au moins l’un d’eux doit être en ligne.
https://cp.meshlabs.cloud/v1/organizations/jobsAuthentifiez-vous avec X-Organization-Api-Key: msk_your_personal_api_key. Le nom de l’en-tête est le même que pour les clés d’organisation ; les clés personnelles utilisent le même point de terminaison.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign avec la même clé API, envoyez votre fichier vers l’upload_url renvoyée, puis transmettez download_url dans job_spec (par exemple en tant que input_image_url).Corps de la requête
{
"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"
}
}Champs de job_spec
| Champ | Requis | Par défaut | Description |
|---|---|---|---|
max_height | Non | 480 | Plafond de la hauteur des images décodées (entrée) ; les sources plus grandes sont réduites avant l'agrandissement. 480 -> jusqu'à 1920 px de hauteur en sortie. |
halo | Non | 64 | Chevauchement des tuiles (zone de fondu) en pixels basse résolution sur chaque bord. |
overlap_frames | Non | 0 | Les morceaux adjacents partagent ce nombre d'images ; l'assemblage fond les copies par interpolation en cosinus afin que les frontières entre morceaux ne scintillent pas. 0 = désactivé. Chaque unité traite toujours frames_per_unit images (la leçon du bail de 3 images / 2 minutes). La taille de tuile reste définie par la spécification de la tâche, jamais par deviceCaps. |
temporal_overlap | Non | false | Si vrai et que overlap_frames vaut 0, active un fondu avec chevauchement d'une image. Faux par défaut : à activer explicitement, jamais activé silencieusement. |
crf | Non | 18 | CRF H.264 du MP4 assemblé (plus bas = meilleure qualité). |
frames_per_unit | Non | 3 | Images traitées par unité de travail (granularité des morceaux). |
frame_count | Non | — | Nombre total d'images à traiter à `fps` (= ceil(durée * fps), plafonné). Les clients qui ont décodé les métadonnées de la vidéo devraient le fournir : cela permet au serveur de répartir la tâche entre plusieurs nœuds. À défaut, se rabat sur duration_seconds ; sinon une seule unité de travail traite toute la vidéo. |
duration_seconds | Non | — | Durée de la vidéo source en secondes. Renseigné automatiquement par le Solutions Hub lorsqu'un fichier vidéo est sélectionné ; sert à déduire frame_count. |
fps | Non | 24 | Fréquence d'échantillonnage des images. La sortie est lue au même nombre d'i/s. |
input_video_url | Oui | — | URL présignée de la vidéo source (basse résolution) à agrandir. |
scale_factor | Non | 4 | Facteur d'agrandissement spatial (4x fixe pour Real-ESRGAN RRDBNet). |
variant | Non | ultrasharp | Variante du modèle ESRGAN (UltraSharp, recommandée pour la vidéo). |
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}Interrogez l’API avec la même clé jusqu’à ce que status soit dans un état final (COMPLETED, FAILED, CANCELED ou MODERATION_BLOCKED). Lorsque la modération du contenu est activée, les tâches peuvent commencer à l’état MODERATION_PENDING avant d’entrer dans la file de calcul. Les tâches terminées incluent des valeurs download_url présignées pour chaque sortie.
Réponse de création
{
"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"
}Réponse de fin d’exécution
{
"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>"
}Importez une vidéo et téléchargez une version environ quatre fois plus grande. Agrandisseur vidéo gratuit sur les appareils que vous connectez. La première exécution télécharge le modèle ; les clips suivants démarrent plus vite.