lyrics_gen_song 工具、gen_song 工具：均采用生成人声歌曲standard API，用于创作人声歌曲。两者的区别在于 lyrics_gen_song 工具提供 Lyrics 参数，能够根据输入的中英文歌词精准生成完整的歌曲，而 gen_song 工具提供 Prompt 参数，支持通过中文提示词来确定歌词主题，进而生成歌词。
gen_bgm 工具：采用生成纯音乐 API，用于创作纯音乐。

使用限制

扣子主账号内所有子账号共享Doubao-音乐生成插件的并发限制，其值为 2。

计费说明

Doubao-音乐生成插件根据生成音乐的时长计费，对应的计费项及单价请参考插件费用。

说明

Doubao-音乐生成插件内包含多个工具，调用这些工具的次数将共同计入该插件的免费额度。

gen_song 工具

gen_song 工具支持根据提示词生成一首特定风格或主题的歌曲。

配置说明

在调用 gen_song 工具时，必须传入 Prompt 参数，用于指定歌曲内容、情感或主题的提示词。此外，为了支持更精细化的生成需求，可按需设置 Gender（演唱者性别）、Genre（曲风）、Mood（情感风格）、Timbre（音色）、Duration（时长）等可选参数。

输入参数

输入参数说明如下表所示：

参数	说明
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。

输出参数

输出参数说明如下表所示：

参数	说明
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 工具

gen_bgm 工具可以根据你指定的灵感提示词、曲风、乐器等信息，快速生成一首专属的纯音乐作品。

配置说明

在调用 gen_bgm 工具时，必须传入 Text 参数和 Duration 参数，用于指定歌曲情感或主题的提示词和歌曲长度。此外，为了支持更精细化的生成需求，可按需设置 Genre（曲风）、Mood（情感风格）、Instrument（乐器）、Theme （主题）等可选参数。

输入参数

输入参数说明如下表所示：

参数	说明
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。

输出参数

输出参数说明如下表所示：

参数	说明
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 工具

lyrics_gen_song 工具能够根据输入的歌词生成一首特定风格或主题的歌曲。

配置说明

在调用 lyrics_gen_song 工具时，必须传入 Lyrics 参数，用于指定歌词内容。此外，为了支持更精细化的生成需求，可按需设置 Gender（演唱者性别）、Genre（曲风）、Mood（情感风格）、Timbre（音色）、Duration（时长）等可选参数。

输入参数

输入参数说明如下表所示：

参数	说明
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。

输出参数

输出参数说明如下表所示：

参数	说明
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