Suno API 快速开始
几分钟内开始使用 Suno API 生成AI音乐、歌词和音频内容
欢迎使用 Suno API
身份验证
API 基础 URL
https://api.kie.ai身份验证请求头
快速开始指南
第一步：生成您的第一个音乐曲目
cURL
JavaScript
Python
第二步：检查任务状态
JavaScript
Python
cURL
响应格式
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e",
"parentMusicId": "",
"param": "{\"prompt\":\"一首平静舒缓的钢琴曲\",\"style\":\"平静, 舒缓, 钢琴\"}",
"response": {
"taskId": "5c79****be8e",
"sunoData": [
{
"id": "e231****-****-****-****-****8cadc7dc",
"audioUrl": "https://example.cn/****.mp3",
"streamAudioUrl": "https://example.cn/****",
"imageUrl": "https://example.cn/****.jpeg",
"prompt": "[Verse] 夜晚城市 灯火辉煌",
"modelName": "chirp-v3-5",
"title": "钢铁侠",
"tags": "electrifying, rock",
"createTime": "2025-01-01 00:00:00",
"duration": 198.44
}
]
},
"status": "SUCCESS",
"type": "GENERATE",
"errorCode": null,
"errorMessage": null
}
}{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e",
"parentMusicId": "",
"param": "{\"prompt\":\"一首平静舒缓的钢琴曲\",\"style\":\"平静, 舒缓, 钢琴\"}",
"response": {
"taskId": "5c79****be8e",
"sunoData": [],
"errorMessage": "生成失败，请重试或联系客服"
},
"status": "GENERATE_AUDIO_FAILED",
"type": "GENERATE",
"errorCode": 501,
"errorMessage": "生成失败，请重试或联系客服"
}
}核心功能
AI 模型
生成模式
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
customMode | boolean | 是 | 控制参数复杂度： • false: 简单模式，仅需要提示词• true: 高级模式，需要风格和标题 |
instrumental | boolean | 是 | 决定音乐是否包含人声： • true: 仅纯音乐（无歌词）• false: 包含人声/歌词 |
关键参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | 对所需音乐的文本描述。请具体说明流派、情绪和乐器。 字符限制： • 非自定义模式：500字符 • 自定义模式（V3_5 & V4）：3000字符 • 自定义模式（V4_5、V4_5PLUS & V5）：5000字符 |
style | string | 否 | 音乐风格规范（仅自定义模式）。 示例： 爵士、古典、电子、流行、摇滚、嘻哈 字符限制： • V3_5 & V4：200字符 • V4_5、V4_5PLUS & V5：1000字符 |
title | string | 否 | 生成音乐曲目的标题（仅自定义模式）。 最大长度： 80字符 |
完整工作流程示例
JavaScript
Python
状态码和任务状态
| 状态 | 类型 | 说明 |
|---|---|---|
PENDING | 处理中 | 任务正在等待处理或正在生成中 |
TEXT_SUCCESS | 部分完成 | 歌词/文本生成成功完成 |
FIRST_SUCCESS | 部分完成 | 第一个曲目生成完成 |
SUCCESS | 完成 | 所有曲目生成成功 |
CREATE_TASK_FAILED | 错误 | 创建任务失败 |
GENERATE_AUDIO_FAILED | 错误 | 生成音频失败 |
CALLBACK_EXCEPTION | 错误 | 回调 过程中出错 |
SENSITIVE_WORD_ERROR | 错误 | 内容因敏感词被过滤 |