Suno Music Generation API

This service has implemented the integration of Suno AI, which can be used to generate music, lyrics, and other content.

API home page: Ace Data Cloud - Suno Music Generation

Get Started

With the widespread application of AI, various AI programs have gradually become popular. AI has gradually penetrated all aspects of people's work and life. The industries involved in AI are also increasing, from the initial writing, to medical education, and now to music.

Suno is a professional high-quality AI song and music creation platform. Users only need to input simple text prompts to generate songs with vocals based on genre style and lyrics. This AI music generator is developed by team members from well-known tech companies such as Meta, TikTok, and Kensho, aiming to allow everyone to create wonderful music without any musical instruments.

Suno has recently upgraded its music generation model to version V4.5+, capable of generating 9-minute songs.

However, Suno does not officially provide an API. AceDataCloud offers a set of Suno APIs that simulate the official Suno interface, making it easy and quick to generate desired music.

Application and Usage

To use the Suno Audios API, you can first visit the Suno Audios Generation API page and click the "Acquire" button to obtain the credentials needed for the request:

If you are not logged in or registered, you will be automatically redirected to the login page inviting you to register and log in. After logging in or registering, you will automatically return to the current page.

Upon the first application, there will be a free quota provided, allowing you to use the API for free.

Basic Usage

To think of some songs, you can input any text, for example, if I want to generate a song about Christmas, I can input a song for Christmas, as shown in the image:

Here we can see that we have set the Request Headers, including:

• accept: the format of the response result you want to receive, here filled in as application/json, which is JSON format.
• authorization: the key to call the API, which can be directly selected after application.

Additionally, the Request Body is set, including:

• action: the behavior of this music generation task, default is generate, mainly includes: extend, upload_extend, cover, upload_cover, replace_section, replace_section, concat, stems, all_stems.
• prompt: the prompt for Suno's official inspiration mode.
• model: the model for this music generation task, default is chirp-v3-5, mainly includes: chirp-v3, chirp-v4, chirp-v3-5, chirp-v4-5, chirp-v4-5-plus.
• lyric: the lyrics content for Suno's official custom mode.
• custom: whether to use the custom mode, default is: false.
• instrumental: the pure music option for Suno's official inspiration mode.
• title: the music title for Suno's official custom mode.
• style: the music style for Suno's official custom mode.
• style_negative: the excluded style for Suno's official custom mode.
• audio_id: the ID of the reference music.
• persona_id: the artist's song ID.
• weirdness: advanced parameter for weirdness.
• continue_at: the time in seconds to continue the existing audio. For example, 213.5 means continue to 3 minutes and 33.5 seconds.
• style_influence: advanced parameter for style influence.
• replace_section_end: the end time of the replacement section.
• replace_section_start: the start time of the replacement section.
• callback_url: the URL to receive the callback result.

The generated code is as follows:

You can click the "Try" button to directly test the API, wait for 1-2 minutes, and the result is as follows:

{
  "success": true,
  "task_id": "e72fb249-bd5b-4e2a-b20c-8a06fea5ac14",
  "trace_id": "7dbc5b6a-b2c0-4d85-9d39-fa8a8a785ccf",
  "data": [
    {
      "id": "b481b17a-bf50-4e10-8adc-4d5635050893",
      "title": "Under the Mistletoe",
      "image_url": "https://cdn2.suno.ai/image_b481b17a-bf50-4e10-8adc-4d5635050893.jpeg",
      "lyric": "[Verse]\nSnowflakes falling on the ground\nTwinkling lights all around\nThe scent of pine fills the air\nChristmas magic everywhere\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right\n[Verse 2]\nStockings hung by the fire’s glow\nWarmth inside while the cold winds blow\nCookies baking\nSweet delight\nA season of joy shining bright\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right\n[Bridge]\nCarols sung by candlelight\nStars above make the world feel tight\nPeace and love\nA season’s creed\nFilling hearts with all we need\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right",
      "audio_url": "https://cdn1.suno.ai/b481b17a-bf50-4e10-8adc-4d5635050893.mp3",
      "video_url": "",
      "created_at": "2025-06-17T15:59:32.468Z",
      "model": "chirp-auk",
      "state": "succeeded",
      "prompt": "A song for Christmas",
      "style": "holiday, cheerful, male vocals",
      "duration": 154.92
    },
    {
      "id": "fbf22dab-5e2b-4e02-84c0-6d7605f14c3d",
      "title": "Under the Mistletoe",
      "image_url": "https://cdn2.suno.ai/image_fbf22dab-5e2b-4e02-84c0-6d7605f14c3d.jpeg",
      "lyric": "[Verse]\nSnowflakes falling on the ground\nTwinkling lights all around\nThe scent of pine fills the air\nChristmas magic everywhere\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right\n[Verse 2]\nStockings hung by the fire’s glow\nWarmth inside while the cold winds blow\nCookies baking\nSweet delight\nA season of joy shining bright\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right\n[Bridge]\nCarols sung by candlelight\nStars above make the world feel tight\nPeace and love\nA season’s creed\nFilling hearts with all we need\n[Chorus]\nUnder the mistletoe tonight\nHearts aglow in the soft moonlight\nLaughter echoes\nSpirits bright\nIt’s Christmas time\nIt feels so right",
      "audio_url": "https://cdn1.suno.ai/fbf22dab-5e2b-4e02-84c0-6d7605f14c3d.mp3",
      "video_url": "",
      "created_at": "2025-06-17T15:59:32.468Z",
      "model": "chirp-auk",
      "state": "succeeded",
      "prompt": "A song for Christmas",
      "style": "holiday, cheerful, male vocals",
      "duration": 158.48
    }
  ]
}

You can see that we have obtained the content of two songs, including the title, preview image, lyrics, audio, video, and other content.

The field descriptions are as follows:

• success: Indicates whether the generation was successful; if successful, it is true, otherwise it is false.
• data: A list that contains detailed information about the generated songs.
  • state: The song generation status, mainly includes four types, as follows:
    • succeeded: Generation successful
    • pending: In queue
    • running: In progress
    • error: Failed
  • id: Song ID
  • title: Title of the song
  • image_url: Cover image of the song
  • lyric: Lyrics of the song
  • audio_url: Audio file of the song, opening it will play an mp3 audio.
  • video_url: Video file of the song, opening it will play an mp4 video.
  • created_at: Creation time
  • model: The model used, generally the latest v3 model
  • style: Style

Custom Generation

If you want to customize the generation of lyrics, you can input the lyrics:

At this time, the lyric field can accept content like the following:

[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near

Note that the \n in the lyrics is a newline character. If you don't know how to generate lyrics, you can use the lyrics generation API provided by AceDataCloud to generate lyrics through a prompt. The API is Suno Lyrics Generation API.

Next, we need to customize the generation of songs based on the lyrics, title, and style, and we can specify the following content:

• lyric: Lyrics text
• custom: Set to true, indicating custom generation; this parameter defaults to false, indicating the use of prompt generation.
• title: Title of the song.
• style: Style of the song, optional.

An example of filling out is as follows:

After filling it out, the code generated automatically is as follows:

The corresponding code:

curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "A song for Christmas",
  "model": "chirp-v4-5",
  "lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near",
  "custom": true
}'

Testing is allowed, and the generated effect is similar.

More

For more info, please check below APIs and integration documents.

API	Path	Integration Guidance
Suno Audios Generation API	/suno/audios	Suno Audios Generation API Integration Guide
Suno Persona API	/suno/persona	Suno Persona API Integration Guide
Suno MP4 API	/suno/mp4	Suno MP4 API Integration Guide
$t(document_title_suno_timing_generation_api)	/suno/timing	Suno Timing API Integration Guide
$t(document_title_suno_wav_generation_api)	/suno/wav	Suno Wav API Integration Guide
Suno Lyrics Generation API	/suno/lyrics	Suno Lyrics Generation API Integration Guide
Suno Tasks API	/suno/tasks	Suno Tasks API Integration Guide
Suno Upload API	/suno/upload	Suno Upload API Integration Guide

Base URL: https://api.acedata.cloud

Support

If you meet any issue, check our from support info.