版本 | 修改时间 | 变更内容 | 备注 |
---|---|---|---|
v1.0 | 2022-08-11 | 初始化文档 | |
v1.1 | 2023-07-11 | 1. 新增替换模板固定文案字段FixedText |
描述:http请求中header需增加的字段
参数名 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z |
Authorization | String | 是 |
|
Content-Type | String | 是 | MIME类型,固定值: application/json |
X-Content-Sha256 | String | 否 | 对完整请求Body的加密结果,
|
Authorization中的信息含义:
名称 | 类型 | 备注 |
---|---|---|
AccessKeyId | String | 请求的AccessKey。
|
ShortDate | String | 请求的短时间,使用UTC时间,精确到日。请使用格式:YYYYMMDD,例如:20221101 |
Region | String | 请求的地域,固定值: cn-north-1 |
Service | String | 请求的服务,固定值: iccloud_muse |
SignedHeaders | String | 参与签名的Header,用分号分隔。 |
Signature | String | 计算完毕的签名。 |
支持使用图片文字智能生成视频,扩大视频创作的方式,丰富平台视频的多样性,降低创作门槛。
图文转视频内含业界领先的语义理解算法,图文匹配算法,并辅以真实亲切的语音播报,生动的模板效果,提供便捷、智能、高效的视频生产体验。
描述: 提交图文转视频任务
Method: POST
请求参数
类别 | 参数 | 类型 | 位置 | 是否必填 | 描述 |
---|---|---|---|---|---|
通用参数 | Action | String | Query | 是 | SubmitText2VideoTaskAsync |
Version | String | Query | 是 | 2022-08-01 | |
视频内容 | Type | Int | Body | 是 | 生成视频的方式,0表示传入文章链接,1表示传入文章标题和文章内容,2表示传入word文档 |
ArticleUrl | String | Body | 否 | 当type=0时必填,表示文章链接,目前支持头条文章域名 | |
ArticleTitle | String | Body | 否 | 当type=1时必填,表示文章标题 | |
ArticleContent | String | Body | 否 | 当type=1时必填,表示文章内容,字数≤3000 | |
FileUrl | String | Body | 否 | 当type=2时必填,表示word文档链接,仅支持.docx格式,大小≤15MB | |
FixedText | String | Body | 否 | 替换模板中固定文案,不替换不传,无需文案传空字符串 | |
视频配置 | TargetDuration | Int | Body | 否 | 视频时长的种类,目前有三种,0表示短(约15s),1表示中等(约30s),2表示长(约60s)。不传该字段表示全文生成。 |
ScreenRatio | Int | Body | 是 | 屏幕比例的种类,0表示9:16(默认),1表示16:9 | |
Resolution | Int | Body | 是 | 视频分辨率,0为720P,1为1080P | |
TemplateId | Int | Body | 否 | 模板ID,不传该字段为自动匹配 | |
MaterialSource | Int[] | Body | 是 | 素材来源(可选择多个),0:链接/word中的素材,1:素材库中的素材,2:商用版权素材,4:无版权素材,5:免费版权素材 | |
CoverType | Int | Body | 否 | 封面样式,0(默认):非黑首帧,1:在封面模板库中随机选取 | |
语音播报 | ToneId | Int | Body | 否 | 语音播报音色ID,不传该字段为无需播报 |
TtsSpeed | Int | Body | 否 | 语音播报速度,100为原速度,区间50-200 | |
TtsVolume | Int | Body | 否 | 语音播报音量,100为原音量,区间0-200 | |
TtsPitch | Int | Body | 否 | 语音播报音调,100为原音调,区间50-200 | |
背景音乐 | BgmType | Int | Body | 否 | 背景音乐类型,0:智能匹配(默认),1:手动选择,2:传入自定义Url |
BgmSource | String | Body | 否 | BgmType=0时,此值可不填 BgmType=1时,请传入背景音乐ID BgmType=2时,请传入自定义的http链接 | |
BgmVolume | Int | Body | 否 | 背景音乐音量,默认为10(10%音量),区间0-100 |
请求参数示例:
{ // 播报内容,三种输入方式任选其一 // 输入文章链接 "Type": 0, "ArticleUrl": "https://www.toutiao.com/a7005198875711586820", "FixedText":"固定文案", // 输入文章内容 "Type": 1, "ArticleTitle": "测试标题", "ArticleContent": "测试内容", // 输入Word文档 "Type": 2, "FileUrl": "https://xxx.docx", // 通用参数 // 视频配置 //"TargetDuration": 0, "ScreenRatio": 1, "Resolution": 1, //"TemplateId": 1, "MaterialSource": [1], "CoverType": 1, // 语音播报 "ToneId": 0, "TtsSpeed": 100, "TtsVolume": 100, "TtsPitch": 100, // 背景音乐 "BgmType": 1, "BgmSource": "1", "BgmVolume": 10 }
返回参数
{ // 网关统一相应元信息 "Code": 0, "Message": "成功", // 请求、网关错误信息 "ResponseMetadata": { "RequestId": "xxxxx", "Action": "SubmitText2VideoTaskAsync", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, "Result": { // 业务返回信息 "Status": 0, "VideoKey": "ff04ad42-ca34-11ed-a86b-3436ac1200a4" //任务唯一标识 } }
描述: 根据任务key查询图文转视频
Method: GET
请求参数
参数 | 类型 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|---|
Action | String | Query | 是 | QueryText2VideoTasks |
Version | String | Query | 是 | 2022-08-01 |
VideoKeys | String | Query | 是 | 任务唯一标识,多个任务通过","间隔,例如"aaa,bbb" |
返回参数
{ // 网关统一相应元信息 "Code": 0, "Message": "成功", "ResponseMetadata": { "RequestId": "20211213140257010225133143062CC07B", "Action": "QueryText2VideoTask", "Version": "2022-08-01", "Service": "iccloud_muse", "Region": "cn-north-1", }, "Result": [ // 业务返回信息 { "VideoKey": "xxx", //任务Key "Museid": "xxx", //成片ID "DownloadUrl": "xxx", //下载Url,24h有效期 "CoverUrl": "https://xxx", //封面Url,24h有效期 "TaskStatus": 0, //生成状态,0:成功,1:算法中,2:渲染中,3:失败 "Progress": 100, //生成进度 "Createdat": "2020-01-02 15:04:05", //任务创建时间 "Updatedat": "2020-01-02 15:04:07", //任务更新时间 "Message": "xxx", //错误信息 }, ] }
Code | Domain | 错误说明 |
---|---|---|
0 | Ok | 成功 |
4001 | Parameter | 参数错误 |
4002 | InvalidAccess | 无权限使用,可能是使用次数/存储容量已达上限 |
4003 | InvalidUser | 无效账户信息 |
4004 | TooManyTasks | 并行任务数超出上限 |
4005 | RequestError | 请求Header信息缺失 |
4006 | TaskNotFound | 任务不存在或已被删除 |
5001 | ServerError | 服务器错误 |
ID | 名称 | 类别 | 封面 | 备注 |
---|---|---|---|---|
0 | 红色经典模板 | 【资讯播报】 | ||
1 | 黑色经典模板 | 【资讯播报】 | ||
2 | 科技紫曲线模板 | 【股市行情】 | ||
3 | 紫色渐变几何模板 | 【重磅新闻】 | ||
4 | 蓝色未来感模板 | 【股市行情】 | ||
5 | 炫彩追光动感模板 | 【资讯播报】 | ||
6 | 深蓝地图模板 | 【资讯播报】 | ||
7 | 朱红创意模板 | 【赛事播报】 | ||
8 | 熊猫卡通模板 | 【赛事播报】 | ||
9 | 毛玻璃雾感模板 | 【资讯播报】 | ||
10 | 新虚拟女主播模板 | 【新闻播报】 | ||
11 | 天蓝概念模板 | 【重磅新闻】 | ||
12 | 深蓝几何模板 | 【资讯播报】 | ||
13 | 蓝紫动感模板 | 【股市行情】 | ||
14 | 白色轻透感模版 | 【热点洞察】 | ||
15 | 深蓝光感模板 | 【功能操作指引】 | ||
16 | 新虚拟男主播模板 | 【新闻播报】 | ||
17 | 虚拟主播资讯模板 | 【兴业专属】 | ||
18 | 3D机智猫模板 | 【兴业专属】 | ||
19 | 大红k线模板 | 【股市行情】 | ||
20 | 深蓝k线模板 | 【股市行情】 | ||
21 | 紫色炫光模板 | 【资讯播报】 | ||
22 | 雅金炫光模板 | 【资讯播报】 | ||
23 | 简约动态几何模板 | 【资讯播报】 | ||
24 | 蓝色简约动态几何模板 | 【资讯播报】 | ||
25 | 暗红动态模板 | 【热点资讯】 | ||
26 | 蓝金动态模板 | 【热点资讯】 | ||
27 | 蓝金网格模板 | 【热点资讯】 | ||
28 | 天蓝网格模板 | 【热点资讯】 | ||
29 | 深蓝网格模板 | 【热点资讯】 | ||
30 | 大红网格模板 | 【资讯播报】 | ||
31 | 褐金质感模板 | 【热点要闻】 | ||
32 | 红金质感模板 | 【热点要闻】 | ||
33 | None | |||
34 | None | |||
35 | None | |||
36 | None | |||
37 | None | |||
38 | None | |||
39 | None | |||
40 | None | |||
41 | None | |||
42 | None | |||
43 | None | |||
44 | None | |||
45 | None | |||
46 | None | |||
47 | None | |||
48 | None | |||
49 | None | |||
50 | None | |||
51 | None | |||
52 | None | |||
53 | None | |||
54 | None | |||
55 | None | |||
56 | None | |||
57 | None | |||
58 | None | |||
59 | None | |||
60 | None | |||
61 | None | |||
62 | None | |||
63 | None | |||
64 | None | |||
65 | None | |||
66 | None | |||
67 | None | |||
68 | None | |||
69 | None | |||
70 | None | |||
71 | None | |||
72 | None | |||
73 | None | |||
74 | None | |||
75 | None | |||
76 | None | |||
77 | None | |||
78 | None | |||
79 | None | |||
80 | None | |||
81 | None | |||
82 | None | |||
83 | None | |||
84 | None | |||
85 | None | |||
86 | None | |||
87 | None | |||
88 | None |
ID | 名称 | 类别 | 封面 | 备注 |
---|---|---|---|---|
0 | 横画幅模板 | 【商务经典】 | ||
1 | 新虚拟女主播模板 | 【资讯播报】 | ||
2 | 毛玻璃雾感模板 | 【资讯播报】 | ||
3 | 新虚拟女主播模板 | 【热点洞察】 | ||
4 | 新虚拟男主播模板 | 【资讯播报】 | ||
5 | 沉浸式播报模板 | 【兴业专属】 | ||
6 | 虚拟主播资讯模板 | 【兴业专属】 | ||
7 | 镭射蓝金模板 | 【热点要闻】 | ||
8 | 暗红镭射模板 | 【热点资讯】 | ||
9 | None | |||
10 | None | |||
11 | None | |||
12 | None | |||
13 | None | |||
14 | None | |||
15 | None | |||
16 | None |
ID | 名称 | 类别 | 试听链接 | 备注 |
---|---|---|---|---|
1 | 通用1 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/tongyong2.mp3 | |
2 | 通用2 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/80f9c6ac3fca3e48db20e7ed71f669ce.mp3 | |
3 | 通用3 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/98d742f4553ab48de4cbea30d0140d64.mp3 | |
4 | 通用4 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/17ce131155593e2a07ade85a9930e515.mp3 | |
5 | 通用5 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/e75e034ae34f7e22733c28723683789f.mp3 | |
7 | 通用6 | 通用 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1610151788908546.mp3 | |
8 | 诙谐1 | 诙谐 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/d6c730beedffa920f9e690399230d409.mp3 | |
9 | 诙谐2 | 诙谐 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/42ac4c60af5c38b7eb74ba15c0a33e13.mp3 | |
10 | 诙谐3 | 诙谐 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1605055098898449.mp3 | |
11 | 紧张1 | 紧张 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1641382351167563.mp3 | |
12 | 紧张2 | 紧张 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/33920000013e7de9b503 | |
13 | 激昂1 | 激昂 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1605057721351170.mp3 | |
14 | 激昂2 | 激昂 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/53110004702ff4b1ec99 | |
15 | Canyons | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1631506921947144.mp3 | |
16 | Pebbles | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1628704623287300.mp3 | |
17 | Flute piccolo | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/66d3528eb6171c38e5766620b40351f5.mp3 | |
18 | WHAT | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/05d7aa0210a02ceaeb2fd0dd69ec1608.mp3 | |
19 | 是夏天啊 | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/a347257d5cb59edbe965f21adc9be859.mp3 | |
20 | Kikoshin | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/93760002a1a034e4a5fa | |
21 | 电流急急棒BGM Pt.2 | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/a44369e38ad40b9ee3615175fd32dcf1.mp3 | |
22 | Suns | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1634856217690113.mp3 | |
23 | Left Right | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/f2a943e1524377b1fa70f1188d4de34d.mp3 | |
24 | di feel(pt1) | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/e656ad893f2e12d75a00488347a174b7.mp3 | |
25 | Play | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/85c90000a05bbd908086 | |
26 | lets go play | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/1605054142787585.mp3 | |
27 | 跳跳跳! | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/42ac4c60af5c38b7eb74ba15c0a33e13.mp3 | |
28 | 调皮 | 轻快 | https://lf-iccloud-muse.volcmusecdn.com/obj/labcv-tob/muse/3f93554218e8c45be13a01a0e5fd911b.mp3 |
可以在智能创作云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 | |
2 | 成熟女声 | 成熟女声,适用于零售,金融场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV009_DPE.mp3 | |
3 | 青年女声 | 客服女声,适用于零售,金融场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV007.mp3 | |
4 | 稳重大叔 | 大气男声, 适用于广告,零售场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV006.mp3 | |
5 | 青年男声 | 客服男声,适用于零售,金融场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV008_DPE.mp3 | |
6 | 新闻女声 | 新闻女声, 适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV011.mp3 | |
7 | 可爱少女 | 活泼女声,适用于广告,零售场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV005.mp3 | |
8 | 新闻男声 | 新闻男声, 适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV012.mp3 | |
9 | 活力青年 | 活力男生,适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV056.mp3 | |
10 | 中英男声 | 中英温柔男声,适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV033_ParaTaco.mp3 | |
11 | 东北老铁 | 东北方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV021.mp3 | |
12 | 西安掌柜 | 西安方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV210.mp3 | |
13 | 港剧男神 | 粤语方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV026.mp3 | |
14 | 甜美台妹 | 台湾方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV025.mp3 | |
15 | 相声演员 | 天津方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV212.mp3 | |
16 | 重庆小伙 | 重庆方言,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV019.mp3 | |
17 | 二次元萝莉 | 萝莉童声,适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV064.mp3 | |
18 | 海绵宝宝 | 卡通童声,适用于通用场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV063.mp3 | |
19 | 萌娃童声 | 温柔童声,适用于泛互场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV051.mp3 | |
20 | 说书大叔 | 说书京腔,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV110.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 | |
23 | 散漫赘婿 | 慵懒男声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV119.mp3 | |
24 | 霸气青叔 | 高冷霸气,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV107.mp3 | |
25 | 质朴青年 | 明朗男声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV100.mp3 | |
26 | 儒雅青年 | 稳重男声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV102.mp3 | |
27 | 开朗青年 | 男声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV004.mp3 | |
28 | 温和少御 | 温柔女声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV114.mp3 | |
29 | 平缓少御 | 平缓女声,适用于小说场景 | https://sf1-cdn-tos.huoshanstatic.com/obj/labcv-tob/muse/tts_BV113.mp3 |