Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
探索不同用例和参数配置
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
Suno timestamped-lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 使用完整指南
获取带时间戳的歌词，用于在音频播放时同步显示。非常适合在音乐播放器界面中实现卡拉 OK 风格的歌词展示。
Suno Timestamped Lyrics API 为生成的音乐曲目提供同步歌词数据。每一行歌词都包含精确到秒的时间戳信息，帮助开发者创建卡拉 OK 风格的显示效果、歌词同步功能以及更出色的音乐播放体验。该 API 还会返回用于音频可视化的波形数据，非常适合构建同时具备歌词显示和音频视觉呈现能力的完整音乐播放器界面。
Suno Timestamped Lyrics API 提供带有精确秒级时间戳的歌词，确保文本显示与音频播放完美同步。每一行歌词都会按照音轨内容进行精准定时。
除了带时间戳的歌词，API 还会返回可用于音频可视化的波形数据数组。这使开发者能够创建具有视觉音频呈现能力的丰富、交互式音乐播放器界面。
API 输出针对卡拉 OK 风格应用进行了优化。借助精准的时间控制和完整歌词文本，开发者可以轻松实现边唱边高亮和滚动歌词显示等功能。
创建账户并获取你的 Suno Timestamped Lyrics API Key。该密钥用于验证所有请求，并将用量关联到你的账户。
首先，使用 Suno 音乐生成 API 创建你的音轨。保存生成响应中的 taskId 和 audioId，后续获取带时间戳歌词时需要用到它们。
使用你的 taskId 和 audioId 调用 Timestamped Lyrics API。API 将返回包含精确时间戳和波形信息的同步歌词数据。
在你的应用中使用带时间戳的数据创建同步歌词显示。结合波形数据，可实现更出色的视觉效果。
该 API 同时需要 taskId 和 audioId 参数。taskId 用于标识生成会话，而 audioId 用于指定该会话中的具体音轨。
所有时间戳值均以浮点数形式按秒提供。这样在需要时可实现精确到毫秒级的同步。
对于使用 instrumental=true 生成的曲目，将不会提供歌词数据。API 仍会返回波形和时长信息。
将同步歌词集成到音乐播放器应用中，让用户能够实时跟随歌曲播放查看歌词，并通过与音频播放匹配的高亮文本提升体验。
通过精准的歌词时间控制构建卡拉 OK 功能，让用户能够借助恰到好处高亮歌词的视觉提示跟唱。
创建教育类应用，帮助用户学习歌词、理解歌曲结构，并通过准确同步的文本显示练习节奏把握。
在社交平台的音乐分享功能中，同步展示歌词与音频播放内容，打造更具吸引力的内容体验。
apipass.dev 为 Suno Timestamped Lyrics API 访问提供高性价比定价，适用于从个人开发者到大型应用等各种规模的项目。
清晰详尽的 API 文档包含代码示例和集成指南，帮助开发者快速在应用中实现带时间戳的歌词功能。
全天候技术支持可确保你的歌词同步功能稳定运行，并在你需要时提供专家协助。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
使用 SDK 创建任务，保存返回的 taskId，并获取 Suno 的结果。
运行这些 SDK 示例前，请先安装 @apipass-dev/apipass-sdk。
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdk请将 API Key 保存在服务端环境变量中。SDK 会自动以 Bearer token 发送，并添加 JSON 请求头。
client.jobs.createTask获取带时间戳的歌词，以便在音频播放期间同步显示
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/timestamped-lyrics",
9 "input": {
10 "taskId": "task_xxx",
11 "audioId": "audio_xxx"
12 }
13});
14
15console.log(task.data.taskId);该 API 接受具有以下结构的 JSON 请求体：
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}model必填string用于获取带时间戳歌词的模型名称
"suno/timestamped-lyrics"
channel可选string你可以通过 channel 参数指定 APIPASS 内的对应提供商；这些提供商负责实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以在最低成本和可靠性能之间取得平衡。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象根据表单配置包含以下参数：
input.taskId必填string由之前的 suno/generate 或 suno/extend createTask 调用返回的 ApiPass taskId。不要传入上游 NextMusic 提供商的任务 ID。
必填字段，最大长度：100 个字符
"task_12345678"
input.audioId必填string已完成源任务结果项中的音频 ID。
必填字段，最大长度：100 个字符
"audio_abc123xyz"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.lyrics歌词对象数组，每个对象包含时间戳（以秒为单位）和文本
data.lyrics[].timestamp该行歌词应显示的时间戳值，以秒为单位
data.lyrics[].text在指定时间戳显示的歌词文本
data.waveform用于音频可视化的波形数据数组
data.duration音频曲目的总时长，以秒为单位
client.jobs.recordInfo查询翻唱生成任务状态并获取结果
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("<taskId>");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "success",
6 "resultJson": {
7 "data": {
8 "lyrics": [
9 {
10 "text": "Verse 1 starts here",
11 "timestamp": 0
12 },
13 {
14 "text": "With lyrics synchronized",
15 "timestamp": 3.5
16 },
17 {
18 "text": "To the audio playback",
19 "timestamp": 7.2
20 }
21 ],
22 "duration": 180.5,
23 "waveform": [
24 0.1,
25 0.3,
26 0.5,
27 0.8,
28 0.6,
29 0.4,
30 0.2
31 ]
32 }
33 }
34 }
35}data.state当前状态：queuing、generating、success 或 fail
data.resultJson.data生成的翻唱版本数组，包含 URL 和元数据
API 页面显示参数架构，但 Suno 还有几个特定于业务的模式组合和回调规则，容易被忽略。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取带时间戳的歌词，以便在音频播放期间同步显示
该 API 接受具有以下结构的 JSON 请求体：
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}model必填string用于获取带时间戳歌词的模型名称
"suno/timestamped-lyrics"
channel可选string你可以通过 channel 参数指定 APIPASS 内的对应提供商；这些提供商负责实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以在最低成本和可靠性能之间取得平衡。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象根据表单配置包含以下参数：
input.taskId必填string由之前的 suno/generate 或 suno/extend createTask 调用返回的 ApiPass taskId。不要传入上游 NextMusic 提供商的任务 ID。
必填字段，最大长度：100 个字符
"task_12345678"
input.audioId必填string已完成源任务结果项中的音频 ID。
必填字段，最大长度：100 个字符
"audio_abc123xyz"
1curl -X POST "https://api.apipass.dev/api/v1/generate/get-timestamped-lyrics" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/timestamped-lyrics",
6 "input": {
7 "taskId": "task_xxx",
8 "audioId": "audio_xxx"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.lyrics歌词对象数组，每个对象包含时间戳（以秒为单位）和文本
data.lyrics[].timestamp该行歌词应显示的时间戳值，以秒为单位
data.lyrics[].text在指定时间戳显示的歌词文本
data.waveform用于音频可视化的波形数据数组
data.duration音频曲目的总时长，以秒为单位
