Suno · Music

Generate Sound Effect

📌 What is this：Generate a sound effect (not a song), e.g. thunder or footsteps.

💡 When to use：Use for ambient or effect sounds in videos/games.

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: sound
model	string	Required	Model version
sound	object	Required	Sound object with sub-fields description / type / key / bpm (see below)
sound.description	string	Required	Core description of the sound (also used as title)
sound.type	enum	—	one_shot (default) / loop
sound.key	enum	—	Musical key (C / C maj / C min ...)
sound.bpm	number(1~300)	—	BPM; omit for Auto

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":"sound", "model":"v55", "sound":{ "description":"thunder rumbling in the distance" } }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "044b298a1d1b45ccb9c51f0533b5dfcc",
    "taskType": "sound",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "sound",
      "model": "chirp-v55",
      "sound": { "description": "thunder rumbling in the distance" }
    },
    "result": [
      {
        "id": "955ebf61-7d6a-408f-b517-b8ebda50766f",
        "title": "thunder rumbling in the distance",
        "handle": "martibradyiymy6",
        "status": "complete",
        "user_id": "fc1ee2f4-5c7a-450d-aeb8-df8c5217c09d",
        "metadata": {
          "tags": "thunder rumbling in the distance",
          "task": "sound",
          "type": "gen",
          "prompt": "",
          "avg_bpm": 176.88,
          "max_bpm": 187.5,
          "min_bpm": 166.67,
          "duration": 7.24,
          "is_remix": false,
          "make_instrumental": true,
          "uses_latest_model": false
        },
        "audio_url": "https://cdn1.suno.ai/955ebf61-7d6a-408f-b517-b8ebda50766f.mp3",
        "image_url": "https://cdn2.suno.ai/image_955ebf61-7d6a-408f-b517-b8ebda50766f.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_955ebf61-7d6a-408f-b517-b8ebda50766f.jpeg",
        "video_url": "",
        "media_urls": [
          { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/955ebf61-7d6a-408f-b517-b8ebda50766f.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
          { "url": "https://cdn1.suno.ai/955ebf61-7d6a-408f-b517-b8ebda50766f.mp3", "delivery": "progressive", "content_type": "mp3" }
        ],
        "model_name": "chirp-sfx",
        "batch_index": 0,
        "created_at": "2026-07-09T01:42:16.057Z",
        "major_model_version": ""
      },
      {
        "id": "9ddec625-86a3-4833-bb32-3d1723980375",
        "title": "thunder rumbling in the distance",
        "status": "complete",
        "metadata": {
          "tags": "thunder rumbling in the distance",
          "task": "sound",
          "type": "gen",
          "avg_bpm": 179.1,
          "duration": 9.16,
          "is_remix": false,
          "make_instrumental": true
        },
        "audio_url": "https://cdn1.suno.ai/9ddec625-86a3-4833-bb32-3d1723980375.mp3",
        "image_url": "https://cdn2.suno.ai/image_9ddec625-86a3-4833-bb32-3d1723980375.jpeg",
        "model_name": "chirp-sfx",
        "batch_index": 1,
        "major_model_version": ""
      }
    ],
    "createTime": "2026-07-09 09:42:11",
    "completeTime": "2026-07-09 09:42:47"
  }
}

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 "sound"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the request params you submitted
data.result	array	Results; returns 2 candidate sound effects
data.result[].id	string	The sound-effect clip’s clipId
data.result[].title	string	Title (= your sound.description)
data.result[].audio_url	string	Sound-effect audio URL (mp3)
data.result[].image_url	string	Cover image URL (image_large_url is the large one)
data.result[].status	string	Clip status; "complete" = ready to download
data.result[].metadata.task	string	Underlying task; always "sound"
data.result[].metadata.tags	string	= your sound description (echoed)
data.result[].metadata.duration	number	Sound-effect duration (seconds; usually short)
data.result[].metadata.make_instrumental	bool	Sound effects have no vocals; always true
data.result[].metadata.is_remix	bool	Generated from scratch; always false
data.result[].model_name	string	Dedicated SFX engine; always "chirp-sfx"
data.result[].media_urls	array	Multi-format audio URLs (m4a-opus / mp3)
data.result[].batch_index	number	Candidate index (0, 1)
data.createTime / completeTime	string	Task submit time / completion time
其它字段	—	No clip_roots (not a remix); major_model_version empty; action_config / secondary_badges are UI-only

Billing & Credits

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