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

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:
1.
Upload the audio file to get a clip_id
2.
Create a cover of the uploaded clip with the specified parameters
3.
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: ********************
or
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
upload and extend music
Next
create persona
Built with