Files
SnapOtter/apps/docs/id/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
Hasilkan visualisasi bentuk gelombang sebagai gambar PNG dari file audio. 5480106dfe48 human 2ee074ff47df

Waveform Image

Hasilkan visualisasi bentuk gelombang sebagai gambar PNG dari file audio, dengan dimensi dan warna yang dapat dikonfigurasi.

API Endpoint

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

Menerima multipart form data berisi file audio dan field JSON settings.

Parameters

Parameter Type Required Default Description
width integer No 1024 Lebar gambar dalam piksel (256 hingga 3840)
height integer No 256 Tinggi gambar dalam piksel (64 hingga 1080)
color string No "#4f46e5" Warna heksadesimal bentuk gelombang (mis. "#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

  • Output selalu berupa gambar PNG, terlepas dari format audio input.
  • Bentuk gelombang dirender pada latar belakang transparan.
  • Berguna untuk thumbnail, pratinjau media sosial, atau penyematan di halaman web.