天谱乐AI音乐API开放平台
API文档
天谱乐API开放平台音乐创作
API文档
天谱乐API开放平台音乐创作
  1. 歌曲生成
  • 入门
    • 概览
    • 快速开始
    • 模型及定价
  • API文档
    • 通用说明
      • 域名及接口认证
      • 错误码说明
    • 歌曲生成
      • Voice ID对照表
      • 音乐生成
        POST
      • 音乐生成回调接口
        POST
      • 歌曲生成任务状态查询
        POST
    • 纯音乐生成
      • 纯音乐生成
      • 纯音乐生成回调接口
      • 纯音乐生成任务状态查询
    • 歌词生成
      • 歌词生成
      • 歌词生成回调接口
      • 歌词生成任务状态查询
    • 音轨分离
      • 创建任务
      • 音轨分离任务状态查询
      • 音轨分离回调接口
    • 账号资金查询
      • 信息查询
  • 其他
    • 旧接口停用说明
    • 联系我们
    • 更新日志
  1. 歌曲生成

歌曲生成任务状态查询

POST
{{base_url}}/open-apis/v1/song/query
最后修改时间:2026-05-27 12:57:06
输入作品id,查询对应信息,因为查询接口有并发限制,我们建议任务生成后 间隔一段时间(比如20s)后 以固定的时间(2s)间隔来轮询任务。

请求参数

Header 参数

Body 参数application/json

示例
{
    "item_ids": [
        "123"
    ]
}

请求示例代码

Shell
JavaScript
Java
Go
PHP
Python
Ruby
请求示例请求示例
Shell
JavaScript
Java
Go
curl --location --globoff 'https://api.tianpuyue.cn/open-apis/v1/song/query' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json' \
--data '{
    "item_ids": [
        "123"
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "status": 200000,
    "message": "success",
    "request_id": "4b185c6f-ed37-4b7d-af15-691be79996fc",
    "data": {
        "songs": [
            {
                "item_id": "l2m_xxxxxx",
                "status": "succeeded",
                "audio_hi_status": "sub_succeeded",
                "lyrics_sections_status": "sub_succeeded",
                "event": null,
                "model": "TemPolor v4.5+",
                "title": "窗外的雨声",
                "style": "Chinese style pop",
                "prompt": "中文流行抒情歌曲,中慢速节奏(70–85 BPM),钢琴与柔和合成器开场,副歌加入弦乐与鼓组增强情绪。旋律有记忆点,副歌朗朗上口。",
                "duration": 207,
                "created_at": 1776246989,
                "finished_at": 1776247144,
                "audio_url": "https://data-sz.tianpuyue.cn/llm_music/mp3/l2m_nPQyp0C1C3gFge5PQ.mp3?auth_key=xxxxx",
                "audio_hi_url": "https://data-sz.tianpuyue.cn/llm_music/post/l2m_nPQyp0C1C3gFge5PQ.wav?auth_key=xxxxx",
                "lyrics_sections": [
                    {
                        "start": 0.86,
                        "end": 0.88,
                        "text": "[intro]"
                    },
                    {
                        "start": 24.021,
                        "end": 24.041,
                        "text": "[verse]"
                    },
                    {
                        "start": 24.961,
                        "end": 28.65,
                        "text": "窗外的雨声模糊了街灯"
                    },
                    {
                        "start": 31.102,
                        "end": 34.2,
                        "text": "你的背影消失在转角尽头"
                    },
                    {
                        "start": 36.642,
                        "end": 39.13,
                        "text": "我握着还温热的咖啡杯"
                    },
                    {
                        "start": 39.662,
                        "end": 42.19,
                        "text": "却再也等不到你回眸"
                    }
                ],
                "lyrics_disp": "[intro]\n[verse]\n窗外的雨声模糊了街灯\n你的背影消失在转角尽头\n我握着还温热的咖啡杯\n却再也等不到你回眸\n...",
                "lrc_mv": null,
                "audio_bgm_url": null,
                "lyrics": "[intro]\n[verse]\n窗外的雨声模糊了街灯\n你的背影消失在转角尽头\n我握着还温热的咖啡杯\n却再也等不到你回眸\n\n空荡的房间只剩下呼吸\n墙上的钟摆刻着分离\n\n...",
                "streamAudioUrl": "https://media-pipe.api.tianpuyue.cn/stream?from=o&itemId=l2m_xxxxx"
            }
        ]
    }
}
修改于 2026-05-27 12:57:06
上一页
音乐生成回调接口
下一页
纯音乐生成
Built with