upload and cover music

POST

https://api.musicapi.ai/api/v1/sonic/upload-cover

One-stop API to upload an audio file and create a cover version. This combines the upload and cover operations into a single request.

Credits cost: 15

Workflow:

Upload the audio file to get a clip_id

Create a cover of the uploaded clip with the specified parameters

Poll the result using get-music endpoint with the returned task_id

Polling Result

Use GET /api/v1/sonic/task/{task_id} to poll the result.

Standard Response (auto_concat: false)

{
  "code": 200,
  "data": [
    {
      "clip_id": "cover-clip-1",
      "state": "succeeded",
      "title": "My Cover",
      "audio_url": "https://cdn1.suno.ai/cover-clip-1.mp3",
      "duration": 60
    }
  ],
  "message": "success"
}

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Example

{
    "url": "https://cdn1.suno.ai/5b36a0b8-f96d-496b-aea4-f5cb01d11ba2.mp3",
    "mv": "sonic-v4-5",
    "custom_mode": true,
    "prompt": "[Verse]\nNew lyrics for the cover\nA different melody\n\n[Chorus]\nCover song cover song\nSing along with me",
    "title": "My Cover Version",
    "tags": "pop,acoustic"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.musicapi.ai/api/v1/sonic/upload-cover' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://cdn1.suno.ai/5b36a0b8-f96d-496b-aea4-f5cb01d11ba2.mp3",
    "mv": "sonic-v4-5",
    "custom_mode": true,
    "prompt": "[Verse]\nNew lyrics for the cover\nA different melody\n\n[Chorus]\nCover song cover song\nSing along with me",
    "title": "My Cover Version",
    "tags": "pop,acoustic"
}'

Responses

🟢200success

application/json

Success

Body

Example

{
    "code": 200,
    "message": "success",
    "task_id": "92fd8e71-67bf-59d2-a847-44b9331edfb8",
    "steps": {
        "upload": {
            "success": true,
            "clip_id": "dfcd4e4d-3bee-5376-cdef-035103107f4e"
        },
        "cover": {
            "success": true,
            "task_id": "92fd8e71-67bf-59d2-a847-44b9331edfb8"
        }
    }
}

Modified at 2026-01-16 05:41:01

upload and extend music

create persona