音乐生成回调接口

POST

https://你的域名/song/callback

您需要自行开发一个回调接口，可以在网站https://webhook.site 配置一个回调进行测试。天谱乐在音乐生成后会回调你的接口进行任务状态通知，处理成功需返回：success。音乐一次生成会有三次回调，第一次mp3音频回调，第二次wav音频回调，第三次歌词数据回调。支持流式生成的模型会多一次回调，流式播放的url有效期10分钟。请确保你的接口可以正常通过公网访问，实现回调接口可以第一时间接受通知是我们最推荐的实现的方案，你也可以在任务提交一段时间后通过状态查询接口去兜底查询状态，查询接口有限流，请不要调用过于频繁。

请求参数

Body 参数application/json

示例

{
    "songs": [
        {
            "item_id": "70",
            "status": "succeeded",
            "audio_hi_status": "occaecat cupidatat in anim velit",
            "lyrics_sections_status": "sub_succeeded",
            "event": "wav_complete",
            "model": "xx",
            "title": "拔胡说握大哎哟勇敢抚",
            "style": "laboris nisi magna in anim",
            "prompt": "officia tempor voluptate veniam sit",
            "duration": 20,
            "created_at": 1741366502768,
            "finished_at": 9,
            "audio_url": "https://****",
            "audio_hi_url": "https://****",
            "lyrics_sections": [
                {
                    "start": 1,
                    "end": 77,
                    "text": "AAA"
                },
                {
                    "start": 59,
                    "end": 55,
                    "text": "BBB"
                },
                {
                    "start": 54,
                    "end": 37,
                    "text": "CCC"
                }
            ],
            "lyrics": "AAABBBCCC"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://你的域名/song/callback' \
--header 'Content-Type: application/json' \
--data-raw '{
    "songs": [
        {
            "item_id": "70",
            "status": "succeeded",
            "audio_hi_status": "occaecat cupidatat in anim velit",
            "lyrics_sections_status": "sub_succeeded",
            "event": "wav_complete",
            "model": "xx",
            "title": "拔胡说握大哎哟勇敢抚",
            "style": "laboris nisi magna in anim",
            "prompt": "officia tempor voluptate veniam sit",
            "duration": 20,
            "created_at": 1741366502768,
            "finished_at": 9,
            "audio_url": "https://****",
            "audio_hi_url": "https://****",
            "lyrics_sections": [
                {
                    "start": 1,
                    "end": 77,
                    "text": "AAA"
                },
                {
                    "start": 59,
                    "end": 55,
                    "text": "BBB"
                },
                {
                    "start": 54,
                    "end": 37,
                    "text": "CCC"
                }
            ],
            "lyrics": "AAABBBCCC"
        }
    ]
}'

返回响应

🟢200成功

*/*

Body

示例

success

音乐生成

歌曲生成任务状态查询