使用我們的 REST API 在您的應用程式中建構強大的音樂生成功能。
透過單個 API 呼叫生成您的第一首曲目。
curl -X POST https://api.fm9.ai/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "歡快的電子舞曲"}'{
"id": "gen_abc123",
"status": "processing",
"estimated_time": 30
}所有 API 請求都需要 API 金鑰。在 Authorization 標頭中包含您的金鑰：
從以下位置取得您的 API 金鑰 開發者控制台.
Authorization: Bearer YOUR_API_KEY/v1/generate建立新的音樂生成任務。
prompt-要生成的音樂的文字描述（必需）duration-曲目長度（秒）（30-180，預設：60）style-音樂風格預設（可選）instrumental-是否只生成純音樂（預設：false）傳回包含任務 ID 和狀態的生成物件。
/v1/generation/:id檢查生成任務的狀態。
傳回包含目前狀態的生成物件，完成時包含下載連結。
/v1/generations檢索您的生成歷史列表。
limit-要傳回的結果數量（預設：20，最大：100）offset-分頁偏移量（預設：0）status-按狀態篩選（pending、processing、completed、failed）簡單透明的按使用量計費。
每月 10 次生成
每月 500 次生成
無限制
為確保公平使用和服務穩定性，適用以下速率限制：
如果超過速率限制，您將收到 429 請求過多回應。
API 使用標準 HTTP 回應代碼來指示成功或失敗。
| Code | Description |
|---|---|
| 400 | 錯誤請求 - 無效參數 |
| 401 | 未授權 - 無效或缺失 API 金鑰 |
| 402 | 需要付款 - 點數不足 |
| 429 | 請求過多 - 超出速率限制 |
| 500 | 伺服器內部錯誤 - 我們這邊出了問題 |