Suno V5

Enter a keyword, automatically generate a song

Price: 0.1 PTC / call

Generate 2 songs by customizing settings such as lyrics and style of the songs.

Precautions
New users are recommended to use Automatic Mode, which allows you to quickly test APIs and experience the results.

• The generated files will be retained for 14 days and then deleted
• Ensure that all necessary parameters are provided according to the settings of make_instrumental to avoid errors
• Please note the character length limits for prompt, tags, and title to ensure successful processing
• The callback process has three stages: text (text generation completed), first (first item completed), complete (all completed)
• You can use the Fetch interface to proactively check the task status instead of waiting for a callback

Price: 0.1 PTC / call

Upload materials for later use
After uploading, you need to check the task processing progress

Price: 0.01PTC/time

Add Instrumental feature released by suno in August 2025
Upload an a cappella song without accompaniment and let suno add instrumental music for you

Please perform this operation as soon as possible after uploading the audio, otherwise an error may occur

Steps to use:

1. Upload material: https://302ai-en.apifox.cn/370442529e0
2. Use the ID obtained from the upload to query: https://302ai-en.apifox.cn/207705225e0
   Get clip_id, duration, and tags from result’s data

{
...
  "data": {
      "data":{
          // This id is clip_id
          "id":"e28eea00-0511-49eb-a7ba-bb2e1a63c6e6",
          "metadata":{
              // tags
              "tags":"This is an upbeat, pop-rock track with a driving rhythm section and prominent melodic elements. The instrumentation includes a drum kit providing a steady beat, a bass guitar laying down a....",
              // duration
              "duration":116.04
          }
      }
  }
...
}

3. Use the clip_id, tags, and duration obtained from the query to request this API and get the task id
4. Use the obtained id to query and get the final result: https://302ai-en.apifox.cn/207705225e0

Price: 0.1PTC/time

Add Vocals Feature Released by suno in August 2025
Upload an instrumental track and let suno generate lyrics and vocal singing

Execute this operation as soon as possible after uploading the audio, otherwise an error may occur

Usage Steps:

1. Upload material: https://302ai-en.apifox.cn/370442529e0
2. Query using the ID obtained from the upload: https://302ai-en.apifox.cn/207705225e0
   Retrieve clip_id, duration, and tags from result’s data

{
...
  "data": {
      "data":{
          // This id is clip_id
          "id":"e28eea00-0511-49eb-a7ba-bb2e1a63c6e6",
          "metadata":{
              // tags
              "tags":"This is an upbeat, pop-rock track with a driving rhythm section and prominent melodic elements. The instrumentation includes a drum kit providing a steady beat, a bass guitar laying down a....",
              // duration
              "duration":116.04
          }
      }
  }
...
}

3. Use the clip_id, tags, and duration obtained from the query to request this interface and get the task id
4. Use the obtained id to query and get the final result: https://302ai-en.apifox.cn/207705225e0

Price: 0.1PTC/time

Obtain the lyrics timeline, for example:

"alignment": [
                {
                    "word": "[Verse 1]我",
                    "success": true,
                    "start_s": 0.55851,
                    "end_s": 0.87766,
                    "p_align": 1
                },
                {
                    "word": "把",
                    "success": true,
                    "start_s": 0.87766,
                    "end_s": 0.95745,
                    "p_align": 1
                },
                {
                    "word": "你",
                    "success": true,
                    "start_s": 1.19681,
                    "end_s": 1.2766,
                    "p_align": 1
                },
                ...
            ]

Pass the id generated by the song generation API and fill in task_id.
After generating a new task id, use fetch to query.

Price: 0.01PTC/time

Get Wav File

Pass the id from the song generation API into task_id.
After generating a new task id, use fetch to query.

Price: 0.01PTC/time

Get Video

Pass the id from the song generation API into task_id.
After generating a new task id, use fetch to query.

Price: 0.01PTC/time

Adjust Song Speed

Pass the id from the song generation API and enter it as task_id.
After generating a new task id, use fetch to query.

Price: 0.01PTC/time

Crop Music

Pass the id from the generated song interface and fill in task_id.
After generating a new task id, use fetch to query.

Price: 0.01PTC/time