注意

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

## 接口信息： * **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：** ```JSON { "Prompt": "关于星空的歌", "Genre": "R&B/Soul", "Mood": "Dynamic/Energetic", "Gender": "Male" "ModelVersion": "v4.0" } ``` * **Response：** ```JSON { "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： ```Bash 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示例自行编写。

音视频理解与处理