> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Suno Audios ## OpenAPI ````yaml /openapi/suno.json post /suno/audios openapi: 3.0.0 info: title: Suno Music Generation version: 1.0.0 description: API reference for Suno Music Generation on Ace Data Cloud. servers: - url: https://api.acedata.cloud description: Ace Data Cloud API security: - bearerAuth: [] paths: /suno/audios: post: summary: Suno Audios parameters: - in: header name: accept schema: enum: - application/json - application/x-ndjson type: string required: false description: Suno Audios Param Accept requestBody: content: application/json: schema: type: object properties: lyric: type: string description: Suno Audios Lyric model: enum: - chirp-v5-5 - chirp-v5 - chirp-v4-5-plus - chirp-v4-5 - chirp-v4 - chirp-v3-5 - chirp-v3-0 type: string example: chirp-v5-5 description: Suno Audios Model style: type: string description: Suno Audios Style variation_category: type: string description: Suno Audios Variation Category title: type: string description: Suno Audios Title action: enum: - generate - extend - upload_extend - upload_cover - concat - cover - artist_consistency - artist_consistency_vox - stems - all_stems - replace_section - underpainting - overpainting - remaster - mashup - samples - inspo type: string example: generate description: Suno Audios Action custom: type: boolean description: Suno Audios Custom prompt: type: object example: A song for Christmas description: Suno Audios Prompt lyric_prompt: type: object description: Suno Audios Lyric Prompt audio_id: type: string description: Suno Audios Audio Id mashup_audio_ids: type: array items: type: string description: Suno Audios Mashup Audio Ids audio_urls: type: array items: type: string example: - >- https://cdn1.suno.ai/b481b17a-bf50-4e10-8adc-4d5635050893.mp3 description: Suno Audios Audio Urls weirdness: type: number minimum: 0 maximum: 1 description: Suno Audios Weirdness persona_id: type: string description: Suno Audios Persona Id overpainting_start: type: number description: Suno Audios Overpainting Start overpainting_end: type: number description: Suno Audios Overpainting End samples_start: type: number description: Suno Audios Samples Start samples_end: type: number description: Suno Audios Samples End underpainting_start: type: number description: Suno Audios Underpainting Start underpainting_end: type: number description: Suno Audios Underpainting End continue_at: type: number description: Suno Audios Continue At callback_url: type: string description: Suno Audios Callback Url async: type: boolean description: Suno Audios Async instrumental: type: boolean description: Suno Audios Instrumental vocal_gender: type: string description: Suno Audios Vocal Gender style_negative: type: string description: Suno Audios Style Negative style_influence: type: number minimum: 0 maximum: 1 description: Suno Audios Style Influence audio_weight: type: number minimum: 0 maximum: 1 description: Suno Audios Audio Weight replace_section_end: type: number description: Suno Audios Replace Section End replace_section_start: type: number description: Suno Audios Replace Section Start required: true responses: '200': content: application/json: schema: type: object example: data: - id: 1b694cae-8b5f-424f-a5bf-2f27b7697843 lyric: |- [Verse] Snowflakes falling like whispered dreams Frosty windows Cocoa steam Candles flicker Hearts aglow The quiet hum of winter’s show [Chorus] Oh the world feels soft tonight Wrapped in stars and silver light Christmas whispers Hold it tight Snowfall serenade [Verse 2] Footprints weaving through the white Every step feels just so right Laughter echoes Fires burn Every corner a joy to turn [Prechorus] Holly hangs and bells will ring Magic hums in everything [Chorus] Oh the world feels soft tonight Wrapped in stars and silver light Christmas whispers Hold it tight Snowfall serenade [Bridge] Stockings hung with quiet care Dreams and wishes fill the air A moment frozen Time stands still Hearts align They 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] Snowflakes falling like whispered dreams Frosty windows Cocoa steam Candles flicker Hearts aglow The quiet hum of winter’s show [Chorus] Oh the world feels soft tonight Wrapped in stars and silver light Christmas whispers Hold it tight Snowfall serenade [Verse 2] Footprints weaving through the white Every step feels just so right Laughter echoes Fires burn Every corner a joy to turn [Prechorus] Holly hangs and bells will ring Magic hums in everything [Chorus] Oh the world feels soft tonight Wrapped in stars and silver light Christmas whispers Hold it tight Snowfall serenade [Bridge] Stockings hung with quiet care Dreams and wishes fill the air A moment frozen Time stands still Hearts align They 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 properties: data: type: array description: Suno Audios Response 200 Data items: type: object properties: id: type: string description: Suno Audios Response 200 Data Id lyric: type: string description: Suno Audios Response 200 Data Lyric model: type: string description: Suno Audios Response 200 Data Model state: type: string description: Suno Audios Response 200 Data State style: type: string description: Suno Audios Response 200 Data Style title: type: string description: Suno Audios Response 200 Data Title prompt: type: string description: Suno Audios Response 200 Data Prompt duration: type: integer description: Suno Audios Response 200 Data Duration audio_url: type: string description: Suno Audios Response 200 Data Audio Url image_url: type: string description: Suno Audios Response 200 Data Image Url video_url: type: string description: Suno Audios Response 200 Data Video Url created_at: type: string description: Suno Audios Response 200 Data Created At success: type: boolean description: Suno Audios Response 200 Success task_id: type: string description: Suno Audios Response 200 Task Id trace_id: type: string description: Suno Audios Response 200 Trace Id description: Suno Audios Response 200 '400': content: application/json: schema: oneOf: - type: object example: error: code: token_mismatched message: The specified token is not matched with API. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Suno Audios Response 400 Error Code message: type: string example: The specified token is not matched with API. description: Suno Audios Response 400 Error Message trace_id: type: string description: Suno Audios Response 400 Trace Id - type: object example: error: code: api_not_implemented message: The API is not implemented. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_not_implemented description: Suno Audios Response 400 Error Code 2 message: type: string example: The API is not implemented. description: Suno Audios Response 400 Error Message 2 trace_id: type: string description: Suno Audios Response 400 Trace Id 2 - type: object example: error: code: disabled message: >- Your application has been disabled by Ace Data Cloud due to abnormal usage behavior, please contact our support to get more information. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: disabled description: Suno Audios Response 400 Error Code 3 message: type: string example: >- Your application has been disabled by Ace Data Cloud due to abnormal usage behavior, please contact our support to get more information. description: Suno Audios Response 400 Error Message 3 trace_id: type: string description: Suno Audios Response 400 Trace Id 3 - type: object example: error: code: bad_request message: model is invalid. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: bad_request description: Suno Audios Response 400 Error Code 4 message: type: string example: model is invalid. description: Suno Audios Response 400 Error Message 4 trace_id: type: string description: Suno Audios Response 400 Trace Id 4 - type: object example: error: code: no_token message: No token specified for the request. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: no_token description: Suno Audios Response 400 Error Code 5 message: type: string example: No token specified for the request. description: Suno Audios Response 400 Error Message 5 trace_id: type: string description: Suno Audios Response 400 Trace Id 5 description: Suno Audios Response 400 '401': content: application/json: schema: oneOf: - type: object example: error: code: invalid_token message: The specified token is invalid or wrong. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: invalid_token description: Suno Audios Response 401 Error Code message: type: string example: The specified token is invalid or wrong. description: Suno Audios Response 401 Error Message trace_id: type: string description: Suno Audios Response 401 Trace Id - type: object example: error: code: token_expired message: token expired. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_expired description: Suno Audios Response 401 Error Code 2 message: type: string example: token expired. description: Suno Audios Response 401 Error Message 2 trace_id: type: string description: Suno Audios Response 401 Trace Id 2 - type: object example: error: code: token_mismatched message: token and api does not match. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Suno Audios Response 401 Error Code 3 message: type: string example: token and api does not match. description: Suno Audios Response 401 Error Message 3 trace_id: type: string description: Suno Audios Response 401 Trace Id 3 description: Suno Audios Response 401 '403': content: application/json: schema: oneOf: - type: object example: 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 properties: error: type: object properties: code: type: string example: used_up description: Suno Audios Response 403 Error Code message: type: string example: >- Your balance is not sufficient for current request, please buy more in Ace Data Cloud. description: Suno Audios Response 403 Error Message trace_id: type: string description: Suno Audios Response 403 Trace Id description: Suno Audios Response 403 '404': content: application/json: schema: oneOf: - type: object example: error: code: no_api message: API does not exist, please make sure url is correct. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: no_api description: Suno Audios Response 404 Error Code message: type: string example: >- API does not exist, please make sure url is correct. description: Suno Audios Response 404 Error Message trace_id: type: string description: Suno Audios Response 404 Trace Id description: Suno Audios Response 404 '429': content: application/json: schema: oneOf: - type: object example: error: code: too_many_requests message: You have exceeded the rate limit. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: too_many_requests description: Suno Audios Response 429 Error Code message: type: string example: You have exceeded the rate limit. description: Suno Audios Response 429 Error Message trace_id: type: string description: Suno Audios Response 429 Trace Id description: Suno Audios Response 429 '500': content: application/json: schema: oneOf: - type: object example: error: code: api_error message: Internal server error. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_error description: Suno Audios Response 500 Error Code message: type: string example: Internal server error. description: Suno Audios Response 500 Error Message trace_id: type: string description: Suno Audios Response 500 Trace Id - type: object example: error: code: busy message: >- api was throttled from upstream and is currently busy, please try again later. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: busy description: Suno Audios Response 500 Error Code 2 message: type: string example: >- api was throttled from upstream and is currently busy, please try again later. description: Suno Audios Response 500 Error Message 2 trace_id: type: string description: Suno Audios Response 500 Trace Id 2 description: Suno Audios Response 500 '504': content: application/json: schema: oneOf: - type: object example: error: code: timeout message: timeout while waiting for audio generation trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: timeout description: Suno Audios Response 504 Error Code message: type: string example: timeout while waiting for audio generation description: Suno Audios Response 504 Error Message trace_id: type: string description: Suno Audios Response 504 Trace Id description: Suno Audios Response 504 security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: API token from https://platform.acedata.cloud ````