ChordMini API 文件
使用我們強大的音訊分析 API 的完整指南，涵蓋節拍偵測、和弦辨識等功能。
入門指南
ChordMini API 提供強大的音訊分析功能，無需驗證即可使用。立即開始發送請求來分析音訊檔案並擷取音樂資訊。
節拍偵測
使用進階機器學習模型識別節拍位置和重拍。
和弦辨識
透過多種模型選項辨識和弦進行。
歌詞擷取
從 LRClib 資料庫擷取同步歌詞。
模型資訊
取得可用模型和功能的詳細資訊。
驗證
無需 API 金鑰
ChordMini API 目前開放使用，不需要驗證。所有端點皆可公開存取， 讓您可以立即開始使用。
未來變更
未來版本可能需要驗證。請實作適當的錯誤處理以應對潛在的 `401/403` 回應。
速率限制
ChordMini API 實施了生產級別的速率限制，以確保公平使用和系統穩定性。速率限制因端點的運算需求而異。
| 端點 | 方法 | 速率限制 | 原因 |
|---|---|---|---|
| / | GET | 30/分鐘 | 健康檢查、狀態監控 |
| /api/model-info | GET | 20/分鐘 | 資訊端點，中度使用 |
| /api/detect-beats | POST | 2/分鐘 | 大量處理，資源密集 |
| /api/recognize-chords* | POST | 2/分鐘 | 大量處理，機器學習推論 |
| /api/lrclib-lyrics | POST | 10/分鐘 | 含時間戳的同步歌詞 |
| /api/genius-lyrics | POST | 10/分鐘 | Genius.com 歌詞擷取 |
可用模型
ChordMini 提供多種機器學習模型，適用於不同的音訊分析任務。每個模型針對特定的使用場景和效能特性進行了最佳化。
節拍偵測模型
Madmom
預設具有高準確度和速度的神經網路，最適合常見拍號（3/4、4/4）。
最適合：流行、搖滾、電子音樂
Beat-Transformer
具有 5 通道音訊分離的深度學習模型，拍號彈性高，處理速度較慢。
最適合：複雜混音、多層器樂編曲
和弦辨識模型
Chord-CNN-LSTM
預設卷積與 LSTM 神經網路，用於和弦辨識，支援 301 種和弦標籤。準確度與效能的絕佳平衡。
標籤：301 種和弦類型 • 最適合：通用和弦辨識
API 端點
在本地執行時，所有端點可在以下位址存取：http://localhost:5001
如需遠端/生產環境端點存取，請聯繫維護者。遠端測試時請注意速率限制和使用限制。
POST/api/detect-beats
分析音訊檔案並回傳節拍時間戳、BPM 和拍號。
- 參數： `file`（音訊檔案）、`model`（可選：`beat-transformer`、`madmom`、`auto`）
POST/api/recognize-chords
分析音訊檔案並回傳含時間戳的和弦進行。
- 參數： `file`（音訊檔案）、`model`（可選：`chord-cnn-lstm`）
使用範例
以下是使用 Javascript 和 cURL 呼叫 ChordMini API 的實用範例。
使用 Javascript 進行和弦辨識
1const formData = new FormData();2formData.append('file', audioFile);3formData.append('model', 'chord-cnn-lstm');45const response = await fetch(6 'http://localhost:5001/api/recognize-chords',7 {8 method: 'POST',9 body: formData10 }11);1213const result = await response.json();14console.log(result);
使用 cURL 進行節拍偵測
1curl -X POST "http://localhost:5001/api/detect-beats" \2 -F "file=@your-audio-file.mp3" \3 -F "model=beat-transformer"
使用 cURL 進行和弦辨識
1curl -X POST "http://localhost:5001/api/recognize-chords" \2 -F "file=@your-audio-file.mp3" \3 -F "model=chord-cnn-lstm"
API 狀態
監控 ChordMini API 服務和端點的即時狀態。
後端服務
節拍偵測運作中
和弦辨識運作中
歌詞服務運作中
基礎設施
Google Cloud Run線上
速率限制啟用
CORS 支援啟用