使用天谱乐 AI 生成纯音乐、歌曲(含人声演唱)或歌词,将结果保存到本地。当用户提到"天谱乐""天璞悦""Tianpuyue""Tempolor""AI 作曲""AI 音乐""生成音乐""生成歌曲""生成歌词""BGM""背景音乐"时引用;当用户需要为视频、游戏或内容创作配乐时引用;当用户需要纯音乐(无人声)时引用;当用户需要带人声演唱的完整歌曲时引用;当用户需要 AI 写歌词时引用。当用户同时提到"工作流""流水线""编排"时,不应直接引用此 skill,应优先让 content_generation_workflow 统一调度。
这个 skill 是纯内容生成能力,负责天谱乐的纯音乐/歌曲/歌词任务创建、状态查询和本地下载,不负责对象存储上传或分享链接生成。
适用场景:
item_id,只需要查询进度或下载本地结果脚本位于 skill 目录内的 scripts/,运行时始终使用绝对路径。
设 TP_SKILL_DIR 为 .claude/skills/tianpuyue_music 的绝对路径:
uv run --python python $TP_SKILL_DIR/scripts/generate_music.py --prompt "..." --name "忧伤钢琴曲"uv run --python python $TP_SKILL_DIR/scripts/generate_song.py --prompt "..." --name "夏日海边"uv run --python python $TP_SKILL_DIR/scripts/generate_lyrics.py --prompt "..." --name "青春离别"uv run --python python $TP_SKILL_DIR/scripts/query_music_status.py --item-id <ID>uv run --python python $TP_SKILL_DIR/scripts/query_song_status.py --item-id <ID>uv run --python python $TP_SKILL_DIR/scripts/query_lyrics_status.py --item-id <ID>| 参数 | 必需 | 说明 |
|---|---|---|
--prompt | 是 | 音乐描述提示词,可包含节奏、调性、和弦、时长等 |
--name | 否 | 文件名描述,不超过 10 个中文字 |
--model | 否 | 模型名称,默认 TemPolor i3.5 |
--poll-interval | 否 | 轮询间隔秒数,默认 15 |
--timeout | 否 | 超时秒数,默认 900 |
| 参数 | 必需 | 说明 |
|---|---|---|
--prompt | 是 | 音乐描述提示词 |
--name | 否 | 文件名描述,不超过 10 个中文字 |
--model | 否 | 模型名称,默认 TemPolor v4.5 |
--lyrics | 否 | 自定义歌词(为空时自动生成) |
--voice-id | 否 | 演唱声音 ID,参考 references/voice_id_map.md |
--poll-interval | 否 | 轮询间隔秒数,默认 15 |
--timeout | 否 | 超时秒数,默认 900 |
| 参数 | 必需 | 说明 |
|---|---|---|
--prompt | 是 | 歌词生成的提示文本 |
--name | 否 | 文件名描述,不超过 10 个中文字 |
--song-model | 否 | 适配的歌曲模型名称,默认 TemPolor v4.5 |
--poll-interval | 否 | 轮询间隔秒数,默认 10 |
--timeout | 否 | 超时秒数,默认 300 |
OUTPUT_ROOT,默认为项目根目录):
outputs/tianpuyue/music/outputs/tianpuyue/songs/outputs/tianpuyue/lyrics/type — music / songprovider — tianpuyueitem_idlocal_pathsource_urltype — lyricsprovider — tianpuyueitem_idlocal_pathtitlelyricTIANPUYUE_API_KEY(必需,未设置时直接报错)TIANPUYUE_CALLBACK_URL(可选,轮询模式下使用占位值即可)OUTPUT_ROOT(可选,输出根目录,支持 ~ 展开,默认为用户主目录)