Suno · Music

Upload Audio

📌 What is this：Upload external audio and get back a clip ID for other features.

💡 When to use：Use to get an ID before extending/covering/mashing your own audio.

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
audioUrl	string	Required	Downloadable audio URL

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", "audioUrl":"https://cdn1.suno.ai/ef8bd9f0-faf2-4e39-a922-ec3f85898ac3.mp3" }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "8da0bc5e2f4c48eb86954a1f763470cd",
    "taskType": "upload",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "upload",
      "audioUrl": "https://cdn1.suno.ai/ef8bd9f0-faf2-4e39-a922-ec3f85898ac3.mp3"
    },
    "result": {
      "id": "217c547a-3aee-48db-9490-e4182566fe91",
      "title": "ef8bd9f0-faf2-4e39-a922-ec3f85898ac3",
      "handle": "pauliboldenwtan5",
      "status": "complete",
      "user_id": "4bc5457b-4c0a-4ceb-9fbb-0ecdf73dab80",
      "metadata": {
        "tags": "C-Pop, Mandopop. Bright, energetic male vocals … （系统自动分析的风格描述已省略）",
        "type": "upload",
        "prompt": "[Intro] Hey! Hey! Hey! … （自动转写的歌词已省略）",
        "duration": 166.68,
        "is_remix": false,
        "has_vocal": true,
        "uses_latest_model": false,
        "can_publish_with_vocal": true
      },
      "audio_url": "https://cdn1.suno.ai/217c547a-3aee-48db-9490-e4182566fe91.mp3",
      "image_url": "https://cdn2.suno.ai/image_217c547a-3aee-48db-9490-e4182566fe91.jpeg",
      "image_large_url": "https://cdn2.suno.ai/image_large_217c547a-3aee-48db-9490-e4182566fe91.jpeg",
      "video_url": "",
      "media_urls": [
        { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/217c547a-3aee-48db-9490-e4182566fe91.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
        { "url": "https://cdn1.suno.ai/217c547a-3aee-48db-9490-e4182566fe91.mp3", "delivery": "progressive", "content_type": "mp3" }
      ],
      "model_name": "chirp-chirp",
      "batch_index": 0,
      "created_at": "2026-07-08T03:42:17.754Z",
      "display_tags": "C-Pop, Mandopop, upbeat male vocals",
      "major_model_version": ""
    },
    "completeTime": 1783482148259
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit)
data.taskType	string	Task type; always "upload"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the audioUrl you submitted
data.result	object	⚠ A single clip object (not an array, not {clip}) — the ingested audio clip
data.result.id	string	🔑 The ingested clipId — use it for upload_extend / upload_cover / mashup
data.result.title	string	Title (defaults to the file name)
data.result.audio_url	string	Platform-hosted audio URL (mp3)
data.result.image_url	string	Auto-generated cover (image_large_url is large)
data.result.status	string	Clip status; "complete" = ready
data.result.metadata.type	string	Always "upload"
data.result.metadata.tags	string	Auto-analyzed style description of your audio
data.result.metadata.prompt	string	Auto-transcribed lyrics
data.result.metadata.duration / has_vocal	mixed	Duration (seconds) / whether it has vocals
data.result.display_tags	string	Concise style tags
data.result.media_urls	array	Multi-format audio URLs (m4a-opus / mp3)
data.completeTime	number	⚠ Completion time is an epoch-ms number; upload has no createTime field

Billing & Credits

4 credits (free when chained in another task) (x your user rate). Auto-refunded on failure.