Music（Automatic Mode）

POST

/suno/submit/music

Enter a keyword, automatically generate a song

Price: 0.1 PTC / call

Request

Header Params

Authorization

string

optional

API Key from 302.AI backend

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

string

optional

Example:

application/json

Body Params application/json

gpt_description_prompt

string

required

Songwriting inspiration

string

required

The ID of the model to use. chirp-v3-0 or chirp-v3-5; default chirp-v3-0

make_instrumental

boolean

required

Whether to create instrumental music

Example

{
    "gpt_description_prompt": "古诗词",
    "mv": "chirp-v3-5",
    "make_instrumental": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/suno/submit/music' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gpt_description_prompt": "古诗词",
    "mv": "chirp-v3-5",
    "make_instrumental": false
}'

Responses

🟢200Success

application/json

Body

code

string

required

message

string

required

data

string

required

Example

{
    "code": "success",
    "message": "",
    "data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}

Modified at 2025-03-14 11:07:05

Voice-List

Music（Custom Mode）