使用我们的 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 | 服务器内部错误 - 我们这边出了问题 |