# 天谱乐AI音乐API开放平台

## Docs
- 入门 [概览](https://platform.tianpuyue.cn/docs/8859396m0.md): 
- 入门 [快速开始](https://platform.tianpuyue.cn/docs/8859397m0.md): 
- 入门 [模型及定价](https://platform.tianpuyue.cn/docs/8859398m0.md): 
- API文档 [域名及接口鉴权](https://platform.tianpuyue.cn/docs/8859399m0.md): 
- API文档 [通用错误码](https://platform.tianpuyue.cn/docs/8859400m0.md): 
- 其他 [更新日志](https://platform.tianpuyue.cn/docs/8859404m0.md): 
- 其他 [联系我们](https://platform.tianpuyue.cn/docs/8859403m0.md): 
- 其他 [旧接口停用说明](https://platform.tianpuyue.cn/docs/8859402m0.md): 

## API Docs
- API文档 > 歌曲生成 [音乐生成](https://platform.tianpuyue.cn/docs/464626884e0.md): 1. 支持用户自定义上传音乐描述和歌词，然后生成歌曲，callback_url 测试时可以在网站https://webhook.site 配置一个回调进行测试，关于callback_url实现参考[音乐生成回调接口](apifox://link/endpoint/464626885)
- API文档 > 歌曲生成 [音乐生成回调接口](https://platform.tianpuyue.cn/docs/464626885e0.md): 您需要自行开发一个回调接口，可以在网站https://webhook.site 配置一个回调进行测试。天谱乐在音乐生成后会回调你的接口进行任务状态通知，处理成功需返回：success。音乐一次生成会有三次回调，第一次mp3音频回调，第二次wav音频回调，第三次歌词数据回调。支持流式生成的模型会多一次回调，流式播放的url有效期10分钟。回调的状态信息可以参考下面event的定义。请确保你的接口可以正常通过公网访问，通过回调接口在第一时间接受通知是我们最推荐的工程实践。你也可以在任务提交一段时间后通过状态查询接口去定期轮训任务状态，但查询接口有限流，超限的访问会被拒绝。
- API文档 > 歌曲生成 [歌曲生成任务状态查询](https://platform.tianpuyue.cn/docs/464626886e0.md): 输入作品id，查询对应信息，因为查询接口有并发限制，我们建议任务生成后 间隔一段时间（比如20s）后 以固定的时间（2s）间隔来轮询任务。
- API文档 > 歌词生成 [歌词生成](https://platform.tianpuyue.cn/docs/464626887e0.md): 输入关键词，生成歌词。
- API文档 > 歌词生成 [歌词生成回调接口](https://platform.tianpuyue.cn/docs/464626888e0.md): 您需要自行开发一个回调接口，天谱乐在歌词生成后会回调你的接口进行任务状态通知，处理成功需返回字符串：success，如果没有返回success，天谱乐平台会有重试机制。请确保你的接口可以正常通过公网访问，实现回调接口可以第一时间接受通知是我们最推荐的实现的方案，你也可以在任务提交一段时间后通过状态查询接口去兜底查询状态，查询接口有限流，请不要调用过于频繁。
- API文档 > 歌词生成 [歌词生成任务状态查询](https://platform.tianpuyue.cn/docs/464626889e0.md): 输入任务id，查询对应信息。
- API文档 > 音轨分离 [创建任务](https://platform.tianpuyue.cn/docs/464626891e0.md): 输入关键词，生成歌词。
- API文档 > 音轨分离 [音轨分离任务状态查询](https://platform.tianpuyue.cn/docs/464626892e0.md): 输入作品id，查询对应信息。
- API文档 > 音轨分离 [音轨分离回调接口](https://platform.tianpuyue.cn/docs/464626893e0.md): 自行开发的回调接口，用于处理完成的回调，请求成功需返回：success。
- API文档 > 账号资金查询 [信息查询](https://platform.tianpuyue.cn/docs/464626890e0.md): 查询余额