AI音乐聚合API·爱音悦开放平台

01试听示例

🎤 Golden Voices 音潮

光在拔节 磅礴女声流行抒情，钢琴与弦乐铺底，副歌高亢有穿透力，情绪层层递进，录音棚级质感

🌆 城市民谣音潮

晚安轮廓 城市民谣，木吉他扫弦，男声低吟浅唱，讲述深夜便利店与下班路上的故事，温暖治愈

🏮 国风音潮

烟波画就 国风古韵，古筝与竹笛为主，女声婉转悠扬，烟雨江南意象，副歌加入戏腔点缀

🌧️ Lo-Fi 音潮

云散前 Lo-Fi 慵懒节拍，爵士钢琴配上黑胶底噪，轻柔女声哼唱，雨夜咖啡馆的安静氛围

🎧 天谱乐 TemPolor 天谱乐

夏夜的风 中文流行抒情，钢琴开场，副歌加入弦乐，温暖治愈

🎧 天谱乐 TemPolor 天谱乐

海风把云朵吹成棉花糖 轻快流行，木吉他拨弦，女声清新治愈，夏日海边

🌞 Suno v6 Suno v6

Summer Stays upbeat electronic pop, bright s...

🎸 Suno v6 Suno v6

Summer Stays (Alt) upbeat electronic pop, bright s...

02支持的模型

音潮 v4.0

YINCHAO · 中文首选

中文人声与咬字表现出众，约 80 秒出歌，自带完整歌词结构。国内生成式 AI 服务备案，成本最低。一次调用只出 1 首。

可商用6 积分 / 次 · 出 1 首

Suno

SUNO · 英文与特殊风格

英文、电音、说唱等风格的质量天花板。已升级 v6 模型，约 2 分钟出歌，自带官方封面。

限个人 / 非商用12 积分 / 次 · 出 2 首

天谱乐 TemPolor

TEMPOLOR / MUREKA · 多语种

30+ 语种、逐行时间轴歌词。产出带 ACR 版权认证，适合有商用与出海需求的场景。一次调用只出 1 首。

已开放8 积分 / 首

MP4

爱音乐竖版视频

OUR OWN · 成品交付

把任意音频渲染成 1080×1920 竖版 MP4（歌词视频），卡拉 OK 逐字字幕 + 自动封面。视频时长 = 整首歌（默认），最长 600 秒；渲染约 1~3 分钟。聚合平台里独一份。

已开放15 积分

翻唱 Cover

YINCHAO · TEMPOLOR · 传音频重唱

传一段参考音频，保留主旋律重新演唱 / 改编。适合换音色、换编曲、换语种翻唱。默认走音潮仿写（v3.5，6 积分/首，最便宜）；指定 model=tempolor 走天谱乐 cover（8 积分/首）。均一次出 1 首。

已开放音潮 6 / 天谱乐 8 积分

歌词生成 Lyrics

YINCHAO · TEMPOLOR · 写词

输入主题 / 风格 / 情绪，只生成结构化歌词文本（不产音乐），含 [Verse]/[Chorus] 段落。默认走音潮（1 积分，最便宜，同步秒回）；指定 model=tempolor 走天谱乐（异步）。适合先写词再拿去生歌。

已开放1 积分 / 次

03申请 API Key

三步接入：注册登录 → 控制台自助创建 Key → 加微信领测试积分。

注册 / 登录账号

打开 https://www.aimusic.fashion/developer，手机号注册登录即可。

控制台创建 Key

进入开发者控制台，点「创建 Key」即时生成 sk_xxx；按需扫码充值（¥50/500 积分起）后即可调通 API。

充值 / 咨询

加微信 13591748656
领取测试积分、开通套餐或洽谈批量合作。

前往开发者控制台

04定价

按积分计费，1 积分 = ¥0.10。充值量越大单价越低。

能力	积分 / 次	约合人民币	说明
生成歌曲（自动路由 / 音潮）	6	¥0.60	中文首选，约 80 秒出歌，含自动封面；一次只出 1 首
生成歌曲（强制天谱乐）	8	¥0.80	多语种 + ACR 版权认证，一次只出 1 首
生成歌曲（强制 Suno V6）	12	¥1.20	英文、说唱、电子等特殊风格，一次出 2 首
竖版视频生成（MP4）	15	¥1.50	竖版 1080×1920，卡拉 OK 字幕 + 自动封面；视频时长 = 整首歌（默认），最长 600 秒
翻唱 Cover · 音潮仿写（默认）	6	¥0.60	reference 模式，v3.5，一次出 1 首，最便宜
翻唱 Cover · 天谱乐 cover	8	¥0.80	audio_url 重唱，保留主旋律，一次出 1 首
AI 写歌词（独立歌词生成）	1	¥0.10	音潮 / 天谱乐，按主题出结构化歌词，不产音乐
查询任务 / 模型列表	0	免费	不限制次数

生成失败、超时、平台异常 → 积分 自动全额退还。

05快速开始

三步：拿 Key → 提交生成 → 轮询结果。

POST https://api.aimusic.fashion/api/v1/generate

# 1) 提交生成任务
curl -X POST https://api.aimusic.fashion/api/v1/generate \
  -H "Authorization: Bearer sk_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"秋日胡同里的温暖民谣，木吉他与手风琴","language":"中文"}'

// 2) 返回（HTTP 202）
{
  "success": true,
  "task_id": "task_740d2398f69d2d07937ae947",
  "status": "running",
  "provider": "yinchao",
  "credits_cost": 6,
  "credits_remaining": 90,
  "estimated_time": 90
}

# 3) 轮询结果（免费，建议间隔 5~10 秒）
curl https://api.aimusic.fashion/api/v1/tasks/task_740d2398f69d2d07937ae947 \
  -H "Authorization: Bearer sk_你的Key"

06返回示例（已完成）

{
  "success": true,
  "task_id": "task_740d2398f69d2d07937ae947",
  "status": "completed",
  "provider": "yinchao",
  "progress": 100,
  "songs": [
    {
      "title": "橘子垂落时",
      "audio_url": "https://api.aimusic.fashion/static/audio/xxxxxx.mp3",
      "cover_url": "https://api.aimusic.fashion/static/covers/orange_song.png",
      "lyrics": "[VERSE]\n银杏叶落满青砖缝...",
      "duration": 120
    }
  ]
}

音频由我们自动转存到本站存储（长期有效，可直接播放/下载，不受上游临时链接过期影响）；封面由我们自动生成并托管（音潮本身不返回封面），随歌曲返回；不需要可传 cover:false。

07接口详情

所有接口均需请求头 Authorization: Bearer sk_xxx。

POST/api/v1/generate

参数	类型	说明
`prompt`必填	string	歌曲描述，例如「海边夏日的轻快民谣」
`lyrics`	string	自定义歌词（不传则由模型自行创作）
`style`	string	风格标签，逗号分隔，如「民谣,流行」
`title`	string	期望歌名
`language`	string	「中文」/「英文」，默认中文
`instrumental`	bool	是否纯音乐，默认 false
`n`	int	生成数量 1~2，默认 1。按次计费，n 不额外加价：Suno 一次调用即出 2 首、仍只收 12 积分；音潮、天谱乐一次只出 1 首（传 n=2 会被自动夹到 1，按 6 / 8 积分结算）
`model`	string	auto（默认）/ yinchao / tempolor / suno
`notify_url`	string	完成回调地址，见下方回调章节
`cover`	bool	是否自动补封面，默认 true（音潮本身不返回封面）

POST/api/v1/mv 15 积分

把已有音频渲染成 竖版 MP4（歌词视频）（1080×1920）：封面 + 逐字高亮的卡拉 OK 字幕 + 黑胶转动效果。支持 LRC 时间轴歌词，无歌词也能出片。

参数	类型	说明
`audio_url`必填	string	音频直链（mp3/m4a/wav），需可公网访问
`title`	string	歌名，用于封面与字幕标题
`lyrics`	string	歌词，支持 LRC 时间轴（`[00:12.50]歌词`），有则逐句卡点
`cover_url`	string	自定义封面图；不传则自动生成
`prompt`	string	封面画面描述（无封面时用于文生图）
`duration`	int	只渲染前 N 秒，0 或省略表示整首（上限 600）
`karaoke`	bool	卡拉 OK 逐字高亮，默认 true
`artist_name`	string	歌手名，显示在画面上
`notify_url`	string	完成回调地址

POST /api/v1/mv
{
  "audio_url": "https://cdn.example.com/song.mp3",
  "title": "橘子垂落时",
  "lyrics": "[00:00.00]橘子垂落时\n[00:05.00]秋风穿过旧巷",
  "duration": 30
}

→ 202 { "task_id": "task_xxx", "status": "pending", "credits_cost": 15 }

渲染完成后任务里会返回 videos[0].video_url（mp4 直链，长期有效）与 cover_url。视频时长 = 整首歌（默认）；渲染约 1~3 分钟，失败全额退积分。

POST/api/v1/cover 6 积分起

传一段参考音频，保留主旋律重新演唱 / 改编（翻唱）。支持换音色、换编曲、换语种。默认走音潮仿写（v3.5，6 积分）；指定 model=tempolor 走天谱乐 cover（8 积分）。均一次出 1 首。

参数	类型	说明
`audio_url`必填	string	参考音频直链（mp3/m4a/wav），需可公网访问
`prompt`	string	新风格 / 改编描述，如「女声抒情版」「摇滚编曲」，不传则保留原风格
`lyrics`	string	新歌词（不传则保留原歌词）
`style`	string	风格标签，逗号分隔
`language`	string	「中文」/「英文」，默认中文
`model`	string	auto（默认→音潮）/ yinchao / tempolor
`similarity`	number	仅音潮：与参考音频相似度 0.2 / 0.8 / 1.3 / 1.5（越大越像原曲），不传默认 0.8
`notify_url`	string	完成回调地址

POST /api/v1/cover
{
  "audio_url": "https://cdn.example.com/original.mp3",
  "prompt": "女声抒情版，换钢琴编曲",
  "similarity": 0.8
}

→ 202 { "task_id": "task_xxx", "status": "pending", "provider": "yinchao", "credits_cost": 6 }

翻唱完成后任务返回 audio_url（已自动转存到本站存储，长期有效，可直接播放/下载）。失败全额退积分。

POST/api/v1/lyrics 1 积分

输入主题 / 风格，只生成歌词文本（不产音乐）。默认走音潮（1 积分，同步秒回，请求即返回歌词）；指定 model=tempolor 走天谱乐（异步，需轮询）。返回结构化歌词（含 [Verse]/[Chorus] 段落），可直接拿去 /generate 生歌。Suno 歌词暂未接入。

参数	类型	说明
`prompt`必填	string	歌词主题 / 风格描述，如「一首关于大连海边的民谣，忧郁但温暖」
`style`	string	风格标签，逗号分隔
`language`	string	「中文」/「英文」，默认中文
`model`	string	auto（默认→音潮）/ yinchao / tempolor
`song_model`	string	仅天谱乐：歌词模型版本，如「TemPolor v3.5」
`notify_url`	string	完成回调地址

POST /api/v1/lyrics
{
  "prompt": "一首关于大连夏夜海边的民谣，温柔怀旧",
  "language": "中文"
}

→ 202 { "task_id": "task_xxx", "status": "pending", "provider": "yinchao", "credits_cost": 1 }

歌词生成完成后任务返回 songs[0].lyrics（歌词文本）。轮询 /api/v1/tasks/<task_id> 获取。失败全额退积分。

GET/api/v1/tasks/<task_id>

查询单个任务，免费。状态：pending → running → completed / failed。

GET/api/v1/tasks

任务列表，支持 ?limit=20（最大 100）。

GET/api/v1/credits

查询积分余额与累计消耗。

GET/api/v1/models

模型列表与健康状态（无需鉴权，可用于探活）。

08错误码

HTTP	code	含义与处理
401	`unauthorized`	Key 缺失或无效，检查请求头
402	`no_credits`	积分不足，充值后再试（本次不会扣费）
400	`empty_prompt`	prompt 为空
400	`bad_model`	model 参数不在支持范围
404	`not_found`	任务不存在或不属于该 Key
502	`submit_failed`	上游提交失败，已自动退还积分
502	`platform_busy`	平台繁忙，建议退避重试
503	`all_providers_down`	所有模型暂不可用

错误响应统一格式：{"success":false,"error":{"code":"...","message":"..."}}

09Webhook 回调

提交时传 notify_url，任务完成/失败后我们会 POST 结果给你。

POST /your/callback
X-Task-Id: task_740d2398f69d2d07937ae947
X-Task-Status: completed
X-Signature: sha256=8f2b...        // HMAC-SHA256(key, body)
Content-Type: application/json

// body 与 GET /api/v1/tasks/<task_id> 完全一致

校验方式：用你的 API Key 原文对原始请求体字符串做 HMAC-SHA256，与 X-Signature 比对。

回调失败会自动重试（状态未标记为成功前持续尝试），建议接口幂等。