Generate music - MaxAPI Docs

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Content-Type

string

optional

Example:

application/json

Body Params application/json

model

boolean

required

Model name

messages

object

required

title

string

required

Music Title

tags

string

required

Music style, separated by half width commas

prompt

string

required

Music creation prompts, including but not limited to lyrics]

continue_at

integer

optional

Non mandatory parameter, to be used when continuing to create. The meaning is to continue creating from the second.

continue_clip_id

string

optional

Non mandatory parameter, to be used when continuing to create. The meaning is, the ID of the song that needs to be continued to be created

Example

{
  "model": "suno-v3.5",
  "messages": [
    {
      "title": "The Unyielding Song of the Soul",
      "tags": ["Heartwarming", "Soulful", "Inspirational", "Indomitable"],
      "prompt": "This is a heartwarming and soul-stirring song that tells the story of a person who maintains a positive and optimistic attitude in the face of life's challenges and never gives up. The lyrics should reflect hope for the future and a love for life, with a melody that warms the heart and inspires listeners."
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.maxapi.ai/v1/chat/completions' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "suno-v3.5",
  "messages": [
    {
      "title": "The Unyielding Song of the Soul",
      "tags": ["Heartwarming", "Soulful", "Inspirational", "Indomitable"],
      "prompt": "This is a heartwarming and soul-stirring song that tells the story of a person who maintains a positive and optimistic attitude in the face of life'\''s challenges and never gives up. The lyrics should reflect hope for the future and a love for life, with a melody that warms the heart and inspires listeners."
    }
  ]
}'

Responses

🟢200成功

application/json

Body

object {0}

Example

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "user_id": "sr4UcYbwlfOmIeYprAqd6L6LJCy2",
            "song_id": "1322a5ad-c23e-47fc-9550-fb540a43c3a3",
            "status": "submitted",
            "title": "The Unyielding Song of the Soul",
            "image_large_url": null,
            "image_url": null,
            "model_name": "chirp-v3",
            "video_url": "",
            "audio_url": "",
            "meta_tags": "Heartwarming, Soulful, Inspirational, Indomitable",
            "meta_prompt": "This is a heartwarming and soul-stirring song that tells the story of a person who maintains a positive and optimistic attitude in the face of life's challenges and never gives up. The lyrics should reflect hope for the future and a love for life, with a melody that warms the heart and inspires listeners.",
            "meta_duration": null,
            "meta_error_msg": null,
            "meta_error_type": null
        },
        {
            "user_id": "sr4UcYbwlfOmIeYprAqd6L6LJCy2",
            "song_id": "e9658339-c18b-41c9-a80a-491915f7ad9f",
            "status": "submitted",
            "title": "The Unyielding Song of the Soul",
            "image_large_url": null,
            "image_url": null,
            "model_name": "chirp-v3",
            "video_url": "",
            "audio_url": "",
            "meta_tags": "Heartwarming, Soulful, Inspirational, Indomitable",
            "meta_prompt": "This is a heartwarming and soul-stirring song that tells the story of a person who maintains a positive and optimistic attitude in the face of life's challenges and never gives up. The lyrics should reflect hope for the future and a love for life, with a melody that warms the heart and inspires listeners.",
            "meta_duration": null,
            "meta_error_msg": null,
            "meta_error_type": null
        }
    ]
}