文档中心

音视频理解与处理

API接入

歌词生成

歌词生成

注意

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

接口信息：

API：https://open.volcengineapi.com?Action=GenLyrics&Version=2024-08-12

Method：POST

Aciton：GenLyrics

Version：2024-08-12

特别注意：

歌词生成服务属于开通预付费资源包的赠送项(后付费无此赠送项)，如需此服务，烦请告知产品或运营人员需要使用的歌词用量，经审核评估后，予以开通。

请求参数：

Query：

参数
类型
是否必填
参数内容
Action
String
必选
GenLyrics
Version
String
必选
2024-08-12

Body：

参数	类型	参数位置	是否必填	描述
Prompt	String	Body	必选	歌词提示词内容，仅支持中文，小于500个字符。
Genre	String	Body	否	生成歌词的曲风，不传默认走预测，可选: ["Folk", "Pop", "Rock", "Chinese Style", "Hip Hop/Rap", "R&B/Soul", "Punk", "Electronic", "Jazz", "Reggae", "DJ"]
Mood	String	Body	否	生成歌词的风格，不传默认走预测，可选: ["Happy", "Dynamic/Energetic", "Sentimental/Melancholic/Lonely", "Inspirational/Hopeful", "Nostalgic/Memory", "Excited", "Sorrow/Sad", "Chill", "Romantic"]
Gender	String	Body	否	生成歌词的性别，不传默认走预测，可选值：["Female", "Male"]
ModelVersion	String	Body	否	生成歌词使用版本，需要输入参数: ["v4.0"]

请求示例：

Request Body：

{
"Prompt": "关于星空的歌",
"Genre": "R&B/Soul",
"Mood": "Dynamic/Energetic",
"Gender": "Male"
"ModelVersion": "v4.0"
}

Response：

{
"Code": 0,
"Message": "success",
"Result": {
"TaskID": "202408308524910527xxxxxx", // 任务ID
"Lyrics": "[intro]\n[verse]\n繁星闪烁天际\n神秘如谜宇宙无尽奥秘引我探秘\n[chorus]\n抬头仰望星空\n感受深邃宁静\n遥望星际之间\n思索宇宙无穷\n[inst]\n[verse]\n星云变幻神奇\n奇幻迷离银河璀璨熠熠引人入迷\n[chorus]\n流星划过天际\n追寻梦想痕迹\n探索无限可能\n领悟宇宙真谛\n[chorus]\n流星划过天际\n追寻梦想痕迹\n探索无限可能\n领悟宇宙真谛\n[outro]", // 歌词
"Genre": "R&B/Soul",
"Mood": "Dynamic/Energetic",
"Gender": "Male"
},
"ResponseMetadata": {
"RequestId": "02172492414155226050340cd5020003c070b82113f9c524bc84a",
"Action": "GenLyrics",
"Version": "2024-08-12",
"Service": "imagination",
"Region": "cn-beijing",
"Error": null
}
}

curl：

curl --location --request GET 'https://open.volcengineapi.com/?Action=GenLyrics&Version=2024-08-12' \
--header 'Host: open.volcengineapi.com' \#Api Host，详见请求Host说明
--header 'Content-Type: application/json' \
--header 'X-Date: 20251201T103833Z' \ #请求时间戳，详见请求Header X-Date说明
--header 'X-Content-Sha256: ******' \ #对完整请求Body的加密结果，详见请求Header X-Content-Sha256说明
--header 'Authorization: ******' \ #签名信息，详见请求Header Authorization说明
--data-raw '{
"Prompt": "关于星空的歌",
"Genre": "R&B/Soul",
"Mood": "Dynamic/Energetic",
"Gender": "Male",
"ModelVersion": "v4.0"
}

demo：

Golang：

GenLyrics.zip

Java：

GenLyrics.zip

Python：

GenLyrics.zip

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

最近更新时间：2026.06.17 16:45:59

这个页面对您有帮助吗？

有用

有用

无用

无用