欢迎使用 Crun Suno APIs
由先进 AI 模型驱动，Crun Suno API 提供全面的 AI 音乐生成与音频处理服务。
无论你需要生成音乐、创建音效、扩展音频，还是进行人声分离，我们的 API 都可以满足你的创作需求。
Suno AI 音乐模型
支持多种音乐模型，包括最新的 Suno V5 模型。
V4.5plus
增强人声控制，人声表现更加稳定。
音乐生成 APIs
提供全面的 AI 音乐创作与音频处理 API 服务。
音效生成
通过文本提示生成音效、环境音与循环音频。
开始使用
选择适合的音乐 API
从上方分类中选择最适合你业务场景的音乐 API。
完成集成
按照对应音乐 API 的文档说明，将 API 集成到你的应用程序中。
开始创作
通过简单的 API 调用，开始生成你的内容。
最佳实践
身份认证
所有 API 请求都需要在请求头中携带 API Key。
请妥善保管你的 API Key。不要在客户端代码或公开仓库中暴露它。
创建任务
所有 Suno API 的任务创建请求都遵循统一的外层结构，仅 input 字段会根据模型不同而变化。
只有 HTTP 状态码与业务状态码同时为 200 时，才表示请求成功。
curl -X POST "https://api.crun.ai/api/v1/client/job/CreateTask" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-d '{
"model": "suno/music-generate",
"callback_url": "https://your.domain/api/v1/callback/task",
"input": {
"mode": "simple",
"model": "v5",
"instrumental": false,
"prompt": "一首现代西方 R&B 风格歌曲，灵魂感十足的女声，情感丰富且音色柔和。"
}
}'
响应示例
{
"code": 200,
"message": "success",
"data": {
"task_id": "xxxx-xxxx"
}
}
轮询任务状态
建议轮询间隔设置为 15 至 30 秒。生产环境推荐使用 Webhook 回调方式。
curl -X GET "https://api.crun.ai/api/v1/client/job/TaskInfo?task_id=xxxx-xxxx" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
响应示例
{
"code": 200,
"message": "success",
"data": {
"task_id": "suno_task_12345678",
"provider": "Suno",
"model_version": "sunov5",
"status": "running",
"param": {
"model": "suno/music-generate",
"callback_url": "https://your.domain/api/v1/callback/task",
"input": {
"mode": "simple",
"model": "v5",
"instrumental": false,
"prompt": "一首现代西方 R&B 风格歌曲，灵魂感十足的女声，情感丰富且音色柔和。"
}
},
"create_at": 1773969449,
"result": null,
"duration_s": null,
"complete_at": null
}
}
- 任务状态由响应
data 对象中的 status 字段决定。
- 当
status 为 success 时，可从 data.result.media_urls 获取生成后的媒体地址。
data.result.suno_data 中的每个元素都代表一个 Suno 音乐对象，包含歌曲相关信息。- 当
status 为 failed 时，请查看 data.result 中的错误码与错误信息。
回调通知
虽然支持轮询方式，但生产环境强烈推荐使用 Webhook 回调。
当你在创建任务请求中提供 callback_url 时，请确保：
- 回调地址可通过公网 HTTPS 访问。
- 接口响应速度足够快（建议小于 3 秒），以避免重复重试。
- 成功接收后返回 HTTP 200 状态码。
- 接口具备幂等性，因为回调通知可能会重复发送。
回调数据结构与任务状态查询 API 返回的 data 对象保持一致，因此可以共用同一套解析逻辑。
当任务状态发生变化时，我们会通过 POST 请求通知你任务结果。
回调数据结构与任务状态查询接口中的 data 对象一致。
生产环境中，强烈推荐使用回调通知来获取任务结果。
Credits 与计费
不同的音乐 API 会根据其计算资源需求消耗不同数量的 Credits。
访问 pricing 页面查看各音乐 API 的详细计费说明。
查看剩余 Credits：
curl -X POST "https://api.crun.ai/api/v1/client/account/balance" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
支持与帮助
需要帮助选择合适的模型或集成 API？
