生成音乐

POST 
/api/cqt/generator/suno

使用指南

• 此接口根据您的文本提示创建音乐
• 每个请求会生成多个变体
• 您可以通过自定义模式和纯音乐设置来控制细节级别

参数说明（task 为 create）

• 模型（model）：
  • v40, v45, v45+, v45-lite, v50
• 自定义模式下（customMode: true）:
  • makeInstrumental: true：需提供 style 和 title
  • makeInstrumental: false：需提供 style、prompt 和 title
  • 不同模型的字符限制：
    • V3_5 和 V4：prompt 3000字符，style 200字符
    • V4_5 和 V4_5PLUS：prompt 5000字符，style 1000字符
    • V50：prompt 5000字符，style 1000字符
  • title 长度限制：80字符（所有模型）
• 非自定义模式下（customMode: false）:
  • 无论 makeInstrumental 设置如何，仅需提供 prompt
  • prompt 长度限制：400字符
  • 其他参数应留空

开发者注意事项

• 新用户建议：以 custom_mode: false 开始使用，更简单
• 回调过程分三个阶段：text（文本生成）、first（第一首完成）、complete（全部完成）

可选参数

• vocalGender（string）: 人声性别偏好。m 男声，f 女声。
• styleWeight（number）: 对风格的遵循强度。范围 0–1，保留两位小数。示例：0.65。
• weirdnessConstraint（number）: 创意/离散程度。范围 0–1，保留两位小数。示例：0.65。
• audioWeight（number）: 音频要素权重。范围 0–1，保留两位小数。示例：0.65。

Authorizations

获取 API Key:访问 API Key 管理页面 获取您的 API Key 使用方式: 在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意事项：

请妥善保管您的 API Key，不要泄露给他人 如果怀疑 API Key 泄露，请立即在管理页面重置

Request

Responses

200

Response Headers