Files
SnapOtter/apps/docs/zh-CN/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

1.6 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 67bec3789b19

Convert Video

在 MP4、MOV、WebM、AVI 和 MKV 格式之间转换视频,并可配置质量预设。

API Endpoint

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

接受包含视频文件和 JSON settings 字段的 multipart 表单数据。这是一个异步端点:它会立即返回 202 Accepted,进度通过 SSE 在 GET /api/v1/jobs/{jobId}/progress 处流式传输。

Parameters

Parameter Type Required Default Description
format string No "mp4" 输出格式:mp4movwebmavimkv
quality string No "balanced" 质量预设:highbalancedsmall

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 处获取进度更新。