mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
1.7 KiB
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.