You need to enable JavaScript to run this app.
导航
智能创作云
  • 文档首页
    • /智能创作云/API对接相关/智能创作云-高级成片OpenAPI
智能创作云-高级成片OpenAPI
最近更新时间：2024.07.30 20:47:38首次发布时间：2024.07.30 20:47:38
我的收藏
版本变更记录
版本修改时间变更内容备注

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

  2. 请求Header

描述：http请求中header需增加的字段

参数名参数类型是否必填描述
X-DateString是使用UTC时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z' ，例如：20201103T104027Z

Authorization

String

是

HMAC-SHA256 Credential={AccessKeyId}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}

  • 签名完整过程详见：签名示例

  • 签名Demo详见如下附件

    • Java版

    暂时无法在飞书文档外展示此内容

    • Golang:

    暂时无法在飞书文档外展示此内容

Content-TypeString是MIME类型，固定值： application/json

X-Content-Sha256

String

否

对完整请求Body的加密结果，HexEncode(Hash(RequestPayload))

HexEncodeHexEncode代指转16进制编码
Hash代指SHA256算法
RequestPayload代指完整的请求的body。

Authorization中的信息含义：

名称类型备注

AccessKeyId

String

请求的AccessKey。

  • AK/SK获取说明

    • 说明：在调用火山引擎视觉智能控制台的各个能力之前，确保您已生成访问密钥（AccessKey）。AccessKey包括AccessKeyID（AK）和AccessKeySecret（SK），其中AccessKeyID用于标识用户，AccessKeySecret是用来验证用户的密钥，请妥善保管。

    • 获取方式：点击右上角账号，下拉列表选择【密钥管理】，点击【新建密钥】按钮，可获取AK/SK，可以此为凭证调用上述已接入应用的接口。

    注：安全起见，建议新建子账户，并使用子账户的AK/SK

ShortDateString请求的短时间，使用UTC时间，精确到日。请使用格式：YYYYMMDD，例如：20221101
RegionString请求的地域，固定值： cn-north-1
ServiceString请求的服务，固定值： iccloud_muse
SignedHeadersString参与签名的Header，用分号分隔。
SignatureString计算完毕的签名。
HTTP接口详情

  1. 智能模板推荐API

  • 输入素材格式要求：

    • 支持图片视频混合导入，素材个数最多15个，单个素材最大不超过100M。

    • 视频支持的格式：mp4，avi，mov，wmv。

    • 图片支持的格式：jpg、png、jpeg。不支持gif图像。

SubmitTemplateRecTaskAsync

描述：提交模板推荐任务。
Method：POST
请求参数

参数类型参数类型是否必填描述
ActionStringQuery是SubmitTemplateRecTaskAsync
VersionStringQuery是2022-08-01
TaskNameStringBody否任务名称，默认：模板推荐_时间戳，长度不超过200
MediaList[]StringBody是素材列表，支持urs和http，demo见示例

RatioNumList

[[String,Int]]

Body

否

模板比例及数量，比例支持两种16:9，9:16，每个比例数量范围[1, 10]。默认每个比例生成一个即：[["16:9",1],["9:16",1]]。

FpsIntBody否帧率，默认25，可选[24, 25, 30, 50, 60]
SaveFilmBoolBody否是否保存至我的作品库，默认：否（24h清理）

请求参数示例：

{
    "TaskName": "test",
    "MediaList": ["https://xxxxx", "urs://imuse?id=123344567"],
    "RatioNumList": [["16:9", 4],["9:16", 3]],
    "Fps": 30,
    "SaveFilm": true
}

返回参数

{
    // 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
请求参数

参数类型参数类型是否必填描述
ActionStringQuery是QueryTemplateRecTask
VersionStringQuery是2022-08-01
TaskKeyStringQuery是任务唯一标识

返回参数

{
    // 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",  //错误信息. 可选
    }
}

  1. 花字列表API

描述：获取花字列表
Method：POST
请求参数：

参数类型参数类型是否必填描述
ActionStringQuery是GetFlowerList
VersionStringQuery是2022-08-01

返回参数：

{
    "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"
        }
    ]
}

  1. 字体列表API

描述：获取字体列表
Method：POST
请求参数：

参数类型参数类型是否必填描述
ActionStringQuery是GetFontList
VersionStringQuery是2022-08-01

返回参数：

{
    "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"
        }
    ]
}

  1. 自动剪辑成片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
请求参数

参数类型参数类型是否必填描述
ActionStringQuery是SubmitMovieStudioTaskAsync
VersionStringQuery是2022-08-01

TaskName

String

Body

否

任务名称，默认：智能照片电影_时间戳，长度不超过200

MediaList[]StringBody是素材列表，支持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内容置""

CaptionStyleStyleBody否字幕样式

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"。

EffectList

[]Bool

Body

否

推荐特效是否开启。列表长度固定为9。分别对应：

  1. 智能音乐推荐

  2. 智能音乐卡点

  3. 智能转场推荐

  4. 智能运镜推荐

  5. 素材智能裁剪

  6. 智能视频动画推荐

  7. 智能特效推荐

  8. 智能文案推荐

  9. 保持原有素材顺序

开启第几个，列表的第几项就写true，否则写false。例如开启智能音乐推荐，列表第一项就填true。
默认全部开启

FpsIntBody否帧率，默认25，可选[24, 25, 30, 50, 60]
SaveFilmBoolBody否是否保存至成片库，默认：否（24h清理）

Text

自定义添加的文本信息

名称类型说明
TextString文本内容
StyleStyle文本格式

Style

文字等元素的格式

名称类型说明
FontSizeInt文字的字体大小，其实也是字的行高，单位是字号pt 暂定0-72（与编辑器文字大小下拉框对齐）
FlowerString花字 id 例子：urs://imuse?id=12312355。通过花字列表API获得

AlignType

int

文本对齐方式
0 左对齐
1 居中
2 右

PositionXfloat归一化x坐标位置 -1 ～ 1 ，（0，0） 为屏幕中心
PositionYfloat归一化y坐标位置 -1 ～ 1 ，（0，0） 为屏幕中心
FontPathstring字体资源ID，而非目录；例子：urs://imuse?id=12312355。通过字体列表API获得

TextColor

string

字体颜色，用16进制表示，例如：#f8dd4aff，格式是RGBA
后两位是透明度，ff代表不透明

TTS

名称类型说明
TextStringTts 文本内容
Toneint配音音色 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
43Alex定制音色男声,虚拟人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

请求参数示例：

{
    "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"
        }}
  ]}
    
}

返回参数

{
    // 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
请求参数

参数类型参数类型是否必填描述
ActionStringQuery是QueryMovieStudioTask
VersionStringQuery是2022-08-01
TaskKeyStringQuery是任务唯一标识

返回参数

{
    // 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",  //错误信息. 可选
    }
}
数据结构
错误码
CodeNameMessage
0Ok成功
4001Parameter参数错误
4002InvalidAccess您的使用次数/存储容量已达上限，请联系和贵组织对接字节工作人员，为您开通更大的容量
4003InvalidUser无效账户信息
4004TooManyTasks创建任务失败，请检查是否大于最大任务数
4005RequestError请求header信息缺失
4006TaskNotFound任务不存在或已被删除
4033GenerateVideoFail视频生成失败
5001RepeatCreateTask服务器错误