开发者

Sonvi 开放 API

把 Sonvi 曲库接入你自己的产品。通过一套 REST API 搜索和播放 AI 歌曲、上传新作品，并让你的用户评分、收藏和许愿。

查看完整 API 文档 · 申请 API Key

可以做什么

浏览曲库

全文搜索、热门与最新榜单、风格、语言、相似推荐，以及带歌词的歌曲详情。

权限： catalog:read

播放与下载

支持 HTTP Range 的音频流播放、MP3 下载和封面图片。

权限： media:read

上传歌曲

代你的用户上传 MP3、元数据和歌词，并查询审核状态。

权限： tracks:write

用户互动

评分、举报、收藏、许愿，以及“你的歌上线了”通知，按你的每个用户分别记录。

权限： social:write

代表你的用户操作

在 X-End-User-Id 请求头中传入你自己的用户 ID，Sonvi 会在首次使用时自动创建对应账号。评分、收藏和上传都按人区分，也不会和其他合作方的数据混在一起。

限流

每个 Key 默认每分钟 120 次请求。每个响应都会在 X-RateLimit-* 响应头中返回剩余额度，如需更高额度可以联系我们。

快速开始

API Key 只保存在你的服务端，通过 X-API-Key 请求头发送：

curl "https://api.sonvi.ai/api/search?q=love&limit=5" \
  -H "X-API-Key: sk_live_xxxxxxxx_your_secret" \
  -H "X-End-User-Id: user-123"

申请 API Key

API Key 由 Sonvi 团队签发。请发邮件告诉我们你的产品、预计调用量和需要的权限。

[email protected]