Skip to main content
POST
/
v1
/
music
/
generations
创建音乐生成任务
curl --request POST \
  --url https://api.qhaigc.net/v1/music/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "model": "<string>",
  "custom_mode": true,
  "style": "<string>",
  "title": "<string>",
  "instrumental": true,
  "vocal_gender": "<string>"
}
'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "<string>",
    "action": "GENERATIONS",
    "status": "PENDING",
    "fail_reason": "<string>",
    "submit_time": 123,
    "start_time": 123,
    "finish_time": 123,
    "progress": "0%",
    "data": [
      {}
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.qhaigc.net/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
功能说明

通过 Suno 最新模型生成高质量的音乐。支持非自定义（根据提示词生成）和自定义模式（提供歌词、风格等）。

​
请求参数

名称类型必选说明
promptstring是音乐描述（非自定义模式）或歌词（自定义模式）
modelstring否模型型号，如 suno-v4.5-plus（默认）、suno-v5 等
custom_modeboolean否是否启用自定义模式，默认为 false
stylestring否音乐风格（自定义模式必填）
titlestring否音乐标题（自定义模式必填）
instrumentalboolean否是否生成纯音乐，默认为 false
vocal_genderstring否人声性别，"m"（男）或 "f"（女）

​
调用示例

import requests

url = "https://api.qhaigc.net/v1/music/generations"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-your-api-key-here"
}

# 非自定义模式
data = {
    "prompt": "一首关于春天的轻快 J-Pop 歌曲",
    "model": "suno-v4.5-plus",
    "custom_mode": false
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

​
返回结果

成功创建任务后返回任务对象。音乐生成需要几分钟时间，请使用返回的 task_id 轮询查询接口。 
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "750ced71bcdde0f6b7677c967722b888",
    "action": "GENERATIONS",
    "status": "PENDING",
    "fail_reason": "",
    "submit_time": 1773486571,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": []
  }
}

​
相关接口

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
prompt
string
required
​
model
string
​
custom_mode
boolean
​
style
string
​
title
string
​
instrumental
boolean
​
vocal_gender
string

Response

200 - application/json

成功响应

​
code
string
Example:

"success"

​
message
string
Example:

""

​
data
object