MusicAPI
HomeDocs
HomeDocs
  1. sonic
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • Webhook Integration Guide
  • sonic
    • Sonic Instructions
    • create / extend / cover music
      POST
    • upload and extend music
      POST
    • upload and cover music
      POST
    • create persona
      POST
    • sample
      POST
    • mashup
      POST
    • get BPM
      POST
    • get VOX
      POST
    • get wav
      POST
    • get midi
      POST
    • get lyrics timeline
      POST
    • upsample tags
      POST
    • concat music
      POST
    • stems basic
      POST
    • stems full
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • producer
    • Producer instructions
    • Complete Request Examples
    • create music
    • upload
    • download
    • get music
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  • Schemas
    • 记录不存在
    • 参数不正确
HomeDocs
HomeDocs
  1. sonic

get music

GET
https://api.musicapi.ai/api/v1/sonic/task/{task_id}
Use the obtained task ID to poll song data. Recommended polling interval: 15s-25s.

Supported Task Types#

Task TypeDescriptionResponse Format
create_musicStandard music creationArray of songs
extend_musicExtend existing songArray of songs
cover_musicCreate cover versionArray of songs
upload-extendUpload + ExtendArray of songs, or paired objects if auto_concat
upload-coverUpload + CoverArray of songs
concat_musicConcatenate songsArray of songs

Response Format#

Standard tasks: data is an array of song objects
Tasks with auto_concat: true: data is an array of paired objects [{extended, full}, ...]
For detailed auto_concat response examples, see:
upload-extend-music
upload-cover-music

State Values#

pending - Task queued
running - Processing
succeeded - Completed successfully
failed - Task failed

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.musicapi.ai/api/v1/sonic/task/' \
--header 'Authorization: Bearer <token>'

Responses

🟢200成功
application/json
Success
Body

Example
{
    "code": 200,
    "data": [
        {
            "clip_id": "26c9c592-0566-46cf-bb71-91ac1deaa7b5",
            "state": "succeeded",
            "title": "Starry Night",
            "tags": "pop",
            "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite",
            "image_url": "https://cdn2.suno.ai/image_26c9c592-0566-46cf-bb71-91ac1deaa7b5.jpeg",
            "audio_url": "https://cdn1.suno.ai/26c9c592-0566-46cf-bb71-91ac1deaa7b5.mp3",
            "video_url": "https://cdn1.suno.ai/26c9c592-0566-46cf-bb71-91ac1deaa7b5.mp4",
            "created_at": "2024-11-27T10:26:46.552Z",
            "mv": "sonic-v4-5",
            "gpt_description_prompt": null,
            "duration": 179
        },
        {
            "clip_id": "626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0",
            "state": "succeeded",
            "title": "Starry Night",
            "tags": "pop",
            "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite",
            "image_url": "https://cdn2.suno.ai/image_626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.jpeg",
            "audio_url": "https://cdn1.suno.ai/626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.mp3",
            "video_url": "https://cdn1.suno.ai/626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.mp4",
            "created_at": "2024-11-27T10:26:46.552Z",
            "mv": "sonic-v4-5",
            "gpt_description_prompt": null,
            "duration": 208
        }
    ],
    "message": "success"
}
Modified at 2026-01-16 04:35:52
Previous
upload music
Next
Riffusion instructions
Built with