调整速度
- 变速处理，默认保持原音高，异步任务
- 倍速范围 0.25 到 4
- 与「淡入淡出」一样属于后期处理类操作
认证
All endpoints authenticate with a Bearer token.
Get an API key: open the console and create one.
Add it to the request header:
Authorization: Bearer YOUR_OAIRoute_KEY引用源音轨
产出源音轨那次任务的 id。缺失或源无法解析时，提交阶段即返回 400。
指向源任务结果 data.result.music[] 中的第几首，默认 1，从 1 起始。单次生成通常 2 首。
引用旧作品无需额外记录 id，只需要 task_id 与 audio_index。
The id of the task that produced the source track. When it's missing or the source can't be resolved, submission returns a 400.
Which track in the source task's data.result.music[], default 1, starting from 1. A single generation usually has 2.
Referencing an old work needs no extra id bookkeeping — only task_id and audio_index.
请求参数
音频模型，默认 suno，当前仅此一个取值。
目标倍速，取值 0.25 到 4。缺失或越界会在提交阶段返回 400。
变速过程中是否保留原始音高，默认 true。
结果标题，默认 Untitled。
The audio model; defaults to suno, currently the only value.
The target speed multiplier, 0.25 to 4. Missing or out of range returns a 400 at submission.
Whether to preserve the original pitch while changing speed; defaults to true.
The result title; defaults to Untitled.
keep_pitch 的取舍
这是本接口最重要的一个参数。
| 取值 | 效果 | 适合 |
|---|---|---|
true（默认） | 变速不变调，人声听起来还是同一个人 | 绝大多数场景 |
false | 变速同时变调，加速变尖、减速变沉 | 特殊效果、chipmunk 风格、DJ 混音 |
想要「同一首歌更快但不变味」，保持默认即可。想要「加快后音色也变得更活泼」，才需要显式传 false。
This is the most important parameter on the endpoint.
| Value | Effect | Best for |
|---|---|---|
true (default) | Speed changes, key doesn't; the voice stays the same person | Almost everything |
false | Speed and pitch change together — faster goes shriller, slower goes deeper | Special effects, chipmunk style, DJ mixes |
To get "the same song, faster but unchanged in character", keep the default. To make the timbre livelier along with the speed, pass false explicitly.
倍速怎么选
| 倍速 | 听感 |
|---|---|
| 0.25 | 四分之一速，极慢，适合做氛围或教学 |
| 0.5 | 半速，明显拖长 |
| 0.85 到 0.95 | 稍慢，抒情感更强 |
| 1.0 | 原速 |
| 1.05 到 1.15 | 稍快，常用于短视频节奏 |
| 1.5 | 明显加快 |
| 2.0 以上 | 极快，接近鬼畜 |
短视频场景通常用 1.05 到 1.1，既提升节奏感又不至于失真。
本端点没有版本维度，传 version 会被丢掉，也不影响计费。
| Speed | How it sounds |
|---|---|
| 0.25 | A quarter speed, very slow; suits ambience or teaching |
| 0.5 | Half speed, noticeably stretched |
| 0.85 to 0.95 | Slightly slower, more emotional |
| 1.0 | Original |
| 1.05 to 1.15 | Slightly faster, common for short-video pacing |
| 1.5 | Clearly faster |
| 2.0 and above | Very fast, approaching meme territory |
Short-video work usually uses 1.05 to 1.1, raising the pacing without audible distortion.
This endpoint has no version dimension; passing version is discarded and doesn't affect billing.
响应与轮询
响应状态码，成功为 200。
提交成功时为 submitted。
任务唯一标识，用于轮询 GET /v1/music/tasks/{task_id}。
轮询间隔 3 到 5 秒，典型耗时 30 到 120 秒。中间态 pending 或 processing，progress 为 0 到 100 整数，变化节点不固定。终态 completed 或 failed。
完成后从 data.result.music[] 读取处理后的 audio_url。失败原因见 data.error.message，预扣额度自动退回。
The response status code; 200 on success.
submitted on successful submission.
The unique task identifier, used to poll GET /v1/music/tasks/{task_id}.
Poll every 3 to 5 seconds; typical duration is 30 to 120 seconds. Intermediate states are pending or processing, progress is an integer from 0 to 100 that doesn't change on fixed steps, and terminal states are completed or failed.
On completion, read the processed audio_url from data.result.music[]. The failure reason is in data.error.message, and the held balance is refunded automatically.
错误码
For error response formats, 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 之后才有结果。
Submit a task and get a task_id:
A successful submission only means the task was accepted. To get the actual output, poll the task query endpoint with the returned task_id; results appear only after status becomes completed.