Generate songs (inspiration, customization, continuation)

Task Query and Mode Description

After creating a task, you need to use the task ID to poll the query interface to check the task's progress and results. Below are three different creation modes:

1. Inspiration Mode

The simplest creation mode, requiring only a basic description to automatically generate a complete song.

{
    "gpt_description_prompt": "Creation description",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5"
}

Features:

Suno automatically generates lyrics.

Automatically generates a title.

Automatically generates style tags.

Simplified parameter requirements.

2. Custom Mode

A mode that allows users greater control over the creation process.

{
    "prompt": "Creation prompt",
    "title": "Song title",
    "tags": "Style1,Style2,Style3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5"
}

Features:

Allows specifying detailed creation prompts.

Customizable song title.

Customizable style tags.

Provides more precise control over the creation process.

3. Continuation Mode

A mode for extending existing songs based on the Custom Mode.

Standard Continuation

{
    "prompt": "Creation prompt",
    "title": "Song title",
    "tags": "Style1,Style2,Style3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5",
    "task_id": "Original task ID",
    "continue_at": 120.00,
    "continue_clip_id": "Original song ID"
}

Audio Upload Continuation

{
    "prompt": "Creation prompt",
    "title": "Song title",
    "tags": "Style1,Style2,Style3",
    "make_instrumental": true/false,
    "mv": "chirp-v3-5-upload",
    "task": "extend",
    "task_id": "Original task ID",
    "continue_at": 120.00,
    "continue_clip_id": "Original song ID"
}

Features:

Supports continuing creation based on an existing song.

Allows specifying the starting time point for continuation.

Supports uploading custom audio for continuation.

Maintains stylistic consistency.

Request

Header Params

Content-Type

string

required

Example:

application/json

string

required

Example:

application/json

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

Lyrics content, only used in Custom Mode

string

required

Model selection, options are chirp-v3-0 and chirp-v3-5, default is chirp-v3-0

title

string

required

Song title, only used in Custom Mode

tags

string

required

Style tags, only used in Custom Mode. Multiple tags should be separated by commas (half-width)

make_instrumental

boolean

required

Whether to generate an instrumental version. true indicates instrumental generation

task_id

string

required

Task ID, used to operate on existing tasks (e.g., continuation)

continue_at

number

required

Starting time point for continuation, as a float in seconds

continue_clip_id

string

required

ID of the song to be continued

gpt_description_prompt

string

required

Creation description prompt, only used in Inspiration Mode

notify_hook

string

required

Callback notification URL for task completion

Example


{
    "prompt": "[Verse]\nLights are flashing\nIt's so bright (ooh-yeah!)\nFeel the rhythm\nGroove all night (ooh-yeah!)\nMove your body\nFeel alive\nDance it out\nLet’s all arrive\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Verse 2]\nBass is pumping\nHands are high (hands are high!)\nMusic lifts us to the sky (to the sky!)\nKeep it going\nDon’t look back\nIn the night\nWe’re on track\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)\n\n[Bridge]\nFeel the magic\nIn your soul (soul!)\nLose control\nLet it roll (roll!)\nWhere the night will take us\nWho knows?\nBut we’ll dance till the moon blows\n\n[Chorus]\nShake it\nShake it\nFeel the beat (beat!)\nAll together\nMove your feet (feet!)\nParty now\nDon’t ever stop (stop!)\nIn this moment\nReach the top (top!)",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title": "City Lights"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

string

required

data

string

required

message

string

required

Example

{
    "code": "success",
    "data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
    "message": ""
}

Generate songs (inspiration, customization, continuation)

Task Query and Mode Description#

1. Inspiration Mode#

2. Custom Mode#

3. Continuation Mode#

Standard Continuation#

Audio Upload Continuation#

Request

Request samples

Responses

Task Query and Mode Description

1. Inspiration Mode

2. Custom Mode

3. Continuation Mode

Standard Continuation

Audio Upload Continuation