CQTAI
Suno · 音乐

独立视频生成NEW

📌 这是什么：为音乐生成一段配套的视频画面。
💡 什么时候用：想给歌曲配 MV 画面时用。

接口地址

用途方法路径
提交任务POST/api/cqt/generator/suno
查询结果GET/api/cqt/info/suno?id={taskId}

请求参数

参数类型必填说明
taskstring必填固定填 videoStandaloneGenerate
promptstring必填视频画面描述
durationinteger—时长（秒），5~30，默认 5

请求示例

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>" }

响应示例

{
  "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"
  }
}

响应字段说明

字段类型说明
codenumber状态码，200 表示成功
msgstring提示信息
data.idstring任务 ID（= 提交时拿到的 taskId）
data.taskTypestring任务类型，恒为 videoStandaloneGenerate
data.statusstring任务状态：pending 处理中 / succeeded 成功 / failed 失败
data.paramobject原样回显你提交的请求参数
data.resultobject⚠ 对象 { items, batch_id }（非数组），视频在 result.items 里
data.result.batch_idstring本批次 ID（同批视频共享）
data.result.itemsarray生成的视频（通常 2 条候选）
data.result.items[].urlstring视频地址（mp4）
data.result.items[].thumbnail_urlstring封面帧图地址
data.result.items[].typestring资源类型，恒为 video
data.result.items[].durationnumber视频时长（秒，= 你传的 duration）
data.result.items[].generation_duration_secondsnumber生成耗时（秒）
data.result.items[].video_upload_idstring视频资源 ID
data.result.items[].title / gen_category / display_order / statusmixedAI 标题 / 档位(Basic·Advanced) / 展示顺序 / 状态(complete)
data.createTime / completeTimestring任务提交时间 / 完成时间

计费与积分

80 积分 × 时长（秒，5~30，默认 5）（× 你的用户费率）。任务失败自动退回。