跳转到主要内容
POST
/
suno
/
audios
Suno Audios
curl --request POST \
  --url https://api.acedata.cloud/suno/audios \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lyric": "<string>",
  "model": "chirp-v4",
  "style": "<string>",
  "variation_category": "<string>",
  "title": "<string>",
  "action": "generate",
  "custom": true,
  "prompt": "A song for Christmas",
  "lyric_prompt": {},
  "audio_id": "<string>",
  "mashup_audio_ids": [
    "<string>"
  ],
  "weirdness": 123,
  "persona_id": "<string>",
  "overpainting_start": 123,
  "overpainting_end": 123,
  "samples_start": 123,
  "samples_end": 123,
  "underpainting_start": 123,
  "underpainting_end": 123,
  "continue_at": 123,
  "callback_url": "<string>",
  "instrumental": true,
  "vocal_gender": "<string>",
  "style_negative": "<string>",
  "style_influence": 123,
  "audio_weight": 123,
  "replace_section_end": 123,
  "replace_section_start": 123
}
'
{
  "data": [
    {
      "id": "1b694cae-8b5f-424f-a5bf-2f27b7697843",
      "lyric": "[Verse]\nSnowflakes falling like whispered dreams\nFrosty windows\nCocoa steam\nCandles flicker\nHearts aglow\nThe quiet hum of winter’s show\n[Chorus]\nOh the world feels soft tonight\nWrapped in stars and silver light\nChristmas whispers\nHold it tight\nSnowfall serenade\n[Verse 2]\nFootprints weaving through the white\nEvery step feels just so right\nLaughter echoes\nFires burn\nEvery corner a joy to turn\n[Prechorus]\nHolly hangs and bells will ring\nMagic hums in everything\n[Chorus]\nOh the world feels soft tonight\nWrapped in stars and silver light\nChristmas whispers\nHold it tight\nSnowfall serenade\n[Bridge]\nStockings hung with quiet care\nDreams and wishes fill the air\nA moment frozen\nTime stands still\nHearts align\nThey always will",
      "model": "chirp-v3",
      "state": "succeeded",
      "style": "uplifting, orchestral with sleigh bells and warm strings",
      "title": "Snowfall Serenade",
      "prompt": "A song for Christmas",
      "duration": 240,
      "audio_url": "https://cdn1.suno.ai/1b694cae-8b5f-424f-a5bf-2f27b7697843.mp3",
      "image_url": "https://cdn2.suno.ai/image_1b694cae-8b5f-424f-a5bf-2f27b7697843.jpeg",
      "video_url": "",
      "created_at": "2025-07-29T01:28:32.508Z"
    },
    {
      "id": "532f4ae0-48fb-4604-9c68-350897373522",
      "lyric": "[Verse]\nSnowflakes falling like whispered dreams\nFrosty windows\nCocoa steam\nCandles flicker\nHearts aglow\nThe quiet hum of winter’s show\n[Chorus]\nOh the world feels soft tonight\nWrapped in stars and silver light\nChristmas whispers\nHold it tight\nSnowfall serenade\n[Verse 2]\nFootprints weaving through the white\nEvery step feels just so right\nLaughter echoes\nFires burn\nEvery corner a joy to turn\n[Prechorus]\nHolly hangs and bells will ring\nMagic hums in everything\n[Chorus]\nOh the world feels soft tonight\nWrapped in stars and silver light\nChristmas whispers\nHold it tight\nSnowfall serenade\n[Bridge]\nStockings hung with quiet care\nDreams and wishes fill the air\nA moment frozen\nTime stands still\nHearts align\nThey always will",
      "model": "chirp-v3",
      "state": "succeeded",
      "style": "uplifting, orchestral with sleigh bells and warm strings",
      "title": "Snowfall Serenade",
      "prompt": "A song for Christmas",
      "duration": 240,
      "audio_url": "https://cdn1.suno.ai/532f4ae0-48fb-4604-9c68-350897373522.mp3",
      "image_url": "https://cdn2.suno.ai/image_532f4ae0-48fb-4604-9c68-350897373522.jpeg",
      "video_url": "",
      "created_at": "2025-07-29T01:28:32.508Z"
    }
  ],
  "success": true,
  "task_id": "6a8fe7f7-3897-43e4-ad1e-5d0792fb3dba",
  "trace_id": "2b63eb64-8244-48fa-9d67-8c46041666fe"
}

授权

​
Authorization
string
header
必填

API token from https://platform.acedata.cloud

请求头

​
accept
enum<string>

Specifies the format of the response from the server. If not specified, the default format is application/json. If application/x-ndjson is specified, the response will be in newline-delimited JSON format, streaming the response chunk by chunk

可用选项:
application/json,
application/x-ndjson

请求体

application/json
​
lyric
string

The lyric which used to generate the music audio

​
model
enum<string>

The model used to generate the music audio, default is chirp-v4

可用选项:
chirp-v5,
chirp-v4-5-plus,
chirp-v4-5,
chirp-v4,
chirp-v3-5,
chirp-v3-0
示例:

"chirp-v4"

​
style
string

The style of the music audio

​
variation_category
string

variation_category is only supported in versions v5 and above, and there are only three values: high normal subtle.

​
title
string

The title of the music audio

​
action
enum<string>

The action to generate the music audio. If generate, the audio will be generated from the prompt, if extend, the audio will be generated continued from existing audio. If concat, the audio will be generated concatenated from existing audio. If cover, The style of the music will be copied. If upload_extend, This custom music will be uploaded to the official and get an audio. If artist_consistency, The song will be written in a custom singer style.

可用选项:
generate,
extend,
upload_extend,
upload_cover,
concat,
cover,
artist_consistency,
artist_consistency_vox,
stems,
all_stems,
replace_section,
underpainting,
overpainting,
remaster,
mashup,
samples
示例:

"generate"

​
custom
boolean

The flag indicates the music audio is custom or not, if true, the audio will be generated from the lyric, otherwise, the audio will be generated from the prompt

​
prompt
string

The prompt which used to generate the music audio and the prompt must be less than or equal 200

示例:

"A song for Christmas"

​
lyric_prompt
object

The prompt which used for auto generating the lyric, only available when custom is true and the lyric is empty

​
audio_id
string

The audio id which used to generate the music audio continued from existing audio. If the action is extend or concat, the audio id is required

​
mashup_audio_ids
string[]

The audio ids which used to generate the music audio by mashup. If the action is mashup, the audio ids is required.

​
weirdness
number

Advanced parameters in the official custom mode can only be used in the custom mode.

​
persona_id
string

Generate songs based on the unique characteristics of the singer's style.

​
overpainting_start
number

The default start time for adding vocals to the uploaded music is 0.

​
overpainting_end
number

The end time for adding vocals to the uploaded song must be less than the total duration of the song.

​
samples_start
number

The default start time for adding samples to the uploaded music is 0.

​
samples_end
number

The end time for adding samples to the uploaded song must be less than the total duration of the song.

​
underpainting_start
number

The default starting time for adding accompaniment to the uploaded song is 0.

​
underpainting_end
number

The end time for adding accompaniment to the uploaded song must be less than the total duration of the song.

​
continue_at
number

The time in seconds to continue the existing audio. For example, 213.5 means continue at 3 minutes and 33.5 seconds.

​
callback_url
string

The callback URL which will be called when the music audio is generated

​
instrumental
boolean

No lyrics option, default is false, when it is true will ignore the lyric input above.

​
vocal_gender
string

The gender of the vocal, can be 'm', 'f'

​
style_negative
string

The style which user do not want to generate the music audio with

​
style_influence
number

Advanced parameters in the official custom mode can only be used in the custom mode.

​
audio_weight
number

The official advanced parameters can only be used in the task of covering audios.

​
replace_section_end
number

This value specifies the start time of the song fragment when the action is replace_section.

​
replace_section_start
number

This value specifies the start time of the song fragment when the action is replace_section.

响应

OK, the request is successful.

​
data
object

The output music items generated from the prompt

​
success
boolean

The flag indicates the request is successful or not