Add Instrumental (Add Instrumental to A Cappella)

POST

/suno/submit/music

Add Instrumental feature released by suno in August 2025
Upload an a cappella song without accompaniment and let suno add instrumental music for you

Please perform this operation as soon as possible after uploading the audio, otherwise an error may occur

Steps to use:

Upload material: https://302ai-en.apifox.cn/370442529e0

Use the ID obtained from the upload to query: https://302ai-en.apifox.cn/207705225e0
Get clip_id, duration, and tags from result's data

Use the clip_id, tags, and duration obtained from the query to request this API and get the task id

Use the obtained id to query and get the final result: https://302ai-en.apifox.cn/207705225e0

Price: 0.1PTC/time

Request

Header Params

Body Params application/json

Example

{
  "mv": "chirp-bluejay",
  "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi Insterumental",
  "underpainting_clip_id": "a844e02e-6929-942d-4325-07703c8fc4d6",
  "underpainting_start_s": 0,
  "underpainting_end_s": 116,
  "task": "underpainting",
  "prompt": "",
  "override_fields": [
    "prompt",
    "tags"
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "mv": "chirp-bluejay",
  "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
  "title": "Hi Insterumental",
  "underpainting_clip_id": "a844e02e-6929-942d-4325-07703c8fc4d6",
  "underpainting_start_s": 0,
  "underpainting_end_s": 116,
  "task": "underpainting",
  "prompt": "",
  "override_fields": [
    "prompt",
    "tags"
  ]
}'

Responses

🟢200成功

application/json

Body

Example

{
    "code": "success",
    "message": "",
    "data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}

Modified at 2025-11-03 03:08:48

Upload (Upload Material)

Add Vocals (Add Vocals to Instrumental)