Files
SnapOtter/apps/docs/pt-BR/tools/video/resize-video.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.1 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Escala um vídeo para uma nova resolução ou tamanho predefinido. bb1f67871fea human a449db5e331c

Resize Video

Escala um vídeo para uma nova resolução usando dimensões de pixels personalizadas ou um preset padrão.

API Endpoint

POST /api/v1/tools/video/resize-video

Aceita dados de formulário multipart com um arquivo de vídeo e um campo JSON settings.

Parameters

Parâmetro Tipo Obrigatório Padrão Descrição
width integer Não - Largura de destino em pixels (16-7680)
height integer Não - Altura de destino em pixels (16-4320)
preset string Não "custom" Preset de resolução: custom, 2160p, 1440p, 1080p, 720p, 480p, 360p

Quando preset é "custom", pelo menos um entre width ou height deve ser fornecido. A outra dimensão é escalada proporcionalmente.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/resize-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"preset": "720p"}'

Redimensionar para dimensões personalizadas:

curl -X POST http://localhost:1349/api/v1/tools/video/resize-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"width": 1280, "height": 720}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 25000000,
  "processedSize": 8500000
}

Notes

  • Os valores de preset mapeiam para alturas padrão (por exemplo, 720p = 1280x720, 1080p = 1920x1080). A largura é escalada proporcionalmente a partir da proporção da origem.
  • As dimensões são arredondadas para números pares, conforme exigido pela maioria dos codecs de vídeo.
  • A resolução máxima suportada é 7680x4320 (8K UHD).