Files
SnapOtter/apps/docs/de/tools/video/video-to-gif.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.8 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Einen Videoclip in ein animiertes GIF verwandeln. f729dde8cd55 human 8de2f0e20107

Video to GIF

Einen Videoclip in ein animiertes GIF mit konfigurierbarer Bildrate, Breite, Startzeit und Dauer verwandeln.

API Endpoint

POST /api/v1/tools/video/video-to-gif

Nimmt Multipart-Formulardaten mit einer Videodatei und einem JSON-Feld settings entgegen. Dies ist ein asynchroner Endpunkt: Er gibt sofort 202 Accepted zurück, und der Fortschritt wird per SSE unter GET /api/v1/jobs/{jobId}/progress gestreamt.

Parameters

Parameter Type Required Default Description
fps integer No 12 Ausgabe-Bildrate (1-30)
width integer No 480 Ausgabebreite in Pixeln (64-1280). Die Höhe skaliert proportional
startS number No 0 Startzeit in Sekunden (muss >= 0 sein)
durationS number No 5 Dauer in Sekunden (über 0, max. 60)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/video-to-gif \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"fps": 15, "width": 320, "startS": 2, "durationS": 8}'

Example Response

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

Notes

  • Niedrigere Werte für fps und width erzeugen kleinere GIF-Dateien. Ein 480px breites GIF mit 12 fps ist meist ein guter Kompromiss.
  • Die maximale Dauer beträgt 60 Sekunden. Längere Clips erzeugen sehr große Dateien.
  • Fortschrittsaktualisierungen sind per SSE unter GET /api/v1/jobs/{jobId}/progress verfügbar, bis der Job abgeschlossen ist.