音乐生成

POST

/open-apis/v1/song/generate

支持用户自定义上传音乐描述和歌词，然后生成歌曲。

请求参数

Header 参数

Authorization

string

API密钥

必需

示例值:

Tempo-********************************-3w

Content-Type

string

必需

示例值:

application/json; charset=utf-8

Body 参数application/json

prompt

string

必需

通过输入提示词控制纯音乐的生成。

lyrics

string | null

可选

若上传为空，会自动调用歌词生成模型

model

string

要使用的模型。

必需

voice_id

string | null

可选

输入官方歌手id即可指定歌手，使用对应声音生成歌曲

callback_url

string

必需

任务生成成功后的回调地址，需要合作方自行开发，任务完成后调用通知。

示例

{
    "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic ",
    "model": "TemPolor v3.5",
    "callback_url": "https://**************/callback"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open-apis/v1/song/generate' \
--header 'Authorization: Tempo-********************************-3w' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "prompt": "Genre: Electronic Dance Music (EDM), House, Techno  Style: Instrumental, Beat-driven, Club-oriented  Mood: Energetic, Vibrant, Hypnotic ",
    "model": "TemPolor v3.5",
    "callback_url": "https://**************/callback"
}'

返回响应

🟢200成功

application/json

Body

status

integer

响应状态码

必需

message

string

响应结果说明

必需

request_id

string

必需

本次请求的唯一ID、可用于联系客服排查问题等

data

object

具体的返回结果

必需

item_ids

array[string]

必需

提交任务生成的作品id列表

示例

{
    "status": 200000,
    "message": "success",
    "request_id": "b072a68c-4c1b-41be-bdd1-0a0309754de7",
    "data": {
        "item_ids": [
            "123"
        ]
    }
}

音乐回调接口

任务状态查询