Files
SnapOtter/apps/docs/de/tools/audio/waveform-image.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
Erzeugt aus einer Audiodatei eine Wellenform-Visualisierung als PNG-Bild. 5480106dfe48 human db47e6d98839

Waveform Image

Erzeugt aus einer Audiodatei eine Wellenform-Visualisierung als PNG-Bild mit konfigurierbaren Abmessungen und Farbe.

API Endpoint

POST /api/v1/tools/audio/waveform-image

Akzeptiert Multipart-Formulardaten mit einer Audiodatei und einem JSON-Feld settings.

Parameters

Parameter Typ Erforderlich Standard Beschreibung
width integer Nein 1024 Bildbreite in Pixeln (256 bis 3840)
height integer Nein 256 Bildhöhe in Pixeln (64 bis 1080)
color string Nein "#4f46e5" Hex-Farbe der Wellenform (z. B. "#4f46e5")

Example Request

curl -X POST http://localhost:1349/api/v1/tools/audio/waveform-image \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"width": 1920, "height": 400, "color": "#e07832"}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.png",
  "originalSize": 4500000,
  "processedSize": 45000
}

Notes

  • Die Ausgabe ist unabhängig vom Eingabe-Audioformat immer ein PNG-Bild.
  • Die Wellenform wird auf einem transparenten Hintergrund gerendert.
  • Nützlich für Miniaturansichten, Social-Media-Vorschauen oder zum Einbetten in Webseiten.