Files
SnapOtter/apps/docs/vi/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.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Tạo hình ảnh trực quan hóa dạng sóng dưới dạng ảnh PNG từ một tệp âm thanh. 5480106dfe48 human 0ee8f9af1835

Waveform Image

Tạo hình ảnh trực quan hóa dạng sóng dưới dạng ảnh PNG từ một tệp âm thanh, với kích thước và màu sắc có thể cấu hình.

API Endpoint

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

Nhận dữ liệu multipart form với một tệp âm thanh và một trường JSON settings.

Parameters

Parameter Type Required Default Description
width integer No 1024 Chiều rộng ảnh tính bằng pixel (256 đến 3840)
height integer No 256 Chiều cao ảnh tính bằng pixel (64 đến 1080)
color string No "#4f46e5" Màu hex của dạng sóng (ví dụ "#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

  • Đầu ra luôn là một ảnh PNG, bất kể định dạng âm thanh đầu vào.
  • Dạng sóng được vẽ trên nền trong suốt.
  • Hữu ích cho ảnh thu nhỏ, xem trước trên mạng xã hội, hoặc nhúng vào trang web.