Skip to content
中文

POST /suno/generate

Method: POSTEndpoint: /suno/generate

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

Request Parameters

Header Parameters

text
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

text
task
enum<string>
Required
  // provider-specific example normalized for English documentation
Value:
gen_stem
generation_type
enum<string>
Required
  // provider-specific example normalized for English documentation
Value:
TEXT
title
string
  // provider-specific example normalized for English documentation
Required
mv
enum<string>
Required
  // provider-specific example normalized for English documentation
Value:
chirp-auk
prompt
string
Optional
  // provider-specific example normalized for English documentation
make_instrumental
boolean
  // provider-specific example normalized for English documentation
Optional
continue_clip_id
string
Required
  // provider-specific example normalized for English documentation
continued_aligned_prompt
null
Optional
  // provider-specific example normalized for English documentation
continue_at
null
Optional
  // provider-specific example normalized for English documentation
stem_type_id
integer
Required
  // provider-specific example normalized for English documentation
stem_type_group_name
enum<string>
Required
  // provider-specific example normalized for English documentation
Value:
Two
stem_task
enum<string>
Required
  // provider-specific example normalized for English documentation
Value:
two
Example
{
"task"
:
"gen_stem"
,
"generation_type"
:
"TEXT"
,
"title"
:
"string"
,
"mv"
:
"chirp-auk"
,
"prompt"
:
"string"
,
"make_instrumental"
:
true
,
"continue_clip_id"
:
"string"
,
"continued_aligned_prompt"
:
null
,
"continue_at"
:
null
,
"stem_type_id"
:
0
,
"stem_type_group_name"
:
"Two"
,
"stem_task"
:
"two"
}

Example Request

Shell

bash
curl --location --request POST '/suno/generate' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task": "gen_stem",
    "generation_type": "TEXT",
    "title": "string",
    "mv": "chirp-auk",
    "prompt": "string",
    "make_instrumental": true,
    "continue_clip_id": "string",
    "continued_aligned_prompt": null,
    "continue_at": null,
    "stem_type_id": 0,
    "stem_type_group_name": "Two",
    "stem_task": "two"
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

text
object

Example

json
{}