Files
SnapOtter/apps/docs/tools/video/convert-video.md
T
SnapOtterandGitHub 00b651c9f8 feat(i18n): 21-language pipeline, landing/docs/API wiring, landing+API translations
Shared Claude Code translation pipeline (scripts/i18n, no API key) plus Astro/VitePress/Scalar i18n wiring. Landing and API reference translated into all 20 languages; docs i18n wiring + English source anchors. The translated docs markdown (apps/docs/<locale>/**, 3,620 files) follows in a companion PR because it exceeds GitHub's per-PR CI file limit.
2026-07-11 13:01:55 +08:00

1.5 KiB

description
description
Convert videos between MP4, MOV, WebM, AVI, and MKV.

Convert Video

Convert videos between MP4, MOV, WebM, AVI, and MKV formats with configurable quality presets.

API Endpoint

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

Accepts multipart form data with a video file and a JSON settings field. This is an async endpoint - it returns 202 Accepted immediately and progress is streamed via SSE at GET /api/v1/jobs/{jobId}/progress.

Parameters

Parameter Type Required Default Description
format string No "mp4" Output format: mp4, mov, webm, avi, mkv
quality string No "balanced" Quality preset: 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

  • The high quality preset produces the best visual fidelity but larger files. The small preset aggressively compresses for minimum file size.
  • WebM output uses VP9 encoding. MP4 and MOV use H.264. AVI and MKV are available for legacy or archival workflows.
  • Progress updates are available via SSE at GET /api/v1/jobs/{jobId}/progress until the job completes.