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 "[email protected]" \
  -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.