Suno · Music

Standalone VideoNEW

📌 What is this：Generate accompanying video footage for music.

💡 When to use：Use to add MV-style visuals to a song.

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: videoStandaloneGenerate
prompt	string	Required	Video scene description
duration	integer	—	Duration (sec), 5-30, default 5

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":"videoStandaloneGenerate", "prompt":"abstract colorful waves", "duration":5 }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "53b6a4a007284d618482322681426419",
    "taskType": "videoStandaloneGenerate",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "videoStandaloneGenerate",
      "prompt": "abstract colorful waves",
      "duration": 5
    },
    "result": {
      "items": [
        {
          "id": "ddefd17b-c501-4072-9cab-93f87fa2562b",
          "url": "https://cdn1.suno.ai/video_gen_ddefd17b-c501-4072-9cab-93f87fa2562b_processed_video.mp4",
          "type": "video",
          "title": "Vibrant Wavescape",
          "prompt": "abstract colorful waves",
          "status": "complete",
          "batch_id": "e39b3fea-549f-416d-8b5e-e57c152556c1",
          "duration": 5,
          "gen_category": "Basic",
          "display_order": 0,
          "thumbnail_url": "https://cdn1.suno.ai/video_gen_ddefd17b-..._cover_snapshot_0s_image.jpeg",
          "video_upload_id": "ddefd17b-c501-4072-9cab-93f87fa2562b",
          "generation_duration_seconds": 70
        },
        {
          "id": "306ee362-9753-4fb8-8b21-b76a09497122",
          "url": "https://cdn1.suno.ai/video_gen_306ee362-9753-4fb8-8b21-b76a09497122_processed_video.mp4",
          "type": "video",
          "title": "Vibrant Wavescape",
          "prompt": "abstract colorful waves",
          "status": "complete",
          "batch_id": "e39b3fea-549f-416d-8b5e-e57c152556c1",
          "duration": 5,
          "gen_category": "Basic",
          "display_order": 1,
          "thumbnail_url": "https://cdn1.suno.ai/video_gen_306ee362-..._cover_snapshot_0s_image.jpeg",
          "video_upload_id": "306ee362-9753-4fb8-8b21-b76a09497122",
          "generation_duration_seconds": 72
        }
      ],
      "batch_id": "e39b3fea-549f-416d-8b5e-e57c152556c1"
    },
    "createTime": "2026-07-09 10:04:59",
    "completeTime": "2026-07-09 10:06:36"
  }
}

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 "videoStandaloneGenerate"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the request params you submitted
data.result	object	⚠ An object { items, batch_id } (not an array); videos live under result.items
data.result.batch_id	string	Batch ID (shared by this batch of videos)
data.result.items	array	Generated videos (usually 2 candidates)
data.result.items[].url	string	Video URL (mp4)
data.result.items[].thumbnail_url	string	Cover-frame thumbnail URL
data.result.items[].type	string	Asset type; always "video"
data.result.items[].duration	number	Video duration (sec, = the duration you passed)
data.result.items[].generation_duration_seconds	number	Generation time taken (seconds)
data.result.items[].video_upload_id	string	Video asset ID
data.result.items[].title / gen_category / display_order / status	mixed	AI title / tier (Basic·Advanced) / display order / status (complete)
data.createTime / completeTime	string	Task submit time / completion time

Billing & Credits

80 credits x duration (sec, 5-30, default 5) (x your user rate). Auto-refunded on failure.