Suno · Music

Cover Uploaded Audio

📌 What is this：Re-perform your uploaded audio in a new style.

💡 When to use：Use to restyle your own recording.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/suno
Query Result	GET	/api/cqt/info/suno?id={taskId}

Request Parameters

Param	Type	Required	Description
task	string	Required	Fixed value: upload_cover
model	string	Required	Model version
audioUrl	string	Required	Downloadable URL of your uploaded audio
customMode	bool	—	Custom mode: when true, prompt is exact lyrics; when false, a style description
prompt	string	—	Style / rework description, e.g. "make it a female reggae voice"
tags	string	—	Target style tags, e.g. Hip-Hop/Rap, Happy
title	string	—	Song title
vocalGender	enum(m/f)	—	Vocal gender: m (male) / f (female)
makeInstrumental	bool	—	Instrumental only (no vocals), default false

Advanced Parameters (optional)

Param	Type	Description
styleWeight	number(0~1)	Style weight; higher sticks closer to tags
audioWeight	number(0~1)	Original-audio influence weight (for audio-based tasks)
weirdnessConstraint	number(0~1)	Creativity / weirdness; higher is bolder
personaId	string	Voice persona ID (sing with a persona)
artistClipId	string	Reference clip ID for style

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "task": "upload_cover",
    "model": "v45",
    "audioUrl": "https://cdn1.suno.ai/4f51f49d-8875-442d-9a66-81a7e66d55d6.mp3",
    "customMode": false,
    "makeInstrumental": false,
    "prompt": "变成女声，然后嗓音偏雷鬼一点",
    "tags": "Hip-Hop/Rap, Happy, Party",
    "title": "Roadtrip Sunrise10",
    "vocalGender": "f",
    "styleWeight": 0.65,
    "weirdnessConstraint": 0.65,
    "audioWeight": 0.65
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "dc348c80e5434694a2398e6aa18ca889",
    "taskType": "upload_cover",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "upload_cover",
      "model": "chirp-v45",
      "audioUrl": "https://cdn1.suno.ai/4f51f49d-8875-442d-9a66-81a7e66d55d6.mp3",
      "customMode": false,
      "makeInstrumental": false,
      "prompt": "变成女声，然后嗓音偏雷鬼一点",
      "tags": "Hip-Hop/Rap, Happy, Party",
      "title": "Roadtrip Sunrise10",
      "vocalGender": "f",
      "styleWeight": 0.65,
      "weirdnessConstraint": 0.65,
      "audioWeight": 0.65
    },
    "result": [
      {
        "id": "313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e",
        "title": "Roadtrip Sunrise10",
        "handle": "pandorareyeouykr",
        "status": "complete",
        "user_id": "53cbfaed-0921-4591-aa8a-060576a5b683",
        "metadata": {
          "tags": "Hip-Hop/Rap, Happy, Party",
          "task": "cover",
          "type": "gen",
          "prompt": "[Verse 1] 我把窗户开一半 风吹进来带点盐 …（完整歌词已省略）",
          "duration": 126.16,
          "is_remix": true,
          "has_vocal": true,
          "cover_clip_id": "60c9a3a0-8a6b-4c5c-9c33-995d429bd949",
          "edited_clip_id": "60c9a3a0-8a6b-4c5c-9c33-995d429bd949",
          "control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
          "make_instrumental": false,
          "uses_latest_model": false,
          "can_publish_with_vocal": true,
          "gpt_description_prompt": "变成女声，然后嗓音偏雷鬼一点"
        },
        "audio_url": "https://cdn1.suno.ai/313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e.mp3",
        "image_url": "https://cdn2.suno.ai/image_313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e.jpeg",
        "video_url": "",
        "clip_roots": {
          "clips": [
            {
              "id": "60c9a3a0-8a6b-4c5c-9c33-995d429bd949",
              "title": "4f51f49d-8875-442d-9a66-81a7e66d55d6",
              "image_url": "https://cdn2.suno.ai/image_60c9a3a0-8a6b-4c5c-9c33-995d429bd949.jpeg",
              "user_handle": "pandorareyeouykr",
              "user_display_name": "pandorareyeouykr"
            }
          ],
          "clip_attribution_type": "remix"
        },
        "media_urls": [
          { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
          { "url": "https://cdn1.suno.ai/313d5bf2-f1e8-44c4-b9bc-c39e6ac7f14e.mp3", "delivery": "progressive", "content_type": "mp3" }
        ],
        "model_name": "chirp-auk",
        "batch_index": 0,
        "created_at": "2026-07-08T07:10:41.541Z",
        "major_model_version": "v4.5"
      },
      {
        "id": "1711a211-b101-495f-b827-4201b080da15",
        "title": "Roadtrip Sunrise10",
        "status": "complete",
        "metadata": {
          "key": "E_major",
          "task": "cover",
          "tags": "Hip-Hop/Rap, Happy, Party",
          "duration": 130.96,
          "avg_bpm": 140.09,
          "is_remix": true,
          "has_vocal": true,
          "cover_clip_id": "60c9a3a0-8a6b-4c5c-9c33-995d429bd949",
          "gpt_description_prompt": "变成女声，然后嗓音偏雷鬼一点"
        },
        "audio_url": "https://cdn1.suno.ai/1711a211-b101-495f-b827-4201b080da15.mp3",
        "image_url": "https://cdn2.suno.ai/image_1711a211-b101-495f-b827-4201b080da15.jpeg",
        "batch_index": 1,
        "major_model_version": "v4.5"
      }
    ],
    "createTime": "2026-07-08 15:10:08",
    "completeTime": "2026-07-08 15:11:44"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit; used to poll)
data.taskType	string	Task type; matches the submitted task
data.status	string	Status: pending / succeeded / failed
data.errorMsg	string	Failure reason; empty on success
data.param	object	Echo of the request params you submitted
data.result	array	Results; returns 2 candidate clips
data.result[].id	string	The generated clipId; reusable for further extend / cover, etc.
data.result[].audio_url	string	Audio file URL (mp3)
data.result[].video_url	string	Video file URL (mp4); may be empty, re-query later
data.result[].image_url	string	Cover image URL (image_large_url is the large one)
data.result[].title	string	Song title
data.result[].status	string	Clip status; "complete" = ready to download
data.result[].metadata.duration	number	Total audio duration (seconds)
data.result[].metadata.tags	string	Style tags
data.result[].metadata.task	string	For upload_cover, the clip metadata.task shows "cover"
data.result[].metadata.key	string	Musical key, e.g. E_major
data.result[].metadata.avg_bpm	number	Average tempo in BPM (also max_bpm/min_bpm)
data.result[].metadata.has_vocal	bool	Whether it contains vocals
data.result[].metadata.cover_clip_id	string	Source clip ID being covered (clipId after your upload is ingested)
data.result[].metadata.gpt_description_prompt	string	Your style description (echo of prompt)
data.result[].metadata.is_remix	bool	Whether it is a remix; always true for upload_cover
data.result[].clip_roots	object	Source (parent) clip info: title / cover / author
data.result[].media_urls	array	Multi-format audio URLs (m4a-opus / mp3)
data.result[].batch_index	number	Candidate index (0, 1)
data.result[].major_model_version	string	Model version used, e.g. v4.5 / v5.5
data.createTime / completeTime	string	Task submit time / completion time
其它字段	—	action_config / model_badges / secondary_badges / ownership / avatar_image_url, etc. are for Suno UI and can be ignored

Billing & Credits

30 credits (x your user rate). Auto-refunded on failure.