VídeoAmpliação
Ampliador de vídeos 4x
Envie um vídeo e baixe-o quatro vezes maior.
ESRGAN 4x Ampliação de Vídeo
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
Licenças do modelo
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.
Referência da API
Enviar via REST
Use sua chave de API pessoal (msk_…) para criar tarefas desta carga de trabalho a partir das suas próprias ferramentas. As tarefas iniciadas dessa forma rodam nos mesmos dispositivos que você conectou em Seus dispositivos — pelo menos um deles precisa estar online.
https://cp.meshlabs.cloud/v1/organizations/jobsAutentique-se com X-Organization-Api-Key: msk_your_personal_api_key. O nome do cabeçalho é o mesmo das chaves de organização; as chaves pessoais usam o mesmo endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign com a mesma chave de API, envie seu arquivo para o upload_url retornado e depois passe download_url em job_spec (por exemplo, como input_image_url).Corpo da solicitação
{
"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"
}
}Campos de job_spec
| Campo | Obrigatório | Padrão | Descrição |
|---|---|---|---|
max_height | Não | 480 | Limite da altura do quadro decodificado (de entrada); fontes maiores são reduzidas antes da ampliação. 480 -> até 1920px de altura de saída. |
halo | Não | 64 | Sobreposição de blocos (zona de mistura) em pixels LR em cada borda. |
overlap_frames | Não | 0 | Blocos adjacentes compartilham essa quantidade de quadros; a montagem faz a mistura por cosseno das cópias para que os limites entre blocos não cintilem. 0 = desligado. Cada unidade ainda processa frames_per_unit quadros (a lição do lease de 3 quadros / 2 minutos). O tamanho do bloco continua sendo da especificação do trabalho, nunca de deviceCaps. |
temporal_overlap | Não | false | Quando verdadeiro e overlap_frames é 0, ativa uma mistura de sobreposição de 1 quadro. Padrão falso — é preciso optar; não é ativado silenciosamente. |
crf | Não | 18 | CRF H.264 do MP4 montado (menor = maior qualidade). |
frames_per_unit | Não | 3 | Quadros processados por unidade de trabalho (granularidade dos blocos). |
frame_count | Não | — | Total de quadros a processar em `fps` (= ceil(duration * fps), limitado). Os clientes que decodificaram os metadados do vídeo devem informar este valor — ele permite ao servidor distribuir o trabalho entre nós. Se ausente, recorre a duration_seconds; caso contrário, uma única unidade de trabalho processa o vídeo inteiro. |
duration_seconds | Não | — | Duração do vídeo de origem em segundos. Preenchida automaticamente pelo Hub de Soluções quando um arquivo de vídeo é selecionado; usada para derivar frame_count. |
fps | Não | 24 | Taxa de amostragem de quadros. A saída é reproduzida com o mesmo fps. |
input_video_url | Sim | — | URL pré-assinada do vídeo de origem (baixa resolução) a ampliar. |
scale_factor | Não | 4 | Fator de ampliação espacial (fixo em 4x para o Real-ESRGAN RRDBNet). |
variant | Não | ultrasharp | Variante do modelo ESRGAN (UltraSharp — recomendada para vídeo). |
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}Consulte com a mesma chave de API até que status seja final (COMPLETED, FAILED, CANCELED ou MODERATION_BLOCKED). Quando a moderação de conteúdo está habilitada, as tarefas podem começar em MODERATION_PENDING antes de entrar na fila de computação. As tarefas concluídas incluem valores download_url pré-assinados em cada saída.
Resposta de criaçã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"
}Resposta de conclusão
{
"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>"
}Envie um vídeo e baixe uma versão cerca de quatro vezes maior. Ampliador de vídeo grátis nos dispositivos que você conecta. A primeira execução baixa o modelo; os clipes seguintes começam mais rápido.