Suno Audios - Ace Data Cloud

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-v6",
  "max_mode": false,
  "style": "<string>",
  "title": "<string>",
  "action": "generate",
  "custom": false,
  "prompt": "A song for Christmas",
  "lyric_prompt": "<string>",
  "audio_id": "<string>",
  "audio_format": "mp3",
  "sound": "<string>",
  "bpm": 150,
  "key": "<string>",
  "speed_multiplier": 2.125,
  "keep_pitch": false,
  "mashup_audio_ids": [
    "<string>"
  ],
  "audio_urls": [
    "https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2"
  ],
  "weirdness": 0.5,
  "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>",
  "async": true,
  "instrumental": true,
  "negative_tags": "<string>",
  "style_influence": 0.5,
  "audio_weight": 0.5,
  "duration": 185,
  "replace_section_end": 123,
  "replace_section_result_mode": "full_song",
  "replace_section_start": 123
}
'

import requests

url = "https://api.acedata.cloud/suno/audios"

payload = {
    "lyric": "<string>",
    "model": "chirp-v6",
    "max_mode": False,
    "style": "<string>",
    "title": "<string>",
    "action": "generate",
    "custom": False,
    "prompt": "A song for Christmas",
    "lyric_prompt": "<string>",
    "audio_id": "<string>",
    "audio_format": "mp3",
    "sound": "<string>",
    "bpm": 150,
    "key": "<string>",
    "speed_multiplier": 2.125,
    "keep_pitch": False,
    "mashup_audio_ids": ["<string>"],
    "audio_urls": ["https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2"],
    "weirdness": 0.5,
    "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>",
    "async": True,
    "instrumental": True,
    "negative_tags": "<string>",
    "style_influence": 0.5,
    "audio_weight": 0.5,
    "duration": 185,
    "replace_section_end": 123,
    "replace_section_result_mode": "full_song",
    "replace_section_start": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    lyric: '<string>',
    model: 'chirp-v6',
    max_mode: false,
    style: '<string>',
    title: '<string>',
    action: 'generate',
    custom: false,
    prompt: 'A song for Christmas',
    lyric_prompt: '<string>',
    audio_id: '<string>',
    audio_format: 'mp3',
    sound: '<string>',
    bpm: 150,
    key: '<string>',
    speed_multiplier: 2.125,
    keep_pitch: false,
    mashup_audio_ids: ['<string>'],
    audio_urls: ['https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2'],
    weirdness: 0.5,
    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>',
    async: true,
    instrumental: true,
    negative_tags: '<string>',
    style_influence: 0.5,
    audio_weight: 0.5,
    duration: 185,
    replace_section_end: 123,
    replace_section_result_mode: 'full_song',
    replace_section_start: 123
  })
};

fetch('https://api.acedata.cloud/suno/audios', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "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"
}

{
  "error": {
    "code": "token_mismatched",
    "message": "The specified token is not matched with API."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "no_api",
    "message": "API does not exist, please make sure url is correct."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "too_many_requests",
    "message": "You have exceeded the rate limit."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "api_error",
    "message": "Internal server error."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "timeout",
    "message": "timeout while waiting for audio generation"
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

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-v6",
  "max_mode": false,
  "style": "<string>",
  "title": "<string>",
  "action": "generate",
  "custom": false,
  "prompt": "A song for Christmas",
  "lyric_prompt": "<string>",
  "audio_id": "<string>",
  "audio_format": "mp3",
  "sound": "<string>",
  "bpm": 150,
  "key": "<string>",
  "speed_multiplier": 2.125,
  "keep_pitch": false,
  "mashup_audio_ids": [
    "<string>"
  ],
  "audio_urls": [
    "https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2"
  ],
  "weirdness": 0.5,
  "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>",
  "async": true,
  "instrumental": true,
  "negative_tags": "<string>",
  "style_influence": 0.5,
  "audio_weight": 0.5,
  "duration": 185,
  "replace_section_end": 123,
  "replace_section_result_mode": "full_song",
  "replace_section_start": 123
}
'

import requests

url = "https://api.acedata.cloud/suno/audios"

payload = {
    "lyric": "<string>",
    "model": "chirp-v6",
    "max_mode": False,
    "style": "<string>",
    "title": "<string>",
    "action": "generate",
    "custom": False,
    "prompt": "A song for Christmas",
    "lyric_prompt": "<string>",
    "audio_id": "<string>",
    "audio_format": "mp3",
    "sound": "<string>",
    "bpm": 150,
    "key": "<string>",
    "speed_multiplier": 2.125,
    "keep_pitch": False,
    "mashup_audio_ids": ["<string>"],
    "audio_urls": ["https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2"],
    "weirdness": 0.5,
    "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>",
    "async": True,
    "instrumental": True,
    "negative_tags": "<string>",
    "style_influence": 0.5,
    "audio_weight": 0.5,
    "duration": 185,
    "replace_section_end": 123,
    "replace_section_result_mode": "full_song",
    "replace_section_start": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    lyric: '<string>',
    model: 'chirp-v6',
    max_mode: false,
    style: '<string>',
    title: '<string>',
    action: 'generate',
    custom: false,
    prompt: 'A song for Christmas',
    lyric_prompt: '<string>',
    audio_id: '<string>',
    audio_format: 'mp3',
    sound: '<string>',
    bpm: 150,
    key: '<string>',
    speed_multiplier: 2.125,
    keep_pitch: false,
    mashup_audio_ids: ['<string>'],
    audio_urls: ['https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2'],
    weirdness: 0.5,
    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>',
    async: true,
    instrumental: true,
    negative_tags: '<string>',
    style_influence: 0.5,
    audio_weight: 0.5,
    duration: 185,
    replace_section_end: 123,
    replace_section_result_mode: 'full_song',
    replace_section_start: 123
  })
};

fetch('https://api.acedata.cloud/suno/audios', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "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"
}

{
  "error": {
    "code": "token_mismatched",
    "message": "The specified token is not matched with API."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "no_api",
    "message": "API does not exist, please make sure url is correct."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "too_many_requests",
    "message": "You have exceeded the rate limit."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "api_error",
    "message": "Internal server error."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "timeout",
    "message": "timeout while waiting for audio generation"
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

承認

Authorization

string

header

必須

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

ヘッダー

enum<string>

Suno Audios Param Accept

利用可能なオプション:

application/json,

application/x-ndjson

ボディ

application/json

lyric

string

Suno Audios Lyric

model

enum<string>

Suno Audios Model

利用可能なオプション:

chirp-v6,

chirp-v6-wild,

chirp-v6-mini,

chirp-v5-5,

chirp-v5,

chirp-v4-5-plus,

chirp-v4-5,

chirp-v4,

chirp-v3-5,

chirp-v3-0

例:

"chirp-v6"

max_mode

boolean

デフォルト:false

Suno Audios Max Mode

variety

enum<string>

Suno Audios Variety

利用可能なオプション:

off,

normal,

high,

extra,

max

style

string

Suno Audios Style

variation_category

enum<string>

Suno Audios Variation Category

利用可能なオプション:

high,

normal,

subtle

title

string

Suno Audios Title

action

enum<string>

デフォルト:generate

Suno Audios Action

利用可能なオプション:

generate,

extend,

upload_extend,

upload_cover,

concat,

cover,

artist_consistency,

artist_consistency_vox,

stems,

all_stems,

add_stem,

extract_stem,

sounds,

adjust_speed,

replace_section,

underpainting,

overpainting,

remaster,

mashup,

samples,

inspo

例:

"generate"

custom

boolean

デフォルト:false

Suno Audios Custom

prompt

string

Suno Audios Prompt

例:

"A song for Christmas"

lyric_prompt

string

Suno Audios Lyric Prompt

audio_id

string

Suno Audios Audio Id

stem_type

enum<string>

Suno Audios Stem Type

利用可能なオプション:

vocals,

backing_vocals,

drums,

bass,

guitar,

keyboard,

percussion,

strings,

synth,

fx,

brass,

woodwinds

audio_format

enum<string>

Suno Audios Audio Format

利用可能なオプション:

mp3

sound

string

Suno Audios Sound

sound_type

enum<string>

Suno Audios Sound Type

利用可能なオプション:

one-shot,

loop

bpm

integer

Suno Audios Bpm

必須範囲: 1 <= x <= 300

key

string

Suno Audios Key

speed_multiplier

number

Suno Audios Speed Multiplier

必須範囲: 0.25 <= x <= 4

keep_pitch

boolean

デフォルト:false

Suno Audios Keep Pitch

mashup_audio_ids

string[]

Suno Audios Mashup Audio Ids

audio_urls

string[]

Suno Audios Audio Urls

Required array length: 1 - 4 elements

Pattern: ^https?://

例:

[
  "https://cdn.acedata.cloud/uploads/a0bc051f-42c2-4a46-aeb4-582dcc884ad2"
]

weirdness

number

Suno Audios Weirdness

必須範囲: 0 <= x <= 1

persona_id

string

Suno Audios Persona Id

overpainting_start

number

Suno Audios Overpainting Start

overpainting_end

number

Suno Audios Overpainting End

samples_start

number

Suno Audios Samples Start

samples_end

number

Suno Audios Samples End

underpainting_start

number

Suno Audios Underpainting Start

underpainting_end

number

Suno Audios Underpainting End

continue_at

number

Suno Audios Continue At

callback_url

string

Suno Audios Callback Url

async

boolean

Suno Audios Async

instrumental

boolean

Suno Audios Instrumental

vocal_gender

enum<string>

Suno Audios Vocal Gender

利用可能なオプション:

f,

m

negative_tags

string

Suno Audios Negative Tags

style_influence

number

Suno Audios Style Influence

必須範囲: 0 <= x <= 1

audio_weight

number

Suno Audios Audio Weight

必須範囲: 0 <= x <= 1

duration

integer

Suno Audios Duration

必須範囲: 10 <= x <= 360

replace_section_end

number

Suno Audios Replace Section End

replace_section_result_mode

enum<string>

デフォルト:full_song

Suno Audios Replace Section Result Mode

利用可能なオプション:

candidates,

full_song

replace_section_start

number

Suno Audios Replace Section Start

レスポンス

Suno Audios Response 200

data

object[]

Suno Audios Response 200 Data

Show child attributes

success

boolean

Suno Audios Response 200 Success

task_id

string

Suno Audios Response 200 Task Id

trace_id

string

Suno Audios Response 200 Trace Id

stem_sets

object[]

Suno Audios Response 200 Stem Sets

Show child attributes