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

歌词回调接口

POST
/你的域名/lyrics/callback
自行开发的回调接口,用于生成完成的回调,请求成功需返回:success。

请求参数

Body 参数application/json
lyrics
array [object {4}] 
作品信息列表
必需
item_id
string 
作品id
可选
status
string 
可选
状态 succeeded-生成完成 waiting-等待中 running-生成中 failed-失败
title
string 
标题
可选
lyric
string 
可选
示例
{
    "lyrics": [
        {
            "item_id": "123",
            "status": "succeeded",
            "title": "月光诉语",
            "lyric": "[Intro]\n\n[Verse]\n月光穿过了重重云层轻轻洒落在你的发梢\n夜晚的街道没有归人只有我和影子漫长寂寞\n思绪像风一样游走不定每一刻都在等待醒悟\n星空下藏着我们未说的话安静得让人心动\n\n[Verse]\n街角的灯光映照着回忆像一场未完的电影\n月亮挂在天边像眼睛看尽孤独与梦想的交替\n风吹过记忆的街道那温柔的触感仍在心底\n时间悄无声息地走过把一切留给夜色阑珊\n\n[Inst]\n\n[Chorus]\n月亮是夜的诗句柔柔地诉说无声的誓言\n孤独的光辉映照着远方梦里的模样清晰\n在这沉默的时刻我悄悄把思念放飞天空\n让它随星光飘散融入那无边的黑夜\n\n[Chorus]\n转身看那苍穹依旧静静守护我们的秘密\n月色流淌是温柔的指引穿越深深的暗夜\n我和你之间没有距离只有心跳交织的时光\n让这份感动在风中轻轻地回荡\n\n[Inst]"
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/你的域名/lyrics/callback' \
--header 'Content-Type: application/json' \
--data-raw '{
    "lyrics": [
        {
            "item_id": "123",
            "status": "succeeded",
            "title": "月光诉语",
            "lyric": "[Intro]\n\n[Verse]\n月光穿过了重重云层轻轻洒落在你的发梢\n夜晚的街道没有归人只有我和影子漫长寂寞\n思绪像风一样游走不定每一刻都在等待醒悟\n星空下藏着我们未说的话安静得让人心动\n\n[Verse]\n街角的灯光映照着回忆像一场未完的电影\n月亮挂在天边像眼睛看尽孤独与梦想的交替\n风吹过记忆的街道那温柔的触感仍在心底\n时间悄无声息地走过把一切留给夜色阑珊\n\n[Inst]\n\n[Chorus]\n月亮是夜的诗句柔柔地诉说无声的誓言\n孤独的光辉映照着远方梦里的模样清晰\n在这沉默的时刻我悄悄把思念放飞天空\n让它随星光飘散融入那无边的黑夜\n\n[Chorus]\n转身看那苍穹依旧静静守护我们的秘密\n月色流淌是温柔的指引穿越深深的暗夜\n我和你之间没有距离只有心跳交织的时光\n让这份感动在风中轻轻地回荡\n\n[Inst]"
        }
    ]
}'

返回响应

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