跳到主要内容

Suno API 文档

Suno API 提供专业的、无水印的音乐生成服务,具有快速流式输出和高性价比 - 是完美的无缝音频 API 集成选择。

API 服务概览

我们目前提供以下 API 服务:

  1. 音频生成
    • 创建高质量 AI 生成音乐
    • 支持自定义和非自定义生成模式
    • 支持有歌词和纯音乐生成
    • 多种模型版本(V3.5、V4)
  2. 音频扩展
    • 扩展现有音频曲目
    • 自定义续写参数
    • 无缝音频过渡
  3. 歌词生成
    • 生成专业歌词内容
    • 每次请求生成多个歌词版本
    • 包含标题建议
  4. WAV 格式生成
    • 将生成的音频转换为 WAV 格式
    • 高质量音频导出
  5. 人声分离
    • 将音频分离为人声和伴奏轨道
    • 完美用于创建卡拉OK版本或提取人声

基本信息

  • API 服务器https://apibox.erweima.ai
  • API 版本:1.0.0
  • 技术支持[email protected]

在使用 API 之前,请确保:

  1. API 密钥管理页面获取您的 API 密钥
  2. 查看认证指南

入门指南

认证

所有 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 格式:

  • 专业音频质量
  • 适合进一步音频编辑
  • 无损音频格式

了解更多关于 WAV 生成 →

人声分离

将音频分离为人声和伴奏部分:

  • 提取干净的人声轨道
  • 分离伴奏部分
  • 保留原始音频
  • 完美用于混音或卡拉OK

了解更多关于人声分离 →

额度管理

通过额度系统监控和管理您的 API 使用情况:

  • 查看剩余额度
  • 跟踪使用历史
  • 设置使用警报

最佳实践

  1. 回调处理

    • 实现强健的回调处理机制
    • 适当处理不同的回调阶段
    • 优雅处理边缘情况和错误
  2. 错误处理

    • 实现适当的错误处理
    • 对暂时性故障使用重试机制
    • 定期监控额度使用情况
  3. 性能优化

    • 高效处理流式响应
    • 实现适当的请求超时
    • 在适当情况下缓存响应

需要帮助?

如果您遇到任何问题或有疑问,请通过以下方式联系我们:

语言支持

本文档提供英文和中文两种语言版本。您可以使用导航栏中的语言选择器切换语言。