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

纯音乐回调接口

POST
你的域名/instrumental/callback
自行开发的回调接口,用于生成完成的回调,请求成功需返回:success。纯音乐一次生成会有两次回调,第一次mp3音频回调,第二次wav音频回调。

请求参数

Body 参数application/json
instrumentals
array [object {13}] 
作品信息列表
必需
item_id
string 
作品id
可选
status
string 
可选
"状态
running-生成中
main_succeeded 主功能成功
failed 主功能失败
succeeded 成功
part_failed 部分子功能失败"
audio_hi_status
string 
可选
"无损音频生成状态
waiting-等待中
running-生成中
sub_succeeded-成功
sub_failed-失败"
model
string 
生成的模型
可选
title
string 
标题
可选
prompt
string 
音乐描述
可选
duration
integer 
时长-秒
可选
created_at
integer 
可选
任务创建的时间戳(以秒为单位)
finished_at
integer 
可选
任务完成的时间戳(以秒为单位),主功能完成的时间
audio_url
string 
可选
作品音频Url mp3 (有效期3天)
audio_hi_url
string 
可选
无损音频 wav (有效期3天)
style
string 
风格
可选
event
string 
可选
回调事件 1、audio_complete 2、wav_complete 3、lrcsections_complete
示例
{
    "instrumentals": [
        {
            "audio_hi_status": "sub_succeeded",
            "audio_hi_url": "https://****",
            "created_at": 1747278096,
            "duration": 262,
            "event": "wav_complete",
            "finished_at": 1747278158,
            "item_id": "123",
            "model": "TemPolor i3.5",
            "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic  Tempo: Typically ranges from 120 to 130 BPM (Beats Per Minute)  Structure: Build-ups, Drops, Breakdowns  Instruments/Sounds: Synthesizers, Drum Machines, Basslines, Hi-hats, Pads  Purpose: Ideal for clubs, parties, workout sessions, or background ambiance  Vibe: Uplifting, Groovy, Futuristic",
            "status": "succeeded",
            "style": "electronic,house,techno",
            "title": "Neon Pulse Drive"
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '你的域名/instrumental/callback' \
--header 'Content-Type: application/json' \
--data-raw '{
    "instrumentals": [
        {
            "audio_hi_status": "sub_succeeded",
            "audio_hi_url": "https://****",
            "created_at": 1747278096,
            "duration": 262,
            "event": "wav_complete",
            "finished_at": 1747278158,
            "item_id": "123",
            "model": "TemPolor i3.5",
            "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic  Tempo: Typically ranges from 120 to 130 BPM (Beats Per Minute)  Structure: Build-ups, Drops, Breakdowns  Instruments/Sounds: Synthesizers, Drum Machines, Basslines, Hi-hats, Pads  Purpose: Ideal for clubs, parties, workout sessions, or background ambiance  Vibe: Uplifting, Groovy, Futuristic",
            "status": "succeeded",
            "style": "electronic,house,techno",
            "title": "Neon Pulse Drive"
        }
    ]
}'

返回响应

🟢200成功
*/*
Body
string 
可选
示例
success
上一页
任务状态查询
下一页
纯音乐生成