# 公共字段 **前置步骤：** 接入之前，请先阅读（[控制台开通服务指南](https://www.volcengine.com/docs/84992/1404662)和[API快速接入指南](https://www.volcengine.com/docs/84992/1404668)），并确定已在控制台上开通服务及完成策略授权 1.**请求Host: ** **https://open.volcengineapi.com** 2.**请求Header** > 描述：http请求中header需增加的字段 |参数名 |参数类型 |是否必填 |描述 | |---|---|---|---| |Host |String |是 |[open.volcengineapi.com](http://open.volcengineapi.com) | |X\-Date |String |是 |使用UTC时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z' ，例如：20201103T104027Z | |Authorization |String |是 |HMAC\-SHA256 Credential={AccessKeyId}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}|\ | | | |签名完整过程详见：[签名示例](https://www.volcengine.com/docs/6369/67269) | |Content\-Type |String |是 |MIME类型，固定值： application/json | |X\-Content\-Sha256 |String |否 |对完整请求Body的加密结果，HexEncode(Hash(RequestPayload))HexEncodeHexEncode代指转16进制编码|\ | | | |Hash代指SHA256算法|\ | | | |RequestPayload代指完整的请求的body。 | **Authorization中的信息含义：** |名称 |类型 |备注 | |---|---|---| |AccessKeyId |String |请求的AccessKey。|\ | | | |\ | | |AK/SK获取说明，参考：https://www.volcengine.com/docs/84992/1404668|\ | | |说明：在调用火山引擎音乐openapi的各个能力之前，确保您已生成访问密钥（AccessKey）。AccessKey包括AccessKeyID（AK）和AccessKeySecret（SK），其中AccessKeyID用于标识用户，AccessKeySecret是用来验证用户的密钥，请妥善保管。|\ | | |获取方式：点击右上角账号，下拉列表选择【密钥管理】，点击【新建密钥】按钮，可获取AK/SK，可以此为凭证调用上述已接入应用的接口。注：安全起见，建议新建子账户，并使用子账户的AK/SK | |ShortDate |String |请求的短时间，使用UTC时间，精确到日。请使用格式：YYYYMMDD，例如：20221101 | |Region |String |请求的地域，固定值： cn\-beijing | |Service |String |请求的服务，固定值：imagination | |SignedHeaders |String |参与签名的Header，用分号分隔。 | |Signature |String |计算完毕的签名。 | # HTTP接口详情 1. ## **GenBGM** 描述：创建生成纯音乐任务 Method: POST 请求URL：[https://open.volcengineapi.com?Action=GenBGM&Version=2024-08-12](https://open.volcengineapi.com?Action=GenBGM&Version=2024-08-12) 请求参数： **++请注意v5.0版本不再需要Genre、Mood、Instrument、Theme传参数++** ++，您可以直接在Text中描述预期生成的效果++ |参数 |类型 |**参数位置** |是否必填 |适用模型版本 |描述 | |---|---|---|---|---|---| |Text |String |Body |是 |全部 |必填，输入文本 | |TosBucket |Sting |Body |否 |全部 |选填，用户自定义火山tos桶名称。|\ | | | | | |可参考[tos开通文档](https://www.volcengine.com/docs/84992/1521764)完成相关操作 | |CallbackURL |String |Body |否 |全部 |回调地址，可选。配置回调地址后，会在任务完成后，通过http请求回调该地址，回调内容为json格式 | |Duration |Int |Body |否 |全部 |音频时长，默认值为60s|\ | | | | | |~~v4.0版本时：有效时长范围为[1,60] （已废弃）~~ |\ | | | | | |v5.0版本时：有效时长范围为[30,120]，优先级从高到低遵循“Segments中的Duration总和 \> Text中指定的时长 \> 最外层的Duration参数” | |EnableInputRewrite |Bool |Body |否 |全部 |是否使用模型去做输入prompt的改写，默认为false | |Segments |list[map]] |Body |否 |v5.0 |**选填，可指定BGM的结构**|\ | | | | | |注意：仅v5.0生效，v4.0不生效 | | Duration |Int |Body |\- |v5.0 |**生成音乐的时长 (秒)；优先级从高到低遵循“Segments中的Duration总和 \> Text中指定的时长 \> 最外层的Duration参数”** |\ | | | | | |**Segments存在时值必填**|\ | | | | | ||\ | | | | | |1. 支持传入多组Duration参数，每单个Duration时长有效范围是[5,120]|\ | | | | | |2. 当仅有一个Duration参数，时长有效范围时[30,120]|\ | | | | | |3. Segments中所有的Duration之和的有效范围是[30,120]|\ | | | | | ||\ | | | | | | |\ | | | | | |举例：text指定50s，外层Duration为60s，Segments中Duration全部累加后为40s，最终成曲时长为40s | | Name |string |Body |\- |v5.0 |**Segments存在时值必填**|\ | | | | | |bgm结构类型枚举值：intro, verse, chorus, inst, bridge, outro,分别对应前奏，主歌，副歌，间奏，桥段，尾奏 | |Version |string |Body |否 |全部 |当前默认为v5.0版本的参数，则此处必须填写v5.0该参数必写。|\ | | | | | |注意：**==当前已全部升级为v5.0==** | |ImplicitWaterMark |map |Body |否 |v5.0 |隐私水印 | | ContentProducer |String |Body |否 |v5.0 |生成合成服务提供者 | | ProduceId |String |Body |否 |v5.0 |内容制作编号 | | ContentPropagator |String |Body |否 |v5.0 |内容传播服务提供者 | | PropagateId |String |Body |否 |v5.0 |内容传播编号 | | Enable |Bool |Body |否 |v5.0 |启用开关 | **注意：入参简单的30s短音乐容易触发版权校验（错误码code:50000001），建议通过丰富text、增加参数数量、延长生成音乐时长等手段进行规避。** 请求Body参数示例（v5.0），不传Segments字段 ```JSON { "Text": "关于星空的背景纯音乐,时长80秒，乐器为钢琴加吉他", "Duration": 45, "TosBucket": "", "CallbackURL": "", "EnableInputRewrite": false, "Version": "v5.0" } ``` 请求Body参数示例（v5.0），传入Segments字段控制生成音乐的结构 ```JSON { "Text": "咖啡馆里的音乐，歌词：天青色等烟雨，而我在等你，炊烟袅袅升起，隔江千万里", "Version": "v5.0", "Duration": 90, "Segments": [ { "Name": "verse", "Duration": 20 }, { "Name": "chorus", "Duration": 20 } ], "TosBucket": "", "CallbackURL": "", "EnableInputRewrite": false } ``` ## **2.QuerySong** 描述：通过任务ID查询生成生成纯音乐结果 Method: POST 请求URL：https://open.volcengineapi.com?Action=QuerySong&Version=2024\-08\-12 请求参数 |参数 |类型 |**参数位置** |是否必填 |描述 | |---|---|---|---|---| |TaskID |String |Body |是 |任务ID | 请求Body参数示例 ```JSON { "TaskID": "202408308513817850019840" } ``` 返回示例 |参数 |类型 |描述 | |---|---|---| |StyleInfo |String（json） |仅V5.0版本返回|\ | | |包含最终生成音乐的信息，业务侧可自行解析获取 | |Duration |Int |生成音乐的时长 | |AudioUrl |String |生成音频url | **注意：默认提供wav音频文件（因视频云链路有默认转码逻辑，可能出现mp4等格式情况），该url仅供参考您转存使用、请勿直接用在应用中，您需要拿到url后自行做转存并转化成您预期的音频格式，url有效期为1年。** ```JSON { "Code": 0, "Message": "success", "Result": { "TaskID": "202408308513817850019840", "Status": 3, // 任务状态 0->等待中, 1->处理中, 2->成功, 3->失败 "Progress": 100, // 生成进度 "FailureReason": { // 任务失败原因，任务执行成功时为null "Code": 300061, "Msg": "InputLyricsPlagiarized" }, "SongDetail": { "AudioUrl": "xxxxx", // 音频地址 URL域名规则：v{1-50}-default.douyinvod.com "Prompt": "xxxxxxx", // 生成纯音乐的提示词 "Duration": 46.0024375, // 音频时长，单位秒（关联后付费按时长计费） "CallbackURL":"",//回调地址 "Theme":"",//主题 v5.0返回的此参数无实际意义 "Instrument":"",//乐器 v5.0返回的此参数无实际意义 "Mood":"", //情绪 v5.0返回的此参数无实际意义 "Genre":"", //曲风 v5.0返回的此参数无实际意义 "TosPath":"", //用户自定义的tos保存路径 "StyleInfo":"{\"style_tags\":{\"genre\":[\"Easy Listening\"],\"genre_extra\":[\"Easy Listening\"],\"extra\":[\"non-canned music\"],\"mood\":[\"Romantic\"],\"scene\":[\"Flirt\",\"Coffee Shop\",\"Dating\",\"Love\",\"Valentine's day\"],\"speaker\":[\"nonvocal nongender\"],\"voice\":[\"nonvocal nontimbre\"],\"lang\":[\"Instrumental/Non-vocal\"],\"sinking\":[\"non-Sinking\"],\"instrument\":[\"Acoustic_Guitar\",\"Drums\",\"Percussion\",\"Percussive\",\"Strings\",\"Guitar\",\"nonvocal\"],\"tempo\":[\"empty tempo\"],\"mode\":[\"empty mode\"],\"key\":[\"empty key\"]},\"speaker_id\":38,\"duration\":40,\"freeform_text\":\"Drums, Love, non-canned music, romantic music, loving, acoustic guitar, Coffee Shop, Acoustic Guitar, sultry, acoustic, soft, Washboard, Guitar, peaceful, Percussive, Easy Listening, Riq or Rik, Flirt, Loving, affectionate, Percussion, seductive, relaxed, Military Drums, beautiful, Talking Drums, Strings, alluring, Romantic, Req, romantic, calm, gentle, Valentine's day, Dating\",\"lyrics_display\":\"[verse]\<20.00\>\\n[chorus]\<20.00\>\"}" // StyleInfo 信息展示如下 v5.0才会返回StyleInfo： // { // "style_tags": { // 音频风格信息 // "genre": ["Easy Listening"], // "genre_extra": ["Easy Listening"], // "extra": ["non-canned music"], // "mood": ["Romantic"], // "scene": ["Flirt", "Coffee Shop", "Dating", "Love", "Valentine's day"], // "speaker": ["nonvocal nongender"], // "voice": ["nonvocal nontimbre"], // "lang": ["Instrumental/Non-vocal"], // "sinking": ["non-Sinking"], // "instrument": ["Acoustic_Guitar", "Drums", "Percussion", "Percussive", "Strings", "Guitar", "nonvocal"], // "tempo": ["empty tempo"], // "mode": ["empty mode"], // "key": ["empty key"] // }, // "speaker_id": 38, // "duration": 40, // 生成的音乐时长 // "freeform_text": "Drums, Love, non-canned music, romantic music, loving, acoustic guitar, Coffee Shop, Acoustic Guitar, sultry, acoustic, soft, Washboard, Guitar, peaceful, Percussive, Easy Listening, Riq or Rik, Flirt, Loving, affectionate, Percussion, seductive, relaxed, Military Drums, beautiful, Talking Drums, Strings, alluring, Romantic, Req, romantic, calm, gentle, Valentine's day, Dating", // "lyrics_display": "[verse]<20.00>\n[chorus]<20.00>" // 各段结构时长 // } } }, "ResponseMetadata": { "RequestId": "02172492501059326050340cd5020003c070b82113f9c52a42fa4", "Action": "QuerySong", "Version": "2024-08-12", "Service": "imagination", "Region": "cn-beijing", "Error": null } } ``` 2. ## QueryUsage **注意：预付费出账有Day+1延迟，如您需要获取资源包的实时用量，可使用本接口查询** 描述：用量查询（实时） Method: GET 请求URL：https://open.volcengineapi.com?Action=QueryUsage&Version=2024\-08\-12 请求参数：无返回参数 ```JSON { "Code": 0, "Message": "Success", "Result": { "Data": [ { "Stauts": 1, // 授权状态 1-正式，2-试用 "StartTime": 1726738015, // 授权开始时间 "EndTime": 1758274015, // 授权结束时间 "MusicQuota": 10000, // 音乐额度 "MusicUsed": 26, // 音乐用量 "LyricsQuota": 0, // 歌词额度 "LyricsUsed": 0, // 歌词用量 "ProductName": "BigMusicBGM" // 产品名称 } ] }, "ResponseMetadata": { "RequestId": "202411251458209246F74FE96835873BE2", "Action": "QueryUsage", "Version": "2024-08-12", "Service": "imagination", "Region": "cn-beijing", "Error": null } } ``` # 可选参数说明 ## V5可用参数您可在text中输入以下参数，生成预期音乐；以下为常见音乐类型，您可以下载参数表格到本地获取全部可用参数。 ### 曲风 |

||||||||\ |V5\-曲风

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |Pop |流行乐 |Electropop |电子流行乐 |Trap Rap |陷阱说唱 |Synthwave |合成器浪潮音乐 | |Electronic |电子乐 |EDM |电子舞曲 |Post\-Rock |后摇滚 |IDM |智能舞曲 | |Score |配乐 |Funk |放克音乐 |Reggae |雷鬼乐 |DJ |打碟音乐 | |Rock |摇滚乐 |Folk |民谣 |Chinoiserie Electronic |中国风电子乐 |Hardcore |硬核音乐 | |Easy Listening |轻松聆听音乐 |Chinese Pop |中文流行乐 |Drum&Bass |鼓打贝斯 |Folk Pop |民谣流行乐 | |Jazz |爵士乐 |Synth Pop |合成器流行乐 |Contemporary R&B |当代 R&B |8 Bit |8 比特音乐 | |Country |乡村音乐 |Hard Rock |硬摇滚 |Bossa Nova |波萨诺瓦 |Cool Jazz |冷爵士 | |Epic |史诗音乐 |Ambient |氛围音乐 |Punk |朋克乐 |Swing |摇摆乐 | |Hip Hop |嘻哈乐 |Alternative/Indie |另类 / 独立音乐 |Childhood |童年风格音乐 |R&B Rap |R&B 说唱 | |R&B/Soul |R&B / 灵魂乐 |Techno |高科技舞曲 |EDM Trap |电子舞曲陷阱乐 |Boombap |砰砰说唱 | |Chinese Style |中国风 |Chill Beats |舒缓节拍音乐 |Jazz Hip Hop |爵士嘻哈 |Trip Hop |神游舞曲 | |World Music |世界音乐 |Country Pop |乡村流行乐 |Dubstep |回响贝斯 |Contemporary classical music |当代古典音乐 | |House |浩室音乐 |Dance Pop |舞蹈流行乐 |Rock Blues |摇滚蓝调 |Pop Punk |流行朋克 | |Pop Rock |流行摇滚 |Trance |迷幻舞曲 |Future Bass |未来贝斯 |Devotional |宗教音乐 | |Latin |拉丁音乐 |China\-Wave |中国浪潮音乐 |Downtempo |慢拍音乐 |Romantic music |浪漫主义音乐 | |Classical |古典音乐 |Jazz Fusion |融合爵士乐 |Worldbeat |世界节拍音乐 |Disco |迪斯科 | |Chinese Tradition |中国传统音乐 |New Age |新世纪音乐 |Latin Pop |拉丁流行乐 |Phonk |放克电子乐 | |Blues |蓝调 |J Rock |日本摇滚 |Other |其他 |Pop Rap |流行说唱 | |GuFeng Music |古风音乐 |Indie Rock |独立摇滚 |Country Rock |乡村摇滚 |Flamenco |弗拉门戈 | |Metal |金属乐 |Chillout |弛放音乐 |Deep Pop Edm |深度流行电子舞曲 |Country Blues |乡村蓝调 | |Chinese Traditional Instrumental Music |中国传统器乐音乐 |Alternative Rock |另类摇滚 |Hardstyle |硬派风格音乐 |Future House |未来浩室音乐 | |Chinese Ballad Pop |中国民谣流行乐 |Jazz Pop |爵士流行乐 |Indie Pop |独立流行乐 |Breakbeat |碎拍音乐 | ### 心情 |

||||||||\ |V5\-心情

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |活力四射 |Dynamic/Energetic |平静 / 放松 |Calm/Relaxing |多愁善感 / 忧郁 / 孤独 |Sentimental/Melancholic/Lonely |酷炫 / 有型 |Cool/Swag | |鼓舞人心 / 充满希望 |Inspirational/Hopeful |浪漫 |Romantic |有趣 |Funny |优雅 / 精致 |Elegant/Sophisticated | |悠闲惬意 |Chill |思念 |Miss |怪异 |Weird |感人 |Moving | |时髦动感 |Groovy/Funky |神秘 |Mysterious |可爱 / 俏皮 |Cute/Playful |自信 / 坚定 |Confident/Determined | |兴奋 |Excited |悲伤 |Sorrow/Sad |愤怒 / 有攻击性 |Angry/Aggressive |神奇 / 童话般 |Magical/Fairytale | |快乐 |Happy |梦幻 / 空灵 |Dreamy/Ethereal |抒情 / 民谣风格 |Lyrical/Ballad |温暖 / 友善 |Warm/Kind | |怀旧 / 唤起回忆 |Nostalgic/Memory |惊险 / 悬疑 / 紧张 |Thrilling/Suspenseful/Tense |甜蜜 |Sweet |严肃 / 沉思 |Serious/Reflective | |震撼 / 壮丽 / 宏大 |Shocking/magnificent/epic |治愈 |Healing |轻快 / 无忧无虑 |Brisk/Carefree |暗黑 |Dark | ### 场景 |

||||||||\ |V5\-场景

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |晴天 |Sunny Day |现场音乐演出场所 |Livehouse |商业 |Commercial |婴儿 |Babies | |夏天 |Summer |醒来 |Wake up |友谊 |Friendship |自我与成长 |Self and Growth | |运动 |Sport |延时摄影 |Timelapse |戏剧 |Drama |新年 |New Year | |舞蹈 |Dance |咖啡店 |Coffee Shop |户外 |Outdoor |乡村 |Countryside | |游戏 |Game |冥想 |Meditation |科技 / 科学 |Technology/Science |情人节 |Valentine's day | |春天 |Spring |休息室 |Lounge |战争 / 打斗 |War/Fight |雾天 |Fog | |旅行 |Travel |冬天 |Winter |家庭时光 |Family time |茶室 |Tea Room | |vlog / 日常生活 |Vlog/DailyLife |餐厅 |Restaurants |校园 |Campus |庆祝与欢乐 |Celebration and Joy | |放松 |Relaxation |宇宙 |Universe |预告片 |Trailer |春节 |Spring Festival | |风景 / 景色 |Landscape/Scenery |专注 |Focus |冒险 / 探索 |Adventure/Discovery |生活与心态 |Life and Mindset | |夜总会 |Nightclub |高能视频 |High\-energy video |超自然 |Supernatural |生日 |Birthday | |剧院 / 音乐厅 |Theater / Concert hall |宠物 / 动物 |Pet/Animals |调情 |Flirt |海洋 |Ocean/Sea | |秋天 |Autumn |动漫 |Anime |日落 / 午后 |Sunset/Afternoon |爱国视频 |Patriotic Video | |早晨 |Morning |美容 / 时尚 |Beauty/Fashion |恶作剧 |Prank |天空 / 天堂 |Sky/Heaven/Paradise | |适合跳舞的 |Danceable |美食 |Food |自然 |Nature |民族自豪感 |National Pride | |通勤 |Commute |市场 |Marketplace |午夜 |Midnight |马戏团 / 嘉年华 |Circus/Carnival | |雨天 |Rainy Day |约会 |Dating |地下 |Undergound |暴风雨 |Storm | |音乐节 |Music Festival |儿童 |Children |圣诞节 |Christmas |国庆节 |National's Day | |公路旅行 |Roadtrip |纪录片 |Documentary |日出 / 黎明 |Sunrise/Dawn |葬礼 |Funeral | |派对 |Party |娱乐 |Entertainment |梦想与未来 |Dream and Future |国庆节 |National's Day | |过渡 |Transition |分手 |Broke up |毕业 |Graduation |七夕节 |Qi Xi | |跑步 |Running |万圣节 |Halloween |森林 |Forest |中秋节 |Mid\-autumn Festival | |海滩 |Beach |情感类 |Emotional |文化活动 |Cultural events |教堂 |Church | |爱情 |Love |广告 |Advertisement |老年人视频 |Seniors video |寺庙 |Temple | |酒吧 |Bar |家庭 |Family |婚礼 |Wedding |祭典 |Matsuri | |傍晚 |Evening |热门短视频 |Viral short video |阴天 |Cloudy Day | | | ### 乐器 |

||||||||\ |V5\-乐器

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |打击乐器 |Percussion |合成和弦 |Synth_Chord |管弦竖琴 |Orchestral_Harp |钢片琴 |Celesta | |贝斯 |Bass |人声片段 |Vocal_Chops |手风琴 |Accordion |双簧管 |Oboe | |合成器 |Synthesizers |中国传统乐器 |Chinese Traditional Instruments |踩镲 |Hi_hat |西塔琴 |Sitar | |吉他 |Guitar |小提琴 |Violin |口哨声 |Whistle |低音提琴 |Doublebass | |键盘乐器 |Keys |管弦鼓 |Orchestral_Drums |合唱 |Chorus |吊镲 |Crash_Cymbal | |电贝斯 |Electric_Bass |伴唱 |Backing_Vocals |小号 |Trumpet |钟树 |Belltree | |合成鼓 |Synth_Drums |低音提琴拨奏 |Double_Bass_Pizzicato |合成钹 |Synth_Cymbals |长号 |Trombone | |原声钢琴 |Acoustic_Piano |合成底鼓 |Synth_Kick |钹 |Cymbals |合成特效 |Syntheffects | |合成特效 |Synth_Effects |康加鼓 / 邦戈鼓 |Congas/Bongos |箫 |Xiao |低音提琴 |Double_Bass | |弦乐 |Strings |合成踩镲 |Synth_Hi_hat |低音鼓 |Bassdrum |古琴 |Guqin | |电吉他 |Electric_Guitar |合成军鼓 |Synth_Snare |唱诗班与人声 |Choir_and_Voice |扬琴 |Yangqin | |合成音垫 |Synth_Pad |萨克斯风 |Saxophone |琵琶 |Pipa |牛铃 |Cowbell | |打击性乐器 |Percussive |古筝 |Guzheng |班卓琴 |Banjo |大号 |Tuba | |合成贝斯 |Synth_Bass |钟琴 |Bells |二胡 |Erhu |合成响棒 |Synth_Clave | |合成主音 |Synth_Lead |爵士鼓组 |Drumset |木琴 |Xylophone |管弦钹 |Orchestral_Cymbals | |合成拨弦 |Synth_Pluck |管风琴 |Organ |中国打击乐器 |Chinese_Percussion |管弦低音鼓 |Orchestral_Bassdrum | |原声吉他 |Acoustic_Guitar |笛 |Di |中国鼓 |Chinese_Drums |高音 / 次高音萨克斯风 |Soprano/Alto_Sax | |鼓 |Drums |原声钢琴 |Acousticpiano |三角铁 |Triangle |法国号 |French_Horn | |弦乐合奏 |String_Ensemble |民族乐器 |Ethnic |音乐盒 |Musicbox |马克树 |Mark_Tree | |爵士鼓组 |Drum_Set |尤克里里 |Ukelele |嗵鼓 |Tom |其他 |Others | |拍手声 |Clap |合成钟琴 |Synth_Bell |合成鼓 |Synthdrums |叮叮镲 |Ride_Cymbal | |人声 |Vocal |钢片琴 |Glockenspiel |口琴 |Harmonica |教堂钟声 |Church_Bells | |铜管乐器 |Brass |马林巴琴 |Marimba |电钢琴 |Electricpiano |中国鼓 |Chinesedrums | |半音阶打击乐器 |Chromatic_Percussion |定音鼓 |Timpani |单簧管 |Clarinet |手碟 |Hangdrum | |电钢琴 |Electric_piano |大提琴 |Cello |音垫 |Pad |主音 |Lead | |沙锤 |Sandhammer |打击乐器 |Percussions |短笛 |Piccolo |音效 |Soundeffects | |身体打击乐 |Body_Percussion |长笛 |Flute |低音鼓 |Bass_Drum |唢呐 |Suona | |铃鼓 |Tambourine |中提琴 |Viola |合成嗵鼓 |Synth_Tom |巴松管 |Bassoon | |清音电吉他 |Clean_Electric_Guitar |弹指声 |Finger_snaps |响板 |Castanets |三弦 |Sanxian | |铜管乐组 |Brass_Section |低音提琴 |Contrabass |合成贝斯 |Synthbass |竖琴 |Harp | |木管乐器 |Woodwinds |音效特效 |Fx |卡洪鼓 / 箱鼓 |Caj\u00f3n/Box_drum |风笛 |Bagpipe | |失真电吉他 |Distorted_Electric_Guitar |电吉他 |Electricguitar |风铃 |Wind_Chimes |合成弦乐 |Synthstrings | |合成弦乐 |Synth_Strings |合成铜管 |Synth_Brass |颤音琴 |Vibraphone |管弦军鼓 |Orchestral_Snare | |拨弦乐器 |Plucked Strings |军鼓 |Snare |曼陀林 |Mandolin |羽管键琴 |Harpsichord | |音效 |Sound_Effects |原声吉他 |Acousticguitar |响棒 |Claves |笙 |Sheng | ## V4可用参数（已废弃） ### Genre 支持47种曲风 |

||||||| |\ |V4\-Genre

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |corporate |企业 |world |世界 |pop |流行音乐 |dance |舞蹈 | |dance/edm |舞蹈/电子舞曲 |travel |旅行 |trailer |预告片 |video |视频 | |orchestral |管弦乐 |commercial |商业的 |modern |现代的 |vlog |视频博客 | |chill out |轻松 |advertising |广告营销 |electronic |电子的 |marketing |营销 | |rock |摇滚 |driving |驾驶 |documentary |记录 |game |游戏 | |hip hop |嘻哈 |cinematic |电影 |soundtrack |原声带 |radio |收音机 | |folk |民谣 |upbeat |乐观的 |fashion |时尚 |promotional |促销 | |funk |放克 |epic |史诗 |acoustic |自然声 |sports |运动的 | |ambient |氛围音乐 |inspiring |鼓舞人心的 |movie |电影 |party |派对 | |holiday |假期 |business |商业 |tv |电视 |summer |夏天 | |jazz |爵士乐 |video game |视频游戏 |high tech |高科技 |beauty |美丽 | |kids |童乐 |dark |黑暗的 |industrial |工业的 | | | ### Mood 支持52种心情 |

||||||||\ |V4\-Mood

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |positive |积极的 |confident |自信的 |intense |激烈的 |cheerful |令人愉快的 | |uplifting |令人振奋的 |joyful |喜悦 |elegant |优雅的 |casual |随意的 | |energetic |精力充沛 |dramatic |戏剧性 |mellow |醇厚 |beautiful |美丽的 | |happy |快乐 |peaceful |平静的 |emotional |情绪化的 |ethereal |空灵的 | |bright |明亮的 |playful |俏皮的 |sentimental |多愁善感的 |melancholy |忧郁的 | |optimistic |乐观的 |soft |轻柔 |cheerful happy |开朗快乐 |sad |伤心 | |hopeful |充满希望的 |groovy |时髦的 |contemplative |沉思的 |aggressive |挑衅的 | |cool |酷 |reflective |反省性的 |soothing |舒缓的 |haunting |令人难以忘怀的 | |dreamy |梦幻般的 |easy |简单的 |proud |自豪的 |adventure |冒险 | |fun |乐趣 |relaxed |轻松 |passionate |热情的 |serene |安详 | |light |轻音乐 |lively |活泼 |sweet |甜蜜 |sincere |真诚 | |powerful |强力的 |smooth |平滑的 |mystical |神秘 |funky |节奏强适宜跳舞的 | |calm |冷静的 |romantic |浪漫的 |tranquil |宁静 |funny |搞笑 | ### Theme 支持28种主题 |

||||||||\ |V4\-Theme

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |inspirational |灵感 |lifestyle |生活方式 |holiday |假日 |education |教育 | |motivational |激励 |journey |旅行 |health |健康 |progress |进步 | |achievement |成就 |meditation |冥想 |family |家庭 |world |世界 | |discovery |发现 |drama |戏剧 |real estate |房地产 |vacation |度假 | |every day |日常 |children |儿童 |media |媒体 |training |培训 | |love |爱情 |hope |希望 |kids |儿童 |christmas |圣诞 | |technology |科技 |fantasy |幻想 |science |科学 |sales |销售 | ### Instrument 支持25种乐器 |

||||||||\ |V4\-Instrument

| | | | | | | |\ | | | | | | | | | |---|---|---|---|---|---|---|---| |piano |钢琴 |organ |风琴 |acoustic guitar |民谣吉他 |glockenspiel |钟琴 | |drums |鼓 |trumpet |小号 |bass guitar |低音吉他 |synthesizer |（电子）合成器 | |guitar |吉他 |ukulele |尤克里里 |brass |铜管乐器 |keyboard |键盘乐器 | |percussion |打击乐器 |saxophone |萨克斯 |violin |小提琴 |marimba |马林巴琴 | |synth |合成器 |double bass |低音提琴 |cello |大提琴 |bass |贝斯 | |electric guitar |电吉他 |harp |竖琴 |flute |长笛 |banjo |班卓琴 | |strings |弦乐器 | | | | | | | # 异步回调说明对于纯音乐创建的任务，在任务执行完成时，我们会根据传入的异步回调地址CallbackURL，通过POST请求的形式将任务执行结果通知到用户系统。 ## 1、异步回调请求参数 ```JSON { "CallbackTime": 1724984476, // 回调时间，单位s "TaskID": "202408308513817850019840", // 任务ID "Status": 3, // 任务状态 2->成功, 3->失败 "FailureReason": { // 任务失败原因，任务执行成功时为null "Code": 100001, "Msg": "" }, "SongDetail": { "AudioUrl": "xxxxx", // 音频地址 URL域名规则：v{1-50}-default.douyinvod.com "Prompt": "xxxxxxx", // 生成纯音乐的提示词 "Duration": 46.0024375, // 音频时长，单位秒 "CallbackURL":"",//回调地址 "Theme":"",//主题 "Instrument":"",//乐器 "Mood":"", //情绪 "Genre":"", //曲风 "TosPath":"" //用户自定义的tos保存路径 } } ``` ## 响应 ```JSON { "code": 200,//状态 200代表成功，非200代表失败 "message": ""//失败原因（允许只有非200有值） } ``` ## 2、异步回调特性 1. 在异步回调请求交互时，如果响应状态非200，认为回调失败，会通过一定策略定期重新发起通知（最多重试2次）。通知的间隔频率为：5m、10m。 2. 回调接口请求使用的POST方式发送回调信息，数据格式为json。 # 签名源码示例暂时没有SDK，需要自行计算签名，请参考：[签名源码示例--API签名调用指南-火山引擎](https://www.volcengine.com/docs/6369/185600) java请使用我们提供的demo： Python请使用我们提供的参考demo： JS请使用我们提供的参考demo：

音视频理解与处理