Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No output yet. Submit the form to generate content.
Explore different use cases and parameter configurations
Transparent pricing with no hidden fees. Pay as you go.
| Rule & Modality | Channel | Credits | Price (USD) | Official / Reference Price | Daily Savings |
|---|---|---|---|---|---|
Suno timestamped-lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Complete guide to using Suno
Retrieve timestamped lyrics for synchronized display during audio playback. Perfect for karaoke-style lyrics display in music player interfaces.
The Suno Timestamped Lyrics API provides synchronized lyric data for generated music tracks. Each lyric line includes precise timestamp information in seconds, enabling developers to create karaoke-style displays, lyric synchronization features, and enhanced music playback experiences. The API also returns waveform data for audio visualization, making it ideal for building comprehensive music player interfaces with both lyric display and visual audio representation.
The Suno Timestamped Lyrics API delivers lyrics with accurate timestamp values in seconds, ensuring perfect synchronization between text display and audio playback. Each lyric line is precisely timed to match the audio track.
Along with timestamped lyrics, the API returns waveform data arrays that can be used for audio visualization. This enables developers to create rich, interactive music player interfaces with visual audio representation.
The API output is optimized for karaoke-style applications. With precise timing and complete lyric text, developers can easily implement highlight-as-you-sing features and scrolling lyric displays.
Create an account and obtain your Suno Timestamped Lyrics API Key. This key authenticates all requests and links usage to your account.
First, use the Suno music generation API to create your audio track. Save the taskId and audioId from the generation response - you'll need these to retrieve timestamped lyrics.
Call the Timestamped Lyrics API with your taskId and audioId. The API will return synchronized lyric data with precise timestamps and waveform information.
Use the timestamped data to create synchronized lyric displays in your application. Combine with waveform data for enhanced visual effects.
The API requires both taskId and audioId parameters. The taskId identifies the generation session, while audioId specifies the exact track within that session.
All timestamp values are provided in seconds as floating-point numbers. This allows for precise synchronization down to millisecond accuracy when needed.
For tracks generated with instrumental=true, no lyrics data will be available. The API will still return waveform and duration information.
Integrate synchronized lyrics into music player applications, allowing users to follow along with the song in real-time with highlighted text that matches the audio playback.
Build karaoke features with precise lyric timing, enabling users to sing along with visual cues that highlight lyrics at exactly the right moment.
Create educational applications that help users learn song lyrics, understand song structure, and practice timing with accurate synchronized text display.
Enhance music sharing features on social platforms by displaying synchronized lyrics alongside audio playback, creating more engaging content experiences.
apipass.dev offers cost-effective pricing for Suno Timestamped Lyrics API access, making it accessible for projects of all sizes from individual developers to large-scale applications.
Clear, detailed API documentation with code examples and integration guides helps developers quickly implement timestamped lyrics functionality in their applications.
Round-the-clock technical support ensures your lyric synchronization features stay operational, with expert assistance available whenever you need it.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Use the SDK to create tasks, store the returned taskId, and retrieve results for Suno.
Install @apipass-dev/apipass-sdk before running these SDK examples.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkKeep your API key in server-side environment variables. The SDK sends it as a Bearer token and adds JSON headers automatically.
client.jobs.createTaskRetrieve timestamped lyrics for synchronized display during audio playback
Use this example to get started quickly with the selected 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);The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelRequiredstringThe model name to use for retrieving timestamped lyrics
"suno/timestamped-lyrics"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
The input object contains the following parameters based on the form configuration:
input.taskIdRequiredstringThe ApiPass taskId returned by a previous suno/generate or suno/extend createTask call. Do not pass the upstream NextMusic provider task ID.
Required field, max length: 100 characters
"task_12345678"
input.audioIdRequiredstringThe audio ID from the completed source task result item.
Required field, max length: 100 characters
"audio_abc123xyz"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}codeStatus code, 200 for success, others for failure
messageResponse message, error description when failed
data.lyricsArray of lyric objects, each containing timestamp (in seconds) and text
data.lyrics[].timestampTimestamp value in seconds for when this lyric line should be displayed
data.lyrics[].textThe lyric text to display at the specified timestamp
data.waveformWaveform data array for audio visualization
data.durationTotal duration of the audio track in seconds
client.jobs.recordInfoQuery cover generation task status and retrieve results
Use this example to get started quickly with the selected 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.stateCurrent state: queuing, generating, success, or fail
data.resultJson.dataArray of generated cover versions with URLs and metadata
The API page shows the parameter schema, but Suno also has several business-specific mode combinations and callback rules that are easy to miss.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Retrieve timestamped lyrics for synchronized display during audio playback
The API accepts a JSON payload with the following structure:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelRequiredstringThe model name to use for retrieving timestamped lyrics
"suno/timestamped-lyrics"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
The input object contains the following parameters based on the form configuration:
input.taskIdRequiredstringThe ApiPass taskId returned by a previous suno/generate or suno/extend createTask call. Do not pass the upstream NextMusic provider task ID.
Required field, max length: 100 characters
"task_12345678"
input.audioIdRequiredstringThe audio ID from the completed source task result item.
Required field, max length: 100 characters
"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}codeStatus code, 200 for success, others for failure
messageResponse message, error description when failed
data.lyricsArray of lyric objects, each containing timestamp (in seconds) and text
data.lyrics[].timestampTimestamp value in seconds for when this lyric line should be displayed
data.lyrics[].textThe lyric text to display at the specified timestamp
data.waveformWaveform data array for audio visualization
data.durationTotal duration of the audio track in seconds
MiniMax
MiniMax
MiniMax Music 1.5 AI music generation model, supports lyrics and style prompt to generate music
Starting from
0 credits
Starting from
0 credits