BPM 分析

分析歌曲的速度，异步任务
引用源音轨用 task_id 加 audio_index
只返回分析结果，不产出音频

POST/v1/music/generations/bpm

认证

string必填

所有接口均使用 Bearer Token 进行认证。

获取 API Key：访问控制台创建。

请求时在请求头中添加：

Authorization: Bearer YOUR_OAIRoute_KEY

请求参数

string可选

音频模型，默认 suno。

string必填

产出源音轨那次任务的 task_id。缺失或无法解析源音轨时，提交阶段直接返回 400。

integer可选

引用源任务结果 data.result.music[] 中的第几首，默认 1，从 1 开始。

一次生成通常 2 首，即索引 1 和 2。

本端点没有版本维度，不要传 version。传了会被丢弃，也不影响计费。

引用源音轨只需 task_id 与 audio_index 两个值，无需记录任何额外 id。

响应

integer

响应状态码。

data[] 的元素字段 · 2 项

string

任务状态，提交后为 submitted。

string

任务唯一标识，用于轮询 GET /v1/music/tasks/{task_id}。

BPM 有什么用

用途	说明
配乐选曲	按目标节奏筛选，短视频常用 100 到 130
剪辑对齐	按 BPM 算一拍时长，让画面切点踩在节拍上
二次创作	混搭或续写时保持节奏一致
曲库检索	按速度区间分类管理素材

算一拍时长：60 / BPM 秒。120 BPM 就是一拍 0.5 秒，四拍一小节 2 秒。

Use	Notes
Choosing soundtrack	Filter by target tempo; short videos commonly use 100 to 130
Edit alignment	Compute the beat length from BPM so cuts land on the beat
Remixing	Keep tempo consistent when mashing up or continuing
Library search	Classify assets by tempo range

Beat length is 60 / BPM seconds. At 120 BPM one beat is 0.5 seconds, and a four-beat bar is 2 seconds.

错误码

HTTP	type	说明
400	invalid_request_error	请求参数无效
401	authentication_error	身份验证失败，请检查API密钥
402	payment_required	账户余额不足
429	rate_limit_error	请求过于频繁

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

HTTP	type	Notes
400	invalid_request_error	Invalid request parameters
401	authentication_error	Authentication failed; check the API key
402	payment_required	Insufficient account balance
429	rate_limit_error	Too many requests

For more status codes and retry guidance see Error codes and rate limits; for troubleshooting steps on common errors see the FAQ.

使用示例

提交一个任务并拿到 task_id：

提交成功只表示任务已受理。真正的产物要拿返回的 task_id 去任务查询接口轮询，status 变成 completed 之后才有结果。

curl -X POST https://api.oairoute.com/v1/music/generations/bpm \ -H 'Authorization: Bearer YOUR_OAIRoute_KEY' \ -H 'Content-Type: application/json' \ --data '{ "model": "suno", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K", "audio_index": 1 }'

import requests res = requests.post( "https://api.oairoute.com/v1/music/generations/bpm", headers={ "Authorization": "Bearer YOUR_OAIRoute_KEY", "Content-Type": "application/json", }, json={ "model": "suno", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K", "audio_index": 1, }, ) print(res.json()["data"][0]["task_id"])

const res = await fetch( "https://api.oairoute.com/v1/music/generations/bpm", { method: "POST", headers: { Authorization: "Bearer YOUR_OAIRoute_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ model: "suno", task_id: "task_01K8SGYNNNVBQTXNR4MM964S7K", audio_index: 1, }), } ); const { data } = await res.json(); console.log(data[0].task_id);