Suno API 文档
Suno API 提供专业的、无水印的音乐生成服务，具有快速流式输出和高性价比 - 是完美的无缝音频 API 集成选择。
API 服务概览
我们目前提供以下 API 服务：
- 音频生成
- 创建高质量 AI 生成音乐
- 支持自定义和非自定义生成模式
- 支持有歌词和纯音乐生成
- 多种模型版本（V3.5、V4）
- 音频扩展
- 扩展现有音频曲目
- 自定义续写参数
- 无缝音频过渡
- 歌词生成
- 生成专业歌词内容
- 每次请求生成多个歌词版本
- 包含标题建议
- WAV 格式生成
- 将生成的音频转换为 WAV 格式
- 高质量音频导出
- 人声分离
- 将音频分离为人声和伴奏轨道
- 完美用于创建卡拉OK版本或提取人声
基本信息
- API 服务器：
https://apibox.erweima.ai - API 版本：1.0.0
- 技术支持：[email protected]
在使用 API 之前，请确保：
- 从API 密钥管理页面获取您的 API 密钥
- 查看认证指南
入门指南
认证
所有 API 请求都需要使用 Bearer Token 认证：
Authorization: Bearer YOUR_API_KEY
重要提示：
- 保持 API 密钥安全
- 切勿共享您的 API 密钥
- 如密钥泄露，立即重置
错误处理
我们的 API 使用标准 HTTP 状态码和详细的错误消息：
| 代码 | 描述 |
|---|---|
| 200 | 成功 - 请求成功 |
| 400 | 无效参数 - 请求参数无效 |
| 401 | 未授权 - 需要认证或认证失败 |
| 404 | 未找到 - 无效的请求方法或路径 |
| 405 | 速率限制 - API 调用频率超过限制 |
| 413 | 内容过大 - 主题或提示过长 |
| 429 | 额度不足 - 账户额度不足 |
| 455 | 维护中 - 系统正在维护 |
| 500 | 服务器错误 - 发生内部服务器错误 |
API 服务详情
音频生成
音频生成 API 可以创建原创 AI 生成音乐：
- 支持自定义和非自定义生成模式
- 支持纯音乐或带歌词的音乐
- 每次请求生成多个音乐结果
- 提供带时间戳的歌词用于同步
- 包含封面图片生成
音频扩展
无缝扩展现有音频曲目：
- 可从原始音频的任意时间点继续
- 与源音频保持一致性
- 自定义续写参数
歌词生成
生成专业的歌词内容：
- 每次请求生成多个歌词版本
- 自动提供标题建议
- 支持各种音乐风格
- 丰富的语义表达
WAV 格式生成
将生成的音频转换为高质量 WAV 格式：
- 专业音频质量
- 适合进一步音频编辑
- 无损音频格式
人声分离
将音频分离为人声和伴奏部分：
- 提取干净的人声轨道
- 分离伴奏部分
- 保留原始音频
- 完美用于混音或卡拉OK
额度管理
通过额度系统监控和管理您的 API 使用情况：
- 查看剩余额度
- 跟踪使用历史
- 设置使用警报
最佳实践
-
回调处理
- 实现强健的回调处理机制
- 适当处理不同的回调阶段
- 优雅处理边缘情况和错误
-
错误处理
- 实现适当的错误处理
- 对暂时性故障使用重试机制
- 定期监控额度使用情况
-
性能优化
- 高效处理流式响应
- 实现适当的请求超时
- 在适当情况下缓存响应
需要帮助？
如果您遇到任何问题或有疑问，请通过以下方式联系我们：
- 📧 电子邮件：[email protected]
- 💬 在线支持：控制台
- 📚 API 参考：完整文档
语言支持
本文档提供英文和中文两种语言版本。您可以使用导航栏中的语言选择器切换语言。