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

纯音乐生成回调接口

POST
你的域名/instrumental/callback
您需要自行开发一个回调接口,天谱乐在音乐生成后会回调你的接口进行任务状态通知,处理成功需返回:success。纯音乐一次生成会有两次回调,第一次mp3音频回调,第二次wav音频回调。

请求参数

Body 参数application/json

示例
{
    "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

示例
success
上一页
纯音乐生成
下一页
纯音乐生成任务状态查询