# 版本变更记录 |版本 |修改时间 |变更内容 |备注 | |---|---|---|---| |v1.0 |2022\-08\-24 |1. 初始化文档| |\ | | |2. 智能模板推荐API| |\ | | |3. 自动剪辑成片API | | |v1.1 |2023\-09\-05 |1. 自动剪辑成片API新增字幕、配音、变速等功能| |\ | | |2. 获取花字列表API| |\ | | |3. 获取字体列表API | | # 公共字段 1. ## 请求Host：[https://icp.volcengineapi.com](https://icp.volcengineapi.com) 2. ## 请求Header > 描述：http请求中header需增加的字段 |**参数名** |**参数类型** |**是否必填** |**描述** | |---|---|---|---| |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)|\ | | | |* 签名Demo详见如下附件|\ | | | | * Java版|\ | | | | 暂时无法在飞书文档外展示此内容|\ | | | | * Golang:|\ | | | | 暂时无法在飞书文档外展示此内容 | |Content\-Type |String |是 |MIME类型，**固定值：** **`application/json`** | |X\-Content\-Sha256 |String |否 |对完整请求Body的加密结果，`HexEncode(Hash(RequestPayload))`|\ | | | |> `HexEncode`HexEncode代指转16进制编码|\ | | | |> `Hash`代指SHA256算法|\ | | | |> `RequestPayload`代指完整的请求的body。 | **Authorization中的信息含义：** |**名称** |**类型** |**备注** | |---|---|---| |AccessKeyId |String |请求的AccessKey。|\ | | ||\ | | |* AK/SK获取说明|\ | | | * 说明：在调用火山引擎视觉智能控制台的各个能力之前，确保您已生成访问密钥（AccessKey）。AccessKey包括AccessKeyID（AK）和AccessKeySecret（SK），其中AccessKeyID用于标识用户，AccessKeySecret是用来验证用户的密钥，请妥善保管。|\ | | | * 获取方式：点击右上角账号，下拉列表选择【密钥管理】，点击【新建密钥】按钮，可获取AK/SK，可以此为凭证调用上述已接入应用的接口。|\ | | | 注：安全起见，建议新建子账户，并使用子账户的AK/SK|\ | | ||\ | | |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_71674634f0f9a6457b234b728ee7c4fc.png) | |ShortDate |String |请求的短时间，使用UTC时间，精确到日。请使用格式：YYYYMMDD，例如：20221101 | |Region |String |请求的地域，**固定值：** **`cn-north-1`** | |Service |String |请求的服务，**固定值：** **`iccloud_muse`** | |SignedHeaders |String |参与签名的Header，用分号分隔。 | |Signature |String |计算完毕的签名。 | # HTTP接口详情 1. ## 智能模板推荐API * 输入素材格式要求： * 支持图片视频混合导入，素材个数最多15个，单个素材最大不超过100M。 * 视频支持的格式：mp4，avi，mov，wmv。 * 图片支持的格式：jpg、png、jpeg。不支持gif图像。 ### SubmitTemplateRecTaskAsync 描述：提交模板推荐任务。 Method：POST 请求参数 |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |SubmitTemplateRecTaskAsync | |Version |String |Query |是 |2022\-08\-01 | |TaskName |String |Body |否 |任务名称，默认：模板推荐_时间戳，长度不超过200 | |MediaList |[]String |Body |是 |素材列表，支持urs和http，demo见示例 | |RatioNumList |[[String,Int]] |Body |否 |模板比例及数量，比例支持两种16:9，9:16，每个比例数量范围[1, 10]。默认每个比例生成一个即：[["16:9",1],["9:16",1]]。 | |Fps |Int |Body |否 |帧率，默认25，可选[24, 25, 30, 50, 60] | |SaveFilm |Bool |Body |否 |是否保存至我的作品库，默认：否（24h清理） | 请求参数示例： ```json { "TaskName": "test", "MediaList": ["https://xxxxx", "urs://imuse?id=123344567"], "RatioNumList": [["16:9", 4],["9:16", 3]], "Fps": 30, "SaveFilm": true } ``` 返回参数 ```json { // TOP网关统一相应元信息 "Code": 0, "Message": "成功", // 请求、网关错误信息 "ResponseMetadata": { "RequestId": "xxxxx", "Action": "SubmitTemplateRecTaskAsync", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, "Result": { // 业务返回信息 "Data": { "TaskKey": "xxxxxxxx", //任务唯一标识 }, "Message": "xxx", // 业务错误信息. 可选 }, } ``` ### QueryTemplateRecTask 描述：根据任务key查询模板推荐任务。 Method：GET 请求参数 |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |QueryTemplateRecTask | |Version |String |Query |是 |2022\-08\-01 | |TaskKey |String |Query |是 |任务唯一标识 | 返回参数 ```json { // TOP网关统一相应元信息 "Code": 0, "Message": "成功", "ResponseMetadata": { "RequestId": "20211213140257010225133143062CC07B", "Action": "QueryTemplateRecTask", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, "Result": { // 业务返回信息 "Data": { "MainTask": { "TaskKey": "xxxxxxxxx", //任务唯一标识 "TaskName": "123", "CreatedAt": "", "UpdatedAt": "", "TaskStatus": 0, // 0成功，1进行中， 2失败 "Message": "xxxx" }, "SubTask": { "16:9": [{ "VideoKey": "xxxxx", //视频video_key "TaskStatus": 0,//任务状态，0成功，1进行中，2失败 "Progress": 30, // 任务进度 "DownloadUrl": "", //下载url "ReqId": "xxxx", //debug用 "MuseId": "12222222222", "CreatedAt": "2020-01-02 15:04:05", "UpdatedAt": "2020-01-02 15:04:07", "Message": "xxxx" //debug }], "9:16": [{ "VideoKey": "xxxxx", //视频video_key "TaskStatus": 0,//任务状态，0成功，1进行中，2失败 "Progress": 30, // 任务进度 "DownloadUrl": "", //下载url "ReqId": "xxxx", //debug用 "MuseId": "12222222222", "CreatedAt": "2020-01-02 15:04:05", "UpdatedAt": "2020-01-02 15:04:07", "Message": "xxxx" //debug }] }, }, "Message": "xxx", //错误信息. 可选 } } ``` 2. ## 花字列表API 描述：获取花字列表 Method：POST 请求参数： |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |GetFlowerList | |Version |String |Query |是 |2022\-08\-01 | 返回参数： ```json { "Code": 0, "Message": "成功", "ResponseMetadata": { "Action": "GetFlowerList", "Region": "cn-north-1", "RequestId": "202308101425311206EBB3E03188C543C6", "Service": "iccloud_muse", "Version": "2022-08-01" }, "Result": [ { "Cover": "https://apaas.iccvlog.com/api/muse/transcode/7259353422720139816?f=poster&sign=W8cNDCAO9C4idgitSC8rTQ%2BafxQMZqO0xDcB3XQyOtgExIzQnIt%2F0RwGSkrFahJYl4g%2FoMgtqLcia%2BoJMtKgKeZ6YfnOW91rJ981BAP7c5vNq9SrYMnF6W8hn6SBRoVs", "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353422720139816?sign=W8cNDCAO9C4idgitSC8rTQ%2BafxQMZqO0xDcB3XQyOtgExIzQnIt%2F0RwGSkrFahJYU29sR28RvnbJj%2B7A6yAq0p9xkl1VXiPTWPooo5ppebPK1U1fA5YIJ4tne%2BrN2Q53", "MediaId": "7259353403397062696", "Title": "018" }, { "Cover": "https://apaas.iccvlog.com/api/muse/transcode/7259353313248805435?f=poster&sign=8DlunhhuHSBNIywiGjdoN3rcwqv4BHfycf8uwVDnwCEExIzQnIt%2F0RwGSkrFahJYaFruAaluh9koIf%2BX8VyHSNbx1s8Qzvowm0M0CM9s%2BDJUmREDuc7CWp1QQ8Aj7rpo", "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353313248805435?sign=8DlunhhuHSBNIywiGjdoN3rcwqv4BHfycf8uwVDnwCEExIzQnIt%2F0RwGSkrFahJY4XgU%2FpsxaaYlrBk26FymY1LVkV4FtkxgDMBj7qRvJo9Y1btbS3AUJUt0aUnLdpmw", "MediaId": "7259353306600882233", "Title": "029" }, { "Cover": "https://apaas.iccvlog.com/api/muse/transcode/7259353591389880832?f=poster&sign=EiLQGI5DkOaDp8ejtD3DLBedRoPtafgf%2B3ssF0SSD3MExIzQnIt%2F0RwGSkrFahJY4BsEREQkvE5upYnmh3PVgrZixiiX2DcYi4cerNQXHmG0%2FPMVdyCYpKKUnxMjXT2S", "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353591389880832?sign=EiLQGI5DkOaDp8ejtD3DLBedRoPtafgf%2B3ssF0SSD3MExIzQnIt%2F0RwGSkrFahJYl8QnRJWeuCmai%2F4IkVd0agkxI1SevGnqMOQD7J%2B%2FO1HsXtXL3f8hukps5SQWUuTH", "MediaId": "7259353558347300904", "Title": "元旦-电影2" }, { "Cover": "https://apaas.iccvlog.com/api/muse/transcode/7259353396769980985?f=poster&sign=QBNWFiZKvQKb1gMJzeAyPxH6ed3zX0mNZqFLSPy3QPsExIzQnIt%2F0RwGSkrFahJY62NaeDOx%2F3PpqD%2BIdfVFEoe64bNgxA9aVA9hZtHZ9u43yxf6cuLKpBhVSqGQmYNF", "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353396769980985?sign=QBNWFiZKvQKb1gMJzeAyPxH6ed3zX0mNZqFLSPy3QPsExIzQnIt%2F0RwGSkrFahJY9TNmpwQ8kpq25MDpKcMKX%2Be1N%2BNTGDsyNloRIxNXh3R5aTzjKjYIo8NcjHv6YI3E", "MediaId": "7259353395813728312", "Title": "Kr040" } ] } ``` 3. ## 字体列表API 描述：获取字体列表 Method：POST 请求参数： |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |GetFontList | |Version |String |Query |是 |2022\-08\-01 | 返回参数： ```json { "Code": 0, "Message": "成功", "ResponseMetadata": { "Action": "GetFontList", "Region": "cn-north-1", "RequestId": "202308101432216104B32E4F6BC8C1479A", "Service": "iccloud_muse", "Version": "2022-08-01" }, "Result": [ { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353422720139816?sign=W8cNDCAO9C4idgitSC8rTQ%2BafxQMZqO0xDcB3XQyOtgExIzQnIt%2F0RwGSkrFahJYU29sR28RvnbJj%2B7A6yAq0p9xkl1VXiPTWPooo5ppebPK1U1fA5YIJ4tne%2BrN2Q53", "MediaId": "7259353403397062696", "Title": "018" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353549811745314?sign=pyadkisEU9NhoLWauDaDigx0Y2l632%2B%2BpIqI8H2PiiwExIzQnIt%2F0RwGSkrFahJYgaFSimPm9Ltb5Fp6Jxh7BLmqpQMw6Rd54yvAF2K3wLC6zKUdyBIZb1ls3m7wUlnT", "MediaId": "7259353544011071528", "Title": "167" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353422711751220?sign=Bqj9D%2BALh9N%2BlJcy%2Fz1%2F12aGKAUK799BNDEwHqz45PkExIzQnIt%2F0RwGSkrFahJYcp5uXDyuTxB38FZbErREQ4W6EYJMYZCvnNKeXsOgSk8WJfU39oNkHiRIQpUCEmHd", "MediaId": "7259353409877311503", "Title": "011" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353463451025960?sign=Uzmx%2FdOHchPqxO2Ejjx2atd2HeM0kgrjbIfb6BQTJM8ExIzQnIt%2F0RwGSkrFahJY7RF2sDR4Kr3krFgfW58sNA0UkZ4AxiqJH%2Bb4fiyG6Z6KvEVw6auyIashpSwE2Is0", "MediaId": "7259353463790780468", "Title": "BR002" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353423668052517?sign=s7tmNIuoyKorQq3%2B39SsvoWGKXIentRhG%2FEDYZmpuhkExIzQnIt%2F0RwGSkrFahJYr8auRZT9zAxqvtEXBQbXpsn8FFs9205d6AfaW01%2Fzb7hsb%2B3s7zpZtllbW4eHC%2F2", "MediaId": "7259353413048156217", "Title": "058" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353504840417844?sign=0R2lVz05L2oemww%2BKcjY6qh60jg48gZ8PprDua99iEsExIzQnIt%2F0RwGSkrFahJYUzqDQUCL3LX6Q7gHsoBLky2L59LKXB5WV%2B6VV1FTFhTChR5pxViR84%2BbhgRPSJKM", "MediaId": "7259353500054749184", "Title": "233" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353425551295036?sign=IdVH5MSFS%2B3uCoTSowHTN81GMqus%2F0xQYRyS39njVA8ExIzQnIt%2F0RwGSkrFahJYHRX7rs99m%2FAqbCXfncc0F6P6gsINZacz8fe8CQCCk8OGHlF8%2BDH4quftSG1WASWR", "MediaId": "7259353415745077303", "Title": "041" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353395176145463?sign=s0E88KBop3NrFJDKdal%2FzF64RFeP60L4%2B5SCfOgUvGQExIzQnIt%2F0RwGSkrFahJYIGUEG%2BbS6FPiq67pPjqspp8z846dQK2LH9Ai2fTnVeO%2FpfFKWaAAmM8aN6VpsnZp", "MediaId": "7259353352570552379", "Title": "空心发光字红" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353436989162018?sign=kgLzwRvpVUc0oPgVpTC2ZEqTpHT0K%2FcK2nIn8EamvU4ExIzQnIt%2F0RwGSkrFahJYgQNcqgxqn5sIe4%2F2GPzHacwNwdNR6YlqfgEnWJ0MzVEL5M%2FRqfBj5QwgbQrGo7fd", "MediaId": "7259353431268163599", "Title": "Kr087" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353463916593719?sign=D5zM%2BZXOLjHUdGJJ1Z6tkQ33xpyjZMDYOVXkLD638L4ExIzQnIt%2F0RwGSkrFahJYMI9lEM2igpxUyP2WLN5SRKok74CB2z1udC0LLoJZfMF3%2BcW3sutc98AeHv5IdHDU", "MediaId": "7259353451950260282", "Title": "044" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353437282763304?sign=z6NHn%2FcmmnY5b2ljXpgCWq3y9D6DznCM9SDWBGV%2BOl4ExIzQnIt%2F0RwGSkrFahJY92RT6ZjmM7pYCMSPt4u%2Bw2HwpQ82AvzJn4t7g%2FDfPWDKJpT1TTQRZvkttb02sl9Z", "MediaId": "7259353437433774114", "Title": "Kr055" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353437303734845?sign=fgi8AytELxFxwS8rzNX%2FCShcK0XpSD%2Fp7KuyffKy58QExIzQnIt%2F0RwGSkrFahJYbEfovxD7d%2Ff5BXnoCpEZ%2FOpRKc2iwtUmq8864iKHNhgOIuFBxiz%2B45%2FW5xR63r9b", "MediaId": "7259353410821029925", "Title": "Kr019" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353370425557504?sign=p6pH%2BsPMTjfdq0U2faNngqPNyF%2FZxq4GqRYdj0EZvrEExIzQnIt%2F0RwGSkrFahJYXaW9vAEXe0h8%2BhIYZ1i0CnfVCqTicn83E1XgcYOA2XCQX7bpT66RZRHff6s6EP1%2F", "MediaId": "7259353333306114083", "Title": "KR067" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353450075390525?sign=JamLO9NKJWT9vaa7iRbChfu9RtALooTsAPNSxTIFLKEExIzQnIt%2F0RwGSkrFahJY31QcAGWgpTvv49oAibpLKo0Q372wlSlozQ25lc1NJGu9eUll0uPlmt%2Ft5EWHN%2FgZ", "MediaId": "7259353414809829435", "Title": "210" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353525077934644?sign=TkZQieDPyLBAzp0C9U7i%2BwlqIXN%2BZlnjQOM2qJFCAzoExIzQnIt%2F0RwGSkrFahJYAmQ%2FF8OSXmM6Ko%2F1ggUMoHLtLfzRdjMsGlc0%2BNNd%2BpqB%2BGW%2BeyI2Xt3DwR4BKgyf", "MediaId": "7259353511203323938", "Title": "蓝色渐变花字" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353451191075328?sign=pFQ2os90hwIktS3FEOoVPROImJ1thmfmrZ%2FO%2FkC8Gb4ExIzQnIt%2F0RwGSkrFahJYR2V9IZXRnlPRCXEdhM52t5fQ00uXay%2BAazZ%2BLn57S8k8Eo02v2Hm1MJKfkqe4e0b", "MediaId": "7259353437433872418", "Title": "Jp022" }, { "DowloadUrl": "https://apaas.iccvlog.com/api/muse/origin/7259353351941259836?sign=7fxe%2FIhTa9S6cEYTElvQhd2fllk3whzBmxQk2u%2FprT0ExIzQnIt%2F0RwGSkrFahJY5wO79cLru37PZCGgysGax5lry4u3catCfCmcouv1D6nT6asM60oEXbXl37MklnBQ", "MediaId": "7259353345297514557", "Title": "062" } ] } ``` 4. ## 自动剪辑成片API * 输入素材格式要求： * 支持图片视频混合导入，素材个数最多15个，单个视频素材最大不超过100M，单个音频素材最大不超过30M。 * 视频支持的格式：mp4，flv，avi，mov，mpg，wmv，mkv。 * 音频支持的格式：mp3，wav，aac，ac3，m4a，wma。 * 图片支持的格式：jpg、png、jpeg、bmp。不支持gif图像。 ### SubmitMovieStudioTaskAsync 描述：提交自动剪辑成片任务。 Method：POST 请求参数 |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |SubmitMovieStudioTaskAsync | |Version |String |Query |是 |2022\-08\-01 | |TaskName |String |Body |否 |任务名称，默认：智能照片电影_时间戳，长度不超过200 | |MediaList |[]String |Body |是 |素材列表，支持urs和http，demo见示例 | |VideoSpeedList |[]Float |Body |否 |每个素材的变速。选填，列表长度等于MediaList长度，取值范围0.1~8.0，不变速填空列表或者不填 | |TotalDuration |Int |Body |否 |预期最终成片时长，单位为ms。如果不设置填\-1或者不填。 | |SegmentDuration |Int |Body |否 |预期每个素材的时长，单位为ms。如果不设置填为\-1或者不填。 | |Texts |Map[string, []Text] |Body |否 |自定义文本。map 的 key 为素材的下标，map 的 Text 为文字的信息。 | |TTS |[]TTS |Body |否 |配音，选填，列表长度等于MediaList长度,不需要tts的素材，需要手动把对应tts的下标中的text内容置"" | |CaptionStyle |Style |Body |否 |字幕样式 | |MusicId |String |Body |否 |自定义背景音乐，支持urs和http，大小不超过30m|\ | | | | |与EffectList里智能音乐推荐二选一 | |RatioNumList |[[String,Int]] |Body |否 |视频比例及数量，每个比例数量范围[1, 10]，每次最多支持两种比例，默认：[["16:9",1],["9:16",1]]。支持9:16,16:9,18:9,21:9,1:1,1:2.048,2.048:1以及自定义即自由设定宽高比。 | |Resolution |String |Body |否 |生成视频的分辨率，目前支持1080p、720p（p大小写都可以）。默认"1080p"。|\ | | | | ||\ | | | | |> * **Ratio: 9:16**|\ | | | | |> * Resolution: "720p" → 720×1280|\ | | | | |> * Resolution: "1080p" → 1080×1920|\ | | | | |> * **Ratio: 16:9**|\ | | | | |> * Resolution: "720p" → 1280×720|\ | | | | |> * Resolution: "1080p" → 1920×1080 | |EffectList |[]Bool |Body |否 |推荐特效是否开启。列表长度固定为9。分别对应：|\ | | | | ||\ | | | | |1. 智能音乐推荐|\ | | | | |2. 智能音乐卡点|\ | | | | |3. 智能转场推荐|\ | | | | |4. 智能运镜推荐|\ | | | | |5. 素材智能裁剪|\ | | | | |6. 智能视频动画推荐|\ | | | | |7. 智能特效推荐|\ | | | | |8. 智能文案推荐|\ | | | | |9. 保持原有素材顺序|\ | | | | ||\ | | | | |开启第几个，列表的第几项就写true，否则写false。例如开启智能音乐推荐，列表第一项就填true。|\ | | | | |默认全部开启 | |Fps |Int |Body |否 |帧率，默认25，可选[24, 25, 30, 50, 60] | |SaveFilm |Bool |Body |否 |是否保存至成片库，默认：否（24h清理） | #### Text 自定义添加的文本信息 |名称 |类型 |说明 | |---|---|---| |Text |String |文本内容 | |Style |Style |文本格式 | #### Style 文字等元素的格式 |名称 |类型 |说明 | |---|---|---| |FontSize |Int |文字的字体大小，其实也是字的行高，单位是字号pt 暂定0\-72（与编辑器文字大小下拉框对齐） | |Flower |String |花字 id 例子：urs://imuse?id=12312355。通过花字列表API获得 | |AlignType |int |文本对齐方式|\ | | |0 左对齐|\ | | |1 居中|\ | | |2 右 | |PositionX |float |归一化x坐标位置 \-1 ～ 1 ，（0，0）为屏幕中心 | |PositionY |float |归一化y坐标位置 \-1 ～ 1 ，（0，0）为屏幕中心 | |FontPath |string |字体资源ID，而非目录；例子：urs://imuse?id=12312355。通过字体列表API获得 | |TextColor |string |字体颜色，用16进制表示，例如：#f8dd4aff，格式是RGBA|\ | | |后两位是透明度，ff代表不透明 | #### TTS |名称 |类型 |说明 | |---|---|---| |Text |String |Tts 文本内容 | |Tone |int |配音音色 id | #### 音色可以在智能创作云SaaS平台【**智能配音**】功能，体验多种不同音色的播报效果，可以自由调节语速、音调等数据。 |ID |名称 |描述 |试听链接 |备注 | |---|---|---|---|---| |0 |抖音IP小姐姐 |机械女声，适用于通用场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_new_BV001.mp3 | | |1 |抖音IP小哥哥 |机械男声，适用于通用场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV002.mp3 | | |5 |青年男声 |客服男声，适用于零售，金融场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV008_DPE.mp3 | | |11 |东北老铁 |东北方言，适用于泛互场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV021.mp3 | | |13 |港剧男神 |粤语方言，适用于泛互场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV026.mp3 | | |16 |重庆小伙 |重庆方言，适用于泛互场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV019.mp3 | | |21 |阳光青年 |阳光积极，适用于小说场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV123.mp3 | | |22 |憨厚青年 |憨厚老实，适用于小说场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV120.mp3 | | |24 |霸气青叔 |高冷霸气，适用于小说场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV107.mp3 | | |26 |儒雅青年 |稳重男声，适用于小说场景 |https://sf1\-cdn\-tos.huoshanstatic.com/obj/labcv\-tob/muse/tts_BV102.mp3 | | |30 |甜美女声 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV405_streaming.mp3 | | |32 |活泼幼教 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV057_ParaTaco_streaming.mp3 | | |33 |活泼女声 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV005_ParaTaco_streaming.mp3 | | |34 |亲切女声 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/tts_BV007_ParaTaco_streaming.mp3 | | |35 |知性女声 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/tts_BV009_DPE_ParaTaco_streaming.mp3 | | |36 |知性男声 |男声,虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/tts_BV008_DPE_ParaTaco_streaming.mp3 | | |37 |灿灿 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV700_streaming.mp3 | | |38 |阳光男声 |男声,虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV419_streaming.mp3 | | |39 |天才童声 |男声,虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV061.mp3 | | |40 |超自然\-梓梓 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_BV406.mp3 | | |41 |默认 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/baidu_avatar_2d_bob_tone.mp3 | | |42 |杨芳音色 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_DH011.mp3 | | |43 |Alex定制音色 |男声,虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_eonjbm44k2ly\-cd559fa2\-8922\-443b\-8040\-bc1fb5b6a1b5.mp3 | | |44 |月晴音色 |女声、虚拟人 |https://lf\-iccloud\-muse.volcmusecdn.com/obj/labcv\-tob/muse/new_tts_DH019_streaming.mp3 | | 请求参数示例： ```json { "TaskName": "test", "MediaList": ["https://xxxxx", "urs://imuse?id=123344567"], "MusicId": "https://xxxx", "RatioNumList": [["16:9", 1],["9:16", 1]], "Resolution": "720p", "EffectList": [true, true, true, true, true, true, true, true, true], "Fps": 30, "SaveFilm": false, "VideoSpeedList":[1,2], "TotalDuration":130, "SegmentDuration":2, "TTS":[{"Text":"hello","Tone":0},{"Text":"hello","Tone":0}], "CaptionStyle":{ "FontSize":12, "Flower":"urs://imuse?id=12312355", "AlignType":1, "PositionX":0.2, "PositionY":-0.2, "FontPath":"urs://imuse?id=12312355", "TextColor":"#f8dd4aff" }, "Texts":{ "0":[{ "Text":"hello", "Style":{ "FontSize":12, "Flower":"urs://imuse?id=12312355", "AlignType":1, "PositionX":0.2, "PositionY":-0.2, "FontPath":"urs://imuse?id=12456573344567", "TextColor":"#f8dd4aff" } }, { "Text":"hello2", "Syle":{ "FontSize":12, "Flower":"urs://imuse?id=12312355", "AlignType":1, "PositionX":0.2, "PositionY":-0.2, "FontPath":"urs://imuse?id=12456573344567", "TextColor":"#f8dd4aff" }} ]} } ``` 返回参数 ```json { // TOP网关统一相应元信息 "Code": 0, "Message": "成功", "ResponseMetadata": { "RequestId": "20211213140257010225133143062CC07B", "Action": "SubmitMovieStudioTaskAsync", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, // 业务返回信息 "Result": { "Data": { "TaskKey": "xxxxxxxx", //任务唯一标识 }, "Message": "xxx", //错误信息. 可选 }, } ``` ### QueryMovieStudioTask 描述：根据任务key查询自动剪辑成片任务。 Method：GET 请求参数 |参数 |类型 |参数类型 |是否必填 |描述 | |---|---|---|---|---| |Action |String |Query |是 |QueryMovieStudioTask | |Version |String |Query |是 |2022\-08\-01 | |TaskKey |String |Query |是 |任务唯一标识 | 返回参数 ```json { // TOP网关统一相应元信息 "Code": 0, "Message": "成功", "ResponseMetadata": { "RequestId": "20211213140257010225133143062CC07B", "Action": "QueryMovieStudioTask", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, "Result": { // 业务返回信息 "Data": { "MainTask": { "TaskKey": "xxxxxxxxx", //任务唯一标识 "TaskName": "123", "CreatedAt": "", "UpdatedAt": "", "TaskStatus": 0, // 0成功，1进行中， 2失败 "Message": "xxxx" }, "SubTask": { "16:9": [{ "VideoKey": "xxxxx", //视频video_key "TaskStatus": 0,//任务状态，0成功，1进行中，2失败 "Progress": 30, // 任务进度 "DownloadUrl": "", //下载url "ReqId": "xxxx", //debug用 "MuseId": "12222222222", "CreatedAt": "2020-01-02 15:04:05", "UpdatedAt": "2020-01-02 15:04:07", "Message": "xxxx" //debug }], "9:16": [{ "VideoKey": "xxxxx", //视频video_key "TaskStatus": 0,//任务状态，0成功，1进行中，2失败 "Progress": 30, // 任务进度 "DownloadUrl": "", //下载url "ReqId": "xxxx", //debug用 "MuseId": "12222222222", "CreatedAt": "2020-01-02 15:04:05", "UpdatedAt": "2020-01-02 15:04:07", "Message": "xxxx" //debug }] }, }, "Message": "xxx", //错误信息. 可选 } } ``` # 错误码 |Code |Name |Message | |---|---|---| |0 |Ok |成功 | |4001 |Parameter |参数错误 | |4002 |InvalidAccess |您的使用次数/存储容量已达上限，请联系和贵组织对接字节工作人员，为您开通更大的容量 | |4003 |InvalidUser |无效账户信息 | |4004 |TooManyTasks |创建任务失败，请检查是否大于最大任务数 | |4005 |RequestError |请求header信息缺失 | |4006 |TaskNotFound |任务不存在或已被删除 | |4033 |GenerateVideoFail |视频生成失败 | |5001 |RepeatCreateTask |服务器错误 |

创作Agent