API · MCP · OpenAPI

开发者

把桃源接进你的 Agent、脚本或产品：一句话，三分钟，一首完整的歌。REST、MCP 与 OpenAPI 三种方式，同一套额度。

Agent 能用桃源做什么

桃源为一个人写一首歌。把用户的一句话交给它，先拿到歌名、歌词和风格（免费），确认后生成两版完整的歌，大约三分钟。

为一个人写一首歌

生日、婚礼、告白、纪念日。歌词只用用户说过的事，不编造。

约三分钟出两版

每次生成返回两首完整候选，各带音频、歌词和封面。

多语种

中文、粤语、英文、日文歌词；纯音乐也可以。

改一段、分轨

只重做副歌的 30 秒；人声 / 伴奏分离，或 12 轨拆分。

三步流程

机器可读入口

选你的平台。所有方式都用同一个 Key：把 ty_live_… 换成你自己的。

还没有 Key？在下方「API Key」创建，新 Key 送 3 次生成。

终端里一行即可。之后在对话里说「给我妈写首生日歌」，Claude 会先编译给你看，再生成。

claude mcp add --transport http taoyuan https://api.musicsforyou.com/mcp --header "Authorization: Bearer ty_live_..."

bash

MCP 工具名与 OpenAPI 的 operationId 一致。完整字段见 OpenAPI 文档。

名称	扣费	用途	REST
compile_music_prompt	免费	一句需求 → spec（歌名、风格、歌词、时长）。status=needs_input 时带 clarificationAnswer 再调	POST /v1/prompts/compile
revise_generation_prompt	免费	对 spec 应用一句修改指令	POST /v1/prompts/revise
generate_music	1 次	提交 spec 或 rendered，返回 generation id，两首候选	POST /v1/generations
create_song	1 次	一步到位：编译 + 生成 + 等待，最长 180 秒	POST /v1/songs
get_generation	免费	轮询状态；finished 后 clips[].audioUrl。支持 waitSeconds 长轮询	GET /v1/generations/{id}
replace_section	1 次	只重做 [startS, endS]，≥10 秒、≤ 原曲一半	POST /v1/generations/{id}/replace-section
separate_stems	见说明	人声 / 伴奏两轨：每首歌免费一次，会员不限；12 轨为 Pro。都不扣次数	POST /v1/tracks/{id}/stems
list_tracks	免费	我的作品分页	GET /v1/tracks
list_presets	免费	场景 / 流派 id	GET /v1/presets
get_credit_balance	免费	可用额度与购买链接	GET /v1/me/credits

所有错误都是 { success: false, code, error }，按 code 分支：NEED_TOPUP 表示额度不足，SPEC_INVALID 的 details 是诊断列表。

Key 以 ty_live_ 开头，明文只在创建时显示一次。每个账户最多 10 个。新 Key 附带 3 次免费生成。

API 与 MCP 的生成只消耗预付额度，不消耗 Pro 月额度。1 次 = 一首歌（两版候选）。生成失败自动退回。

当前 API 额度

可用次数

—

近 30 天

额度包

支持信用卡、微信、支付宝（人民币包）与国际卡（美元包）。

频率限制

每个 Key：生成与局部替换每分钟 5 次；编译与修改每小时 30 次。超出返回 429，稍后重试即可。

内容

请不要提交你没有授权的歌词或他人作品；违规内容会被拦截，不扣费。

商用

通过 API 生成的歌曲，Key 的所有者可以商用。

支持

问题或建议发邮件到 [email protected]，我们会回复。