文档中心

音视频理解与处理

API接入

生成人声歌曲

注意

发起请求前，必须在请求中添加公共字段部分的内容。

接口信息：

预付费API：https://open.volcengineapi.com?Action=GenSongV4&Version=2024-08-12

后付费API：https://open.volcengineapi.com?Action=GenSongForTime&Version=2024-08-12

Method：POST

Aciton：预付费：GenSongV4 后付费：GenSongForTime

Version：2024-08-12

请求参数：

Query：

参数
类型
是否必填
参数内容
Action
String
必选
预付费：GenSongV4
后付费：GenSongForTime
Version
String
必选
2024-08-12

Body：

参数	类型	必填
Lyrics	String	否	可选参数：歌词内容，中文支持5到700个字符，英文支持5-2000个字符。支持通过歌词精准生成。 4.0/4.3版本与Prompt二选一，优先级高于Prompt
Prompt	String	否	可选参数：提示词内容，仅支持中文，5到700个字符，英文支持5-2000个字符。支持通过提示词生成歌曲。 4.0/4.3版本与Lyrics二选一
ModelVersion	String	否	可选参数：模型版本，可选值：["v4.0", "v4.3", "v5.0"]目前默认版本为v4.0，后续4.X版本下线后默认值将会修改为5.0
Genre	StringString	否	可选参数：生成歌曲的主曲风，如果不传或者传入空字符串，服务会基于text内容提取或预测genre。 V4.0仅支持传入一个主曲风，新增V4.3最多支持3个主曲风，用逗号分隔。在传入Lyrics且没有指定也没有传入Prompt时，默认为Pop。 V4.0版本模型可选参数：跳转查看 V4.3版本模型可选参数：跳转查看 v5.0不生效
Mood	String	否	生成歌曲的情绪，如果不传或者传入空字符串，服务会基于text内容提取或预测mood。 v4.0仅支持传入一个情绪词，新增v4.3最多支持2个情绪词，用逗号分隔。 V4.0版本模型可选参数：跳转查看 V4.3版本模型可选参数：跳转查看 v5.0不生效
Gender	String	否	生成歌曲的Gender，如果不传或者传入空字符串，服务会基于text内容提取或预测gender 可选参数：["Female", "Male"] v5.0不生效
Timbre	String	否	生成歌曲的音色，如果不传或者传入空字符串，服务会基于text内容提取或预测timbre v4.0仅支持传入一个音色，新增v4.3最多支持3个音色，用逗号分隔。 V4.0版本模型可选参数：跳转查看 V4.3版本模型可选参数：跳转查看 v5.0不生效
Duration	Int	否	可选参数：生成指定音频时长，单位：s，生效范围[30，240]
CallbackURL	String	否	可选参数：配置回调地址后，会在任务完成后，通过http请求回调该地址，回调内容为json格式
SkipCopyCheck	Bool	否	可选参数：歌词版权检测开关 ture，关闭版权检测 false，开启版权检测
TosBucket	String	否	可选参数：用户自定义tos存储桶名称
ImplicitWaterMark	map	否	可选参数：隐私水印
┣ContentProducer	String	否	可选参数：生成合成服务提供者
┣ProduceId	String	否	可选参数：内容制作编号
┣ContentPropagator	String	否	可选参数：内容传播服务提供者
┣PropagateId	String	否	可选参数：内容传播编号
┗Enable	Bool	否	可选参数：启用开关
GenreExtra	String	否	新增v4.3参数，次级曲风，最多支持2个。 V4.3版本模型可选参数：跳转查看 v5.0不生效
Key	String	否	新增v4.3参数，音乐调diào性 V4.3版本模型可选参数：["A", "A#", "B", "C", "C#", "Cb", "D", "D#", "E", "F", "F#", "G", "Ab"] v5.0不生效
Kmode	String	否	新增v4.3参数，音乐调diào式 V4.3版本模型可选参数：跳转查看 v5.0不生效
Tempo	String	否	新增v4.3参数，音乐节拍 V4.3版本模型可选参数：跳转查看 v5.0不生效
Instrument	String	否	新增v4.3参数，音乐配器，最多支持5个， V4.3版本模型可选参数：跳转查看 v5.0不生效
Scene	String	否	新增v4.3参数，音乐场景，最多支持3个 V4.3版本模型可选参数：跳转查看 v5.0不生效
Lang	String	否	新增v4.3/v5.0参数，指定语言,默认值Chinese V4.3版本模型可选参数：跳转查看 V5.0版本模型可选参数：跳转查看
VodFormat	String	否	新增v4.3/v5.0参数，音频格式，默认值为wav V4.3版本模型可选参数：["wav", "mp3"] v5.0版本模型可选参数：["wav", "mp3"]
AigcWatermark	bool	否	显式水印添加默认false

歌词格式说明：

说明

在提交生成歌曲任务时，若是通过传递Lyrics参数生成，此时可以通过标签控制歌词结构。一个完整的歌词结构说明：

前奏：intro，歌曲开始的音乐部分，主要用于引导歌曲的整体氛围。

主歌：verse，通常在前奏之后，歌曲中叙述歌曲故事或主题的部分。

副歌：chorus，一般在主歌之后，旋律有记忆点和感染力，是整首歌的高潮，进一步强化歌曲的主题和情感。

间奏：inst，歌曲中的纯音乐段落，用于连接不同的演唱部分。

尾奏：outro，歌曲结束后的音乐段落，用于营造歌曲结束的氛围。

桥段：bridge，通常出现在歌曲中段或接近结尾处，是一个过渡部分，用于连接不同的歌曲段落。

预副歌：pre-chorus

钩子段落：hook

铺垫：build-up

电子曲风：drop

独奏：solo

例如：

请求示例：

Request Body：

{
"Lyrics": "",
"Prompt":"关于星空的歌",
"ModelVersion": "v4.3",
"Genre": "Electronic",
"Mood":"Groovy/Funky",
"Gender": "Male",
"Timbre": "",
"Duration": 0,
"CallbackURL": "",
"SkipCopyCheck": false,
"TosBucket": "",
"ImplicitWaterMark":{
"ContentProducer":"火山引擎",
"ProduceId":"volc001",
"ContentPropagator":"传播者1",
"PropagateId":"company001",
"Enable":true
},
"GenreExtra": "Metal,City Pop" ,
"Key": "A#" ,
"Kmode": "Minor" ,
"Tempo": "Grave" ,
"Instrument": "Saxophone,Guitar,Synthesizers" ,
"Scene": "Danceable,Funeral,Winter",
"Lang": "Chinese",
"VodFormat": "mp3"
}

Response：

{
"Code": 0,
"Message": "success",
"Result": {
"TaskID": "202408308513817850019840", // 任务ID
"PredictedWaitTime": 0 // 预计等待时间（单位秒）
},
"ResponseMetadata": {
"RequestId": "02172491885215426050340cd5020003c070b82113f9c52acdbc4",
"Action": "GenSongForTime",
"Version": "2024-08-12",
"Service": "imagination",
"Region": "cn-beijing",
"Error": null
}
}

curl：

demo：

Golang：

GenSong.zip

GenSongForTime.zip

Java：

GenSong.zip

GenSongForTime.zip

Python：

GenSong.zip

GenSongForTime.zip

注：未提供demo的编程语言，烦请根据文档说明和参照curl示例、已有语言demo示例自行编写。

最近更新时间：2026.07.24 18:06:34

这个页面对您有帮助吗？

有用

无用

参数	类型	是否必填	参数内容
Action	String	必选	预付费：GenSongV4 后付费：GenSongForTime
Version	String	必选	2024-08-12