音潮开放平台
Docs

快速开始

本指南将帮助你在 5 分钟内完成首次 API 调用。

前置条件

  • 已注册并登录音潮开放平台
  • 账户余额充足

创建 API Key

音潮开放平台采用 Bearer Token 方式进行 API 认证。所有 API 请求均需在请求头中携带有效的 API Key。

获取 API Key

1

登录控制台后，进入左侧导航栏「API Keys」页面。

2

点击「创建 API Key」按钮，输入名称（如：生产环境、测试环境）。

3

创建成功后，系统会展示完整的 API Key。请立即复制保存，关闭弹窗后将不再显示完整密钥。

服务器域名

https://open.yinchaoyongxian.com

认证

在所有 API 请求的请求头中加入 Authorization 字段：

Authorization: Bearer YOUR_API_KEY

同时建议携带 Content-Type: application/json：

curl "https://open.yinchaoyongxian.com/api/v1/task/query?task_id=xxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

发送请求

curl -X POST "https://open.yinchaoyongxian.com/api/v1/lyric/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "prompt": "创作一首轻快的流行音乐，主题是夏天的海边"
}'
响应示例

成功提交后，接口会返回类似以下内容的响应。

{
  "title": "半透明的薄雾",
  "lyric": "[INTRO]\n\n[VERSE]\n赤脚踩碎细浪的光\n海风偷走发梢的谎\n你笑着甩开拖鞋奔向远方\n贝壳在掌心微微发烫\n\n[CHORUS]\n阳光是跳动的糖粒\n咸味在舌尖轻轻游弋\n我们追着云影跑过整片滩涂\n把时间晒成半透明的薄雾\n\n[VERSE]\n冰镇汽水冒出气泡的歌\n纸船载着未写完的承诺\n你指着天边说那朵云像鲸鱼\n我点头却悄悄记住你睫毛的弧度\n\n[CHORUS]\n阳光是跳动的糖粒\n咸味在舌尖轻轻游弋\n我们追着云影跑过整片滩涂\n把时间晒成半透明的薄雾\n\n[BREAK]\n潮声慢下来 海平线踮起脚尖\n\n[CHORUS]\n阳光是跳动的糖粒\n咸味在舌尖轻轻游弋\n我们追着云影跑过整片滩涂\n把时间晒成半透明的薄雾\n\n[OUTRO]\n"
}