Skip to content

Overview ​

Suno API Documentation ​

Basic Information ​

API Endpoints ​

  • Default endpoints:
    https://{BASE_URL}/suno/submit/music
    https://{BASE_URL}/suno/fetch

Model Support ​

Supported Models ​

  • chirp-v3-0 (version v3.0)
  • chirp-v3-5 (version v3.5)
  • chirp-v4 (version v4.0)
  • chirp-auk (version v4.5)
  • chirp-v5 (version v5.0)

Callback Notifications ​

  • Supports notify_hook callback URL
  • Requirements:
    • Method: POST
    • Payload: task data structure

Usage Steps ​

1. Create a Suno Task ​

2. Query Task Progress ​

Data Structures ​

Task Object ​

FieldTypeExampleDescription
task_idstringf4a94d75-087b-4bb1-bd45-53ba293faf96Task ID
actionstringMUSICTask type: MUSIC (generate song), LYRICS (generate lyrics)
statusstringSUCCESSTask status: NOT_START (not started), SUBMITTED (submitted), QUEUED (queued), IN_PROGRESS (in progress), FAILURE (failed), SUCCESS (succeeded)
submitTimenumber1689231405854Submission time
startTimenumber1689231442755Start time
finishTimenumber1689231544312Finish time
failReasonstring[Invalid parameter] Invalid valueFailure reason (present when failed)
dataobject-Payload: music (array) or lyrics (single object)

Music Continuation ​

  • Pass the task_id parameter to specify the task