Light Mode

Generate Music

POST/api/suno/v1/music

This endpoint from PiAPI's Suno API utilizes either Suno's chirp-v3-0 model or the chirp-v3-5 model to produce music.

Request

Header Params

X-API-Key

string

required

Insert your API Key here

Example:

custom_mode

boolean

required

Default value: false.

string

required

Default value: chirp-v3-0.

This value is interchangeable with chirp-v3-5.

input

object

required

The structure is dependant on the input of the custom_mode, see the examples on the right.

prompt

string

required

The prompt to add lyrics into the music.

title

string

required

The title of the song.

tags

string

required

The type of music.

continue_at

integer

optional

The continuation from the last second of the previous clip. The value 0 indicates restart from the beginning.

Note: Only Creator and above plans can use other values instead of 0.

continue_clip_id

string

optional

The clip_id of the clip to continue from.

Blank input indicates a fresh new clip.

make_instrumental

string

optional

Default value: false.

gpt_description_prompt

string

optional

A plain prompt to describe the song.

{
  "custom_mode": true,
  "mv": "chirp-v3-5",
  "input": {
    "prompt": "[Verse 1]\nIn the quiet of the night,\nI still hear the echoes of your name,\nHaunted by the memories,\nNothing ever feels the same.\n\n[Pre-Chorus]\nAnd I, can't escape \nTheshadows of our fate.\n\n[Chorus]\nI'm lost without your love,\nFalling through the dark above,\nIn this void, I'm incomplete,\nWithout you, my world’s obsolete.\n\n[Verse 2]\nEvery word you said to me,\nIs a script of broken dreams,\nCarved into my fragile heart,\nNow I'm tearing at the seams.\n",
    "title": "Without your love",
    "tags": "R&B",
    "continue_at": 0,
    "continue_clip_id": ""
  }
}

Request samples

Responses

OK(200)

Bad Request(400)

Unauthorized(401)

Server Error(500)

HTTP Code: 200

Content Type : JSONapplication/json

OK - Successful response

code

integer

optional

data

object

optional

task_id

string

optional

message

string

optional

{
  "code": 200,
  "data": {
    "task_id": "aa42ac29*****************280b703d89d0"
  },
  "message": "success"
}

Modified at 15 days ago