> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

[Doubao-音乐生成插件](https://www.coze.cn/store/plugin/7516841065287041039?from=add_plugin_menu)搭载了 AI 音乐生成大模型，支持根据输入的灵感提示词，创作人声歌曲和纯音乐，支持选择曲风、情绪，支持中英文，生成的歌曲听感自然、和谐，音质出色。
Doubao-音乐生成插件包含 lyrics_gen_song 工具、gen_song 工具和 gen_bgm 工具。

* lyrics_gen_song 工具、gen_song 工具：均采用[生成人声歌曲standard](https://www.volcengine.com/docs/84992/1535145) API，用于创作人声歌曲。两者的区别在于 lyrics_gen_song 工具提供 `Lyrics` 参数，能够根据输入的中英文歌词精准生成完整的歌曲，而 gen_song 工具提供 `Prompt` 参数，支持通过中文提示词来确定歌词主题，进而生成歌词。
* gen_bgm 工具：采用[生成纯音乐](https://www.volcengine.com/docs/84992/1535146) API，用于创作纯音乐。

## 使用限制 {#24f7d61e}
扣子主账号内所有子账号共享**Doubao-音乐生成插件**的并发限制，其值为 2。
## 计费说明 {#47ab3934}
Doubao-音乐生成插件根据生成音乐的时长计费，对应的计费项及单价请参考[插件费用](/coze_pro/plugin_fee)。
:::tip 说明
Doubao-音乐生成插件内包含多个工具，调用这些工具的次数将共同计入该插件的免费额度。
:::
## gen_song 工具 {#f6d12714}
gen_song 工具支持根据提示词生成一首特定风格或主题的歌曲。
### 配置说明 {#6816d2b0}
在调用 gen_song 工具时，必须传入 `Prompt` 参数，用于指定歌曲内容、情感或主题的提示词。此外，为了支持更精细化的生成需求，可按需设置 `Gender`（演唱者性别）、`Genre`（曲风）、`Mood`（情感风格）、`Timbre`（音色）、`Duration`（时长）等可选参数。
#### 输入参数 {#1192c1d5}
输入参数说明如下表所示：
<!-- @cols-width: 173,666 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|Prompt |输入灵感提示词，默认值：`关于星空的歌`。 |\
| | |\
| |* 仅支持输入中文。 |\
| |* 长度为 5～700 个字符。 |
| | | \
|Gender |设置演唱者性别，影响生成歌曲的声音特征。可选值： |\
| | |\
| |* Male（默认值）：男声。 |\
| |* Female：女声。 |
| | | \
|Genre |设置歌曲的曲风，决定生成歌曲的音乐风格。 |\
| |可选值：Folk、Pop、Rock、Chinese Style、Hip Hop/Rap、R&B/Soul、Punk、Electronic、Jazz、Reggae、DJ。默认值：R&B/Soul。 |
| | | \
|Mood |设置歌曲的情感风格，影响旋律和编曲的情绪表达。 |\
| |可选值：Happy、Dynamic/Energetic、Sentimental/Melancholic/Lonely、Inspirational/Hopeful、Nostalgic/Memory、Excited、Sorrow/Sad、Chill、Romantic。 |
| | | \
|Timbre |设置歌曲的音色。如果不设置或者设置为空字符串，工具会基于提示词内容提取或预测音色。 |\
| |可选值：Warm、Bright、Husky、Electrified voice、Sweet_AUDIO_TIMBRE、Cute_AUDIO_TIMBRE、Loud and sonorous、Powerful、Sexy/Lazy。 |
| | | \
|Duration |设置歌曲的时长，单位：秒，取值范围为 30～240。 |

#### 输出参数 {#c157c23b}
输出参数说明如下表所示：
<!-- @cols-width: 234,672 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|code |执行插件时的状态码。 |
| | | \
|msg |执行插件时的状态描述或错误提示信息。 |
| | | \
|log_id |日志 ID。 |
| | | \
|data.FailureReason.Code |生成失败的错误码。 |
| | | \
|data.FailureReason.Msg |生成失败的错误信息。 |
| | | \
|data.SongDetail.Theme |歌曲的主题列表。 |
| | | \
|data.SongDetail.Mood |歌曲的情感风格。 |
| | | \
|data.SongDetail.Duration |歌曲的时长。 |
| | | \
|data.SongDetail.Prompt |歌词的灵感提示词。 |
| | | \
|data.SongDetail.Instrument |歌曲使用的乐器。 |
| | | \
|data.SongDetail.AudioUrl |歌曲的URL，URL 有效期为 1 年，请及时转存。 |
| | | \
|data.SongDetail.Captions |歌曲的文本字幕。 |
| | | \
|data.SongDetail.Lyrics |歌曲的歌词。 |
| | | \
|data.Status |任务状态。 |
| | | \
|data.TaskID |任务 ID。 |

## gen_bgm 工具 {#f8c8103c}
gen_bgm 工具可以根据你指定的灵感提示词、曲风、乐器等信息，快速生成一首专属的纯音乐作品。
### 配置说明 {#3e234eca}
在调用 gen_bgm 工具时，必须传入 `Text` 参数和 `Duration` 参数，用于指定歌曲情感或主题的提示词和歌曲长度。此外，为了支持更精细化的生成需求，可按需设置 `Genre`（曲风）、`Mood`（情感风格）、`Instrument`（乐器）、`Theme` （主题）等可选参数。
#### 输入参数 {#f3e5f137}
输入参数说明如下表所示：
<!-- @cols-width: 173,666 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|Text |歌曲提示词，默认值：`关于星空的背景纯音乐`。 |\
| | |\
| |* 仅支持输入中文。 |\
| |* 长度小于 500 个字符。 |
| | | \
|Genre |设置歌曲的曲风，决定生成歌曲的音乐风格。 |\
| |可选值：corporate、dance/edm、orchestral、chill out、rock、hip hop、folk、funk、ambient、holiday、jazz、kids、world、travel、commercial、advertising、driving、cinematic、upbeat、epic、inspiring、business、video game、dark、pop、trailer、modern、electronic、documentary、soundtrack、fashion、acoustic、movie、tv、high tech、industrial。 |
| | | \
|Mood |设置歌曲的情感风格，影响旋律和编曲的情绪表达。 |\
| |可选值：positive、uplifting、energetic、happy、bright、optimistic、hopeful、cool、dreamy、fun、light、powerful、calm、confident、joyful、dramatic、peaceful、playful、soft、groovy、reflective、easy、relaxed、lively、smooth、romantic、intense、elegant、mellow、emotional、sentimental、cheerful happy、contemplative。 |
| | | \
|Instrument |设置歌曲使用的乐器。 |\
| |可选值：piano、drums、guitar、percussion、synth、electric guitar、acoustic guitar、bass guitar、brass、violin、cello、flute、organ、trumpet、ukulele、saxophone、double bass、harp、glockenspiel、synthesizer、keyboard、marimba、bass、banjo、strings。 |
| | | \
|Theme |设置歌曲的主题列表。 |\
| |可选值：inspirational、motivational、achievement、discovery、every day、love、technology、lifestyle、journey、meditation、drama、children、hope、fantasy、holiday、health、family、real estate、media、kids、science、education、progress、world、vacation、training、christmas、sales。 |
| | | \
|Duration |设置歌曲的时长，单位：秒，取值范围为 30～120。 |

#### 输出参数 {#cbcbd31e}
输出参数说明如下表所示：
<!-- @cols-width: 195,672 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|code |执行插件时的状态码。 |
| | | \
|msg |执行插件时的状态描述或错误提示信息。 |
| | | \
|log_id |日志 ID。 |
| | | \
|data.TaskID |任务 ID。 |
| | | \
|data.Status |任务状态。 |
| | | \
|data.Progress |任务进度。 |
| | | \
|data.FailureReason.Code |生成失败的错误码。 |
| | | \
|data.FailureReason.Msg |生成失败的错误信息。 |
| | | \
|data.SongDetail.Theme |歌曲的主题。 |
| | | \
|data.SongDetail.Instrument |歌曲使用的乐器。 |
| | | \
|data.SongDetail.Captions |歌曲的文本字幕，固定为空值。 |
| | | \
|data.SongDetail.Lyrics |歌曲的歌词，固定为空值。 |
| | | \
|data.SongDetail.Duration |歌曲的时长。 |
| | | \
|data.SongDetail.Prompt |歌曲的灵感提示词。 |
| | | \
|data.SongDetail.Mood |歌曲的情感风格。 |
| | | \
|data.SongDetail.Genre |歌曲的曲风。 |
| | | \
|data.SongDetail.AudioUrl |歌曲的 URL，URL 有效期为 1 年，请及时转存。 |

## lyrics_gen_song 工具 {#ed80ac9c}
lyrics_gen_song 工具能够根据输入的歌词生成一首特定风格或主题的歌曲。
### 配置说明 {#f667de29}
在调用 lyrics_gen_song 工具时，必须传入 `Lyrics` 参数，用于指定歌词内容。此外，为了支持更精细化的生成需求，可按需设置 `Gender`（演唱者性别）、`Genre`（曲风）、`Mood`（情感风格）、`Timbre`（音色）、`Duration`（时长）等可选参数。
#### 输入参数 {#efbae27f}
输入参数说明如下表所示：
<!-- @cols-width: 173,666 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|Lyrics |歌词内容，能够根据输入的歌词内容精准生成完整的歌曲。 |\
| |支持中文和英文文本： |\
| | |\
| |* 中文文本长度为 5～700 字符。 |\
| |* 英文文本长度为 5～2000 字符。 |
| | | \
|Duration |设置歌曲的时长，单位：秒，取值范围为 30～240。 |
| | | \
|Gender |设置演唱者性别，影响生成歌曲的声音特征。可选值： |\
| | |\
| |* Male（默认值）：男声。 |\
| |* Female：女声。 |
| | | \
|Genre |设置歌曲的曲风，决定生成歌曲的音乐风格。 |\
| |可选值：Folk、Pop、Rock、Chinese Style、Hip Hop/Rap、R&B/Soul、Punk、Electronic、Jazz、Reggae、DJ。默认值：R&B/Soul。 |
| | | \
|Mood |设置歌曲的情感风格，影响旋律和编曲的情绪表达。 |\
| |可选值：Happy、Dynamic/Energetic、Sentimental/Melancholic/Lonely、Inspirational/Hopeful、Nostalgic/Memory、Excited、Sorrow/Sad、Chill、Romantic。 |
| | | \
|Timbre |设置歌曲的音色。如果不设置或者设置为空字符串，工具会基于提示词内容提取或预测音色。 |\
| |可选值：Warm、Bright、Husky、Electrified voice、Sweet_AUDIO_TIMBRE、Cute_AUDIO_TIMBRE、Loud and sonorous、Powerful、Sexy/Lazy。 |

#### 输出参数 {#16f58634}
输出参数说明如下表所示：
<!-- @cols-width: 234,672 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|code |执行插件时的状态码。 |
| | | \
|msg |执行插件时的状态描述或错误提示信息。 |
| | | \
|log_id |日志 ID。 |
| | | \
|data.FailureReason.Code |生成失败的错误码。 |
| | | \
|data.FailureReason.Msg |生成失败的错误信息。 |
| | | \
|data.SongDetail.Lyrics |歌曲的歌词。 |
| | | \
|data.SongDetail.Mood |歌曲的情感风格。 |
| | | \
|data.SongDetail.Theme |歌曲的主题列表。 |
| | | \
|data.SongDetail.AudioUrl |歌曲的URL，URL 有效期为 1 年，请及时转存。 |
| | | \
|data.SongDetail.Captions |歌曲的文本字幕。 |
| | | \
|data.SongDetail.Duration |歌曲的时长。 |
| | | \
|data.SongDetail.Genre |歌曲的曲风。 |
| | | \
|data.Status |任务状态。 |
| | | \
|data.TaskID |任务 ID。 |



> * Doubao-音乐生成插件 ID：7516841765194743843