Files
SnapOtter/apps/docs/uk/tools/video/convert-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
Конвертує відео між MP4, MOV, WebM, AVI та MKV. 8f9e6418b1c6 human 4ba1d103b4d3

Convert Video

Конвертує відео між форматами MP4, MOV, WebM, AVI та MKV із налаштовуваними пресетами якості.

API Endpoint

POST /api/v1/tools/video/convert-video

Приймає дані форми multipart із відеофайлом і полем JSON settings. Це асинхронний ендпоінт: він одразу повертає 202 Accepted, а прогрес передається через SSE за адресою GET /api/v1/jobs/{jobId}/progress.

Parameters

Parameter Type Required Default Description
format string No "mp4" Вихідний формат: mp4, mov, webm, avi, mkv
quality string No "balanced" Пресет якості: high, balanced, small

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/convert-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"format": "webm", "quality": "balanced"}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Notes

  • Пресет якості high дає найкращу візуальну точність, але більші файли. Пресет small агресивно стискає для мінімального розміру файлу.
  • Вихід у WebM використовує кодування VP9. MP4 і MOV використовують H.264. AVI та MKV доступні для застарілих або архівних робочих процесів.
  • Оновлення прогресу доступні через SSE за адресою GET /api/v1/jobs/{jobId}/progress до завершення завдання.