tencentcloud-sdk-nodejs 4.1.214 → 4.1.215

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/es/common/sdk_version.js +1 -1
  2. package/es/services/cfw/v20190904/cfw_client.js +5 -2
  3. package/es/services/emr/v20190103/emr_client.js +14 -8
  4. package/es/services/tcbr/v20220217/tcbr_client.js +8 -2
  5. package/es/services/tdmysql/v20211122/tdmysql_client.js +5 -2
  6. package/es/services/vclm/v20240523/vclm_client.js +51 -6
  7. package/es/services/vpc/v20170312/vpc_client.js +3 -0
  8. package/package.json +1 -1
  9. package/tencentcloud/common/sdk_version.d.ts +1 -1
  10. package/tencentcloud/common/sdk_version.js +1 -1
  11. package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_models.d.ts +39 -4
  12. package/tencentcloud/services/cfw/v20190904/cfw_client.d.ts +7 -3
  13. package/tencentcloud/services/cfw/v20190904/cfw_client.js +9 -3
  14. package/tencentcloud/services/cfw/v20190904/cfw_models.d.ts +235 -5
  15. package/tencentcloud/services/cls/v20201016/cls_client.d.ts +1 -1
  16. package/tencentcloud/services/cls/v20201016/cls_client.js +1 -1
  17. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +2 -2
  18. package/tencentcloud/services/config/v20220802/config_models.d.ts +7 -3
  19. package/tencentcloud/services/csip/v20221121/csip_models.d.ts +4 -0
  20. package/tencentcloud/services/dts/v20211206/dts_models.d.ts +30 -44
  21. package/tencentcloud/services/emr/v20190103/emr_client.d.ts +19 -11
  22. package/tencentcloud/services/emr/v20190103/emr_client.js +26 -14
  23. package/tencentcloud/services/emr/v20190103/emr_models.d.ts +145 -10
  24. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +2 -2
  25. package/tencentcloud/services/ess/v20201111/ess_client.js +2 -2
  26. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +84 -311
  27. package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +2 -2
  28. package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +2 -2
  29. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +69 -236
  30. package/tencentcloud/services/iss/v20230517/iss_models.d.ts +53 -33
  31. package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts +28 -60
  32. package/tencentcloud/services/mps/v20190612/mps_client.d.ts +1 -1
  33. package/tencentcloud/services/mps/v20190612/mps_client.js +1 -1
  34. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +15 -392
  35. package/tencentcloud/services/mrs/v20200910/mrs_models.d.ts +53 -31
  36. package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +78 -65
  37. package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts +46 -41
  38. package/tencentcloud/services/tcbr/v20220217/tcbr_client.d.ts +11 -3
  39. package/tencentcloud/services/tcbr/v20220217/tcbr_client.js +15 -3
  40. package/tencentcloud/services/tcbr/v20220217/tcbr_models.d.ts +83 -27
  41. package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +35 -25
  42. package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.d.ts +7 -3
  43. package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.js +9 -3
  44. package/tencentcloud/services/tdmysql/v20211122/tdmysql_models.d.ts +142 -28
  45. package/tencentcloud/services/teo/v20220901/teo_models.d.ts +1 -53
  46. package/tencentcloud/services/vclm/v20240523/vclm_client.d.ts +67 -7
  47. package/tencentcloud/services/vclm/v20240523/vclm_client.js +99 -9
  48. package/tencentcloud/services/vclm/v20240523/vclm_models.d.ts +1672 -577
  49. package/tencentcloud/services/vod/v20180717/vod_models.d.ts +8 -0
  50. package/tencentcloud/services/vpc/v20170312/vpc_client.d.ts +5 -1
  51. package/tencentcloud/services/vpc/v20170312/vpc_client.js +6 -0
  52. package/tencentcloud/services/vpc/v20170312/vpc_models.d.ts +32 -2
@@ -54,94 +54,89 @@ export interface SubmitVideoStylizationJobRequest {
54
54
  StyleStrength?: string;
55
55
  }
56
56
  /**
57
- * SubmitImageToVideoViduJob请求参数结构体
57
+ * SubmitImageToVideoJob请求参数结构体
58
58
  */
59
- export interface SubmitImageToVideoViduJobRequest {
59
+ export interface SubmitImageToVideoJobRequest {
60
60
  /**
61
- * <p>上传单张图时【首帧生视频】:</p><p>模型将以此参数中传入的图片为首帧画面来生成视频。<br>注1:支持传入图片 Base64 编码或图片URL(确保可访问);<br>注2:支持上传1 张图;<br>注3:图片支持 png、jpeg、jpg、webp格式;<br>注4:图片比例需要小于 1:4 或者 4:1 ;<br>注5:图片大小不超过50M。</p><p>上传两张图时【首尾帧生视频】:<br>上传的第一张图片视作首帧图,第二张图片视作尾帧图,模型将以此参数中传入的图片来生成视频<br>注1: 首尾帧两张输入图的分辨率需相近,首帧图的分辨率/尾帧图的分辨率要在0.8~1.25之间。且图片比例需要小于1:4或者4:1;<br>注2: 支持传入图片 Base64 编码或图片URL(确保可访问);<br>注3: 图片支持 png、jpeg、jpg、webp格式;<br>注4: 图片大小不超过50M;</p>
61
+ * <p>模型名称。<br>v1.6:Kling-V1-6<br>v2.0:Kling-V2-Master<br>v2.1:Kling-V2-1<br>v2.5:Kling-V2-5-Turbo<br>v2.6:Kling-V2-6<br>V3.0:kling-v3</p>
62
62
  */
63
- Images: Array<string>;
63
+ Model?: string;
64
64
  /**
65
- * <p>模型名称,可选值,默认值viduq2-turbo</p><ul><li>viduq2-pro:新模型,效果好,细节丰富</li><li>viduq2-turbo:新模型,效果好,生成快</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
65
+ * <p>参考图像。</p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片文件大小不能超过10MB,图片分辨率不小于300*300px,图片宽高比要在1:2.5 ~ 2.5:1之间</li><li>Image 参数与 ImageTail 参数至少二选一,二者不能同时为空</li><li>图片格式支持.jpg / .jpeg / .png</li></ul>
66
66
  */
67
- Model?: string;
67
+ Image?: Image;
68
68
  /**
69
- * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:若使用is_rec推荐提示词参数,模型将不考虑此参数所输入的提示词</p>
69
+ * <p>参考尾帧图像。</p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片文件大小不能超过10MB,图片分辨率不小于300*300px,图片宽高比要在1:2.5 ~ 2.5:1之间</li><li>Image 参数与 ImageTail 参数至少二选一,二者不能同时为空</li><li>图片格式支持.jpg / .jpeg / .png</li><li>ImageTail参数、DynamicMasks/StaticMask参数、CameraControl参数三选一,不能同时使用</li></ul>
70
70
  */
71
- Prompt?: string;
71
+ ImageTail?: Image;
72
72
  /**
73
- * <p>是否使用推荐提示词,默认关闭<br>-true:是,由系统自动推荐提示词,并使用提示词内容生成视频,推荐提示词数量=1<br>-false:否,根据输入的prompt生成视频<br>注意:启用推荐提示词后,每个任务多消耗1积分</p>
73
+ * <p>正向文本提示词。不能超过2500个字符</p>
74
74
  */
75
- IsRec?: boolean;
75
+ Prompt?: string;
76
76
  /**
77
- * <p>【首帧生视频】</p><p>是否使用音视频直出能力,默认关闭,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音视频直出,输出带台词以及背景音的视频<br>注1:该参数为true时,voice_id参数才生效<br>注2:该参数为true时,仅q3模型支持错峰<br>注3:当model 为q3-pro或q3-turbo 时,该参数默认值为true</li></ul><p>【首尾帧生视频】</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
77
+ * <p>负向文本提示词。不能超过2500个字符</p>
78
78
  */
79
- Audio?: boolean;
79
+ NegativePrompt?: string;
80
80
  /**
81
- * <p>音色id<br>用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:新音色列表<br>暂不支持声音复刻功能</p>
81
+ * <p>生成视频时长,单位s。默认值为5。<br>枚举值:3,4,5,6,7,8,9,10,11,12,13,14,15</p><p>不同模型支持时长不同</p><ul><li>模型v1.6、v2.0、v2.5、v2.6:支持5、10</li><li>模型v3.0:支持3~15s</li></ul>
82
82
  */
83
- VoiceId?: string;
83
+ Duration?: string;
84
84
  /**
85
- * <p>视频时长参数:<br>【首帧生视频】:<br>viduq3-pro、viduq3-turboxa0默认为 5,可选:1 - 16<br>viduq2-pro、viduq2-turboxa0默认为 5,可选:1 - 10</p><p>【首尾帧生视频】:<br>viduq3-proxa0viduq3-turbo默认为 5,可选:1 - 16<br>viduq2-providuq2-turboxa0默认为 5,可选:1 - 8</p>
85
+ * <p>生成视频的模式<br>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p><p>不同模型版本、视频模式支持范围不同</p><ul><li>v1.6:首尾帧与仅首帧情况下只支持pro</li><li>v2.0v3.0 :无需配置</li><li>v2.1、v2.5、v2.6:首尾帧情况下只支持pro</li></ul>
86
86
  */
87
- Duration?: number;
87
+ Mode?: string;
88
88
  /**
89
- * <p>分辨率参数<br>【首帧生视频】:</p><ul><li>viduq3-pro viduq3-turbo 1-16秒:默认 720p,可选:540p720p、1080p</li><li>viduq2-pro、viduq2-turbo 1-10秒:默认 720p,可选:720p、1080p<br>示例值:720p</li></ul><p>【首尾帧生视频】:<br>-xa0viduq3-proxa0、viduq3-turbo1-16秒:默认 720p,可选:540p、720p、1080p<br>-xa0viduq2-proxa0、xa0viduq2-turbo1-8秒:默认 720p,可选:540p、720p、1080p</p>
89
+ * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>v2.0v2.5v2.6模型的不支持当前参数<br>取值范围:[0, 1]</p>
90
90
  */
91
- Resolution?: string;
91
+ CfgScale?: number;
92
92
  /**
93
- * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:q2、q3系列模型改参数不生效</p>
93
+ * <p>生成视频时是否同时生成声音<br>枚举值:on,off<br>不同模型版本、视频模式支持范围不同</p><ul><li>v2.6:有首尾帧的pro模式只能生成无声的视频</li></ul>
94
94
  */
95
- MovementAmplitude?: string;
95
+ Sound?: string;
96
96
  /**
97
- * <p>bgm</p>
97
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
98
98
  */
99
- Bgm?: boolean;
99
+ LogoAdd?: number;
100
100
  /**
101
- * <p>音频类型,audio为true时必填,默认为all<br>注:该参数目前仅支持q2、q1、2.0系列模型的音频拆分</p><p>枚举值:</p><ul><li>all: 音效+人声</li><li>speech_only: 仅人声</li><li>sound_effect_only: 仅音效</li></ul>
101
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
102
102
  */
103
- AudioType?: string;
103
+ LogoParam?: LogoParam;
104
104
  /**
105
- * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
105
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,Prompt参数无效,且不支持设定首尾帧生视频</li><li>当前参数为false时,ShotType参数及MultiPrompt参数无效</li></ul>
106
106
  */
107
- MetaData?: string;
107
+ MultiShot?: boolean;
108
108
  /**
109
- * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
109
+ * <p>分镜方式</p><ul><li>枚举值:customize,intelligence</li><li>当MultiShot参数为true时,当前参数必填</li></ul>
110
110
  */
111
- CallbackUrl?: string;
111
+ ShotType?: string;
112
112
  /**
113
- * <p>透传参数<br>不做任何处理,仅数据传输<br>注:最多 1048576个字符</p>
113
+ * <p>各分镜信息,如提示词、时长等<br>通过Index、Prompt、Duration参数定义分镜序号及相应提示词和时长,其中:</p><ul><li>最多支持6个分镜,最小支持1个分镜</li><li>每个分镜相关内容的最大长度不超过512</li><li>每个分镜的时长不大于当前任务的总时长,不小于1</li><li>所有分镜的时长之和等于当前任务的总时长</li></ul><p>用key:value承载,如下:<br>&quot;MultiPrompt&quot;:[<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> },<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> }<br>]</p><ul><li>当MultiShot参数为true且ShotType参数为customize时,当前参数不得为空</li></ul>
114
114
  */
115
- Payload?: string;
115
+ MultiPrompt?: Array<MultiPrompt>;
116
116
  /**
117
- * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
117
+ * <p>参考主体列表</p><ul><li><p>基于主体库中主体的ID配置,用key:value承载,如下:</p><pre><code> &quot;ElementList&quot;:[ { &quot;ElementId&quot;:long }, { &quot;ElementId&quot;:long } ]</code></pre></li><li><p>最多支持3个参考主体</p></li><li><p>主体分为视频定制主体(简称:视频角色主体)和图片定制主体(简称:多图主体),适用范围不同,请注意区分</p></li><li><p>更多主体信息详见:可灵「主体库 3.0」使用指南</p></li></ul>
118
118
  */
119
- OffPeak?: boolean;
119
+ ElementList?: Array<Element>;
120
120
  /**
121
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
121
+ * <p>静态笔刷涂抹区域(用户通过运动笔刷涂抹的 mask 图片)<br>“运动笔刷”能力包含“动态笔刷 DynamicMasks”和“静态笔刷 StaticMask”两种<br>支持传入图片Base64编码或图片URL(确保可访问,格式要求同 Image 字段)<br>图片格式支持.jpg / .jpeg / .png<br>图片长宽比必须与输入图片相同(即Image字段),否则任务失败(failed)<br>StaticMask和 DynamicMasks.Mask这两张图片的分辨率必须一致,否则任务失败(failed)</p>
122
122
  */
123
- LogoAdd?: number;
123
+ StaticMask?: string;
124
124
  /**
125
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
125
+ * <p>动态笔刷配置列表<br>可配置多组(最多6组),每组包含“涂抹区域 Mask”与“运动轨迹 Trajectories”序列</p>
126
126
  */
127
- LogoParam?: LogoParam;
128
- }
129
- /**
130
- * logo参数
131
- */
132
- export interface LogoParam {
127
+ DynamicMasks?: Array<DynamicMask>;
133
128
  /**
134
- * 水印 Url
129
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
135
130
  */
136
- LogoUrl?: string;
131
+ CameraControl?: CameraControl;
137
132
  /**
138
- * 水印 Base64,Url 和 Base64 二选一传入,如果都提供以 Url 为准
133
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
139
134
  */
140
- LogoImage?: string;
135
+ CallbackUrl?: string;
141
136
  /**
142
- * 水印图片位于生成结果图中的坐标及宽高,将按照坐标对标识图片进行位置和大小的拉伸匹配。
137
+ * <p>生成视频时所引用的音色的列表</p><p>一次视频生成任务至多引用2个音色<br>当VoiceList参数不为空且Prompt参数中引用音色ID时,视频生成任务按“有指定音色”计量计费<br>VoiceId参数值通过音色定制接口返回,也可使用系统预置音色,详见音色定制相关API;非对口型API的VoiceId<br>ElementList参数与VoiceList参数互斥,不能共存<br>v3模型不支持指定音色<br>用key:value承载,如下:<br>&quot;VoiceList&quot;:[<br> {&quot;VoiceId&quot;:&quot;VoiceId_1&quot;},<br> {&quot;VoiceId&quot;:&quot;VoiceId_2&quot;}<br>]</p>
143
138
  */
144
- LogoRect?: LogoRect;
139
+ VoiceList?: Array<Voice>;
145
140
  }
146
141
  /**
147
142
  * DescribeVideoVoiceJob返回参数结构体
@@ -224,136 +219,239 @@ export interface SubmitHumanActorJobRequest {
224
219
  LogoParam?: LogoParam;
225
220
  }
226
221
  /**
227
- * SubmitImageAnimateJob返回参数结构体
222
+ * DescribeImageToVideoViduJob返回参数结构体
228
223
  */
229
- export interface SubmitImageAnimateJobResponse {
224
+ export interface DescribeImageToVideoViduJobResponse {
230
225
  /**
231
- * 图片跳舞任务ID。
226
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
232
227
  */
233
- JobId?: string;
228
+ Status?: string;
229
+ /**
230
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
231
+ */
232
+ ErrorCode?: string;
233
+ /**
234
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
235
+ */
236
+ ErrorMessage?: string;
237
+ /**
238
+ * <p>结果视频 URL。有效期 24 小时。</p>
239
+ */
240
+ ResultVideoUrl?: string;
241
+ /**
242
+ * <p>该任务消耗的积分数量。</p>
243
+ */
244
+ Credits?: number;
245
+ /**
246
+ * <p>任务调用时传入的透传参数。</p>
247
+ */
248
+ Payload?: string;
234
249
  /**
235
250
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
236
251
  */
237
252
  RequestId?: string;
238
253
  }
239
254
  /**
240
- * 模板信息
255
+ * SubmitTextToVideoViduJob请求参数结构体
241
256
  */
242
- export interface FaceTemplateInfo {
257
+ export interface SubmitTextToVideoViduJobRequest {
243
258
  /**
244
- * 角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字,建议填"0"、"1",依次累加。
259
+ * <p>文本提示词<br>生成视频的文本描述。<br>注:字符长度不能超过 2000 个字符</p>
245
260
  */
246
- TemplateFaceID?: string;
261
+ Prompt: string;
247
262
  /**
248
- * 视频模板中要替换的人脸图片
263
+ * <p>模型名称,可选值,默认viduq2</p><ul><li>viduq2:最新模型</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
249
264
  */
250
- TemplateFaceImage?: Image;
265
+ Model?: string;
251
266
  /**
252
- * 视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。
267
+ * <p>视频时长参数,默认值依据模型而定:</p><ul><li>viduq3-pro、viduq3-turbo: 默认5秒,可选:1-16</li><li>viduq2 : 默认5秒,可选:1-10</li></ul>
253
268
  */
254
- TemplateFaceRect?: FaceRect;
269
+ Duration?: number;
270
+ /**
271
+ * <p>是否为生成的视频添加背景音乐。<br>默认:false,可选值 true 、false<br>传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p><ul><li>BGM不限制时长,系统根据视频时长自动适配</li><li>BGM参数在q2模型的duration为 9秒 或 10秒 时不生效;该参数在q3系列模型中不生效</li></ul>
272
+ */
273
+ Bgm?: boolean;
274
+ /**
275
+ * <p>比例<br>默认 16:9,可选值如下:16:9、9:16、4:3、3:4、1:1</p>
276
+ */
277
+ AspectRatio?: string;
278
+ /**
279
+ * <p>分辨率参数,默认值依据模型和视频时长而定:</p><ul><li>viduq3-pro、viduq3-turbo(1-16秒):默认 720p,可选:540p、720p、1080p</li><li>viduq2(1-10秒):默认 720p,可选:540p、720p、1080p</li></ul>
280
+ */
281
+ Resolution?: string;
282
+ /**
283
+ * <p>风格<br>默认 general,可选值:general、anime<br>general:通用风格,可以通过提示词来控制风格<br>anime:动漫风格,仅在动漫风格表现突出,可以通过不同的动漫风格提示词来控制<br>注:使用q2、q3系列模型时该参数不生效</p>
284
+ */
285
+ Style?: string;
286
+ /**
287
+ * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:使用q2、q3系列模型时该参数不生效</p>
288
+ */
289
+ MovementAmplitude?: string;
290
+ /**
291
+ * <p>是否使用音视频直出能力,默认为true,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
292
+ */
293
+ Audio?: boolean;
294
+ /**
295
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
296
+ */
297
+ MetaData?: string;
298
+ /**
299
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
300
+ */
301
+ CallbackUrl?: string;
302
+ /**
303
+ * <p>透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符</p>
304
+ */
305
+ Payload?: string;
306
+ /**
307
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
308
+ */
309
+ OffPeak?: boolean;
310
+ /**
311
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
312
+ */
313
+ LogoAdd?: number;
314
+ /**
315
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
316
+ */
317
+ LogoParam?: LogoParam;
255
318
  }
256
319
  /**
257
- * DescribeAigcVideoJob请求参数结构体
320
+ * SubmitVideoEditJob请求参数结构体
258
321
  */
259
- export interface DescribeAigcVideoJobRequest {
322
+ export interface SubmitVideoEditJobRequest {
260
323
  /**
261
- * 任务ID。
262
-
263
- 示例值:1194931538865782784
324
+ * <p>参考视频URL。默认为待编辑视频。</p><ul><li>视频格式:支持MP4</li><li>视频时长:输入视频时长≤10秒</li><li>视频大小:不超过200M</li><li>视频文件:输入的视频帧率及分辨率不做限制(建议输入16:9或9:16的视频;分辨率建议在2160px内,帧率建议在60fps内);输出视频是帧率会≥16fps,分辨率为720p</li></ul>
264
325
  */
265
- JobId?: string;
326
+ VideoUrl: string;
327
+ /**
328
+ * <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
329
+ */
330
+ Prompt?: string;
331
+ /**
332
+ * <p>参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。</p><ul><li>支持传入图片Base64编码或图片URL</li><li>图片格式:支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>图片文件:大小不能超过10MB(base64后)。单边分辨率不超过5000px,不小于50px,图片长宽限制1:4 ~ 4:1。<br>示例值:[{ &quot;Url&quot;: &quot;https://console.cloud.tencent.com/cos/image.png&quot;}]</li></ul>
333
+ */
334
+ Images?: Array<Image>;
335
+ /**
336
+ * <p>图片base64或者图片url</p><ul><li>Base64 和 Url 必须提供一个,如果都提供以Url为准。</li><li>上传图url大小不超过 8M</li><li>支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1</li></ul>
337
+ * @deprecated
338
+ */
339
+ Image?: Image;
340
+ /**
341
+ * <p>扩展字段。</p>
342
+ */
343
+ VideoEditParam?: VideoEditParam;
344
+ /**
345
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
346
+ */
347
+ LogoAdd?: number;
348
+ /**
349
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
350
+ */
351
+ LogoParam?: LogoParam;
266
352
  }
267
353
  /**
268
- * SubmitImageToVideoViduJob返回参数结构体
354
+ * DescribeVideoExtendKlingJob请求参数结构体
269
355
  */
270
- export interface SubmitImageToVideoViduJobResponse {
356
+ export interface DescribeVideoExtendKlingJobRequest {
271
357
  /**
272
358
  * <p>任务ID。</p>
273
359
  */
274
360
  JobId?: string;
275
- /**
276
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
277
- */
278
- RequestId?: string;
279
361
  }
280
362
  /**
281
- * SubmitImageAnimateJob请求参数结构体
363
+ * SubmitVideoEditKlingJob请求参数结构体
282
364
  */
283
- export interface SubmitImageAnimateJobRequest {
284
- /**
285
- * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
286
- 图片分辨率:长边分辨率范围【192,4096】;
287
- 图片大小:不超过10M;
288
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
289
- */
290
- ImageUrl?: string;
365
+ export interface SubmitVideoEditKlingJobRequest {
291
366
  /**
292
- * 图片base64数据。
293
- 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
294
- 图片分辨率:长边分辨率范围【192,4096】;
295
- 图片大小:不超过10M;
296
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
367
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
297
368
  */
298
- ImageBase64?: string;
369
+ Prompt?: string;
299
370
  /**
300
- * 动作模板ID。取值说明:ke3 科目三;tuziwu 兔子舞;huajiangwu 划桨舞。
301
-
371
+ * <p>模型名称,支持kling-video-o1,kling-v3-omni。默认kling-video-o1。</p>
302
372
  */
303
- TemplateId?: string;
373
+ Model?: string;
304
374
  /**
305
- * 结果视频是否保留模板音频。默认为true
375
+ * <p>参考图列表</p><p>包括主体、场景、风格等参考图片,也可作为首帧或尾帧生成视频;当作为首帧或尾帧生成视频时:</p><p>通过type参数来定义图片是否为首尾帧:first_frame为首帧,end_frame为尾帧</p><p>暂时不支持仅尾帧,即有尾帧图时必须有首帧图</p><p>首帧或首尾帧生视频时,不能使用视频编辑功能</p><p>用key:value承载,如下:</p><p>&quot;ImageInfo&quot;:[<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;first_frame&quot;<br> },<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;end_frame&quot;<br> }<br>]<br>支持传入图片URL(确保可访问)</p><p>图片格式支持.jpg / .jpeg / .png</p><p>图片文件大小不能超过10MB,图片宽高尺寸不小于300px,不大于8000px,图片宽高比要在1:2.5 ~ 2.5:1之间</p><p>有参考视频时,参考图片数量不得超过4;无参考视频时,参考图片数量不得超过7</p><p>数组中超过2张图片时,不支持设置尾帧</p>
306
376
  */
307
- EnableAudio?: boolean;
377
+ ImageList?: Array<ImageInfo>;
308
378
  /**
309
- * 是否对输入图采用加强检测方案。
310
-
311
- 默认不加强检测(false),仅对输入图做必要的基础检测。
312
-
313
- 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
379
+ * <p>生成视频的画面纵横比(宽:高)</p><p>枚举值:16:9, 9:16, 1:1</p><p>未使用首帧参考或视频编辑功能时,当前参数必填</p>
314
380
  */
315
- EnableBodyJoins?: boolean;
381
+ AspectRatio?: string;
316
382
  /**
317
- * 是否对结果视频背景进行分割,默认值为false。
318
- true:分割结果视频,结果视频(ResultVideoUrl)将为去除背景的绿幕视频,并返回掩码视频(MaskVideoUrl);
319
- false:不分割结果视频,结果视频(ResultVideoUrl)为带背景的视频,掩码视频(MaskVideoUrl)为空字符串。
383
+ * <p>生成视频时长,单位s</p><p>枚举值:3,4,5,6,7,8,9,10,其中:使用文生视频、首帧图生视频时,仅支持5和10s<br>使用视频编辑功能(“refer_type”:“base”)时,输出结果与传入视频时长相同,此时当前参数无效;此时,按输入视频时长四舍五入取整计量计费</p>
320
384
  */
321
- EnableSegment?: boolean;
385
+ Duration?: number;
322
386
  /**
323
- * 为生成视频添加标识的开关,默认为0
324
- 1:添加标识。
325
- 0:不添加标识。
326
- 其他数值:默认按1处理。
327
- 建议您使用显著标识来提示,该视频是 AI 生成的视频。
387
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
328
388
  */
329
389
  LogoAdd?: number;
330
390
  /**
331
- * 标识内容设置。
332
- 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
391
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
333
392
  */
334
393
  LogoParam?: LogoParam;
335
394
  /**
336
- * 是否开启人脸检测。
337
-
338
- 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
395
+ * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
339
396
  */
340
- EnableFace?: boolean;
397
+ Mode?: string;
398
+ /**
399
+ * <p>参考视频,通过URL方式获取</p><p>可作为特征参考视频,也可作为待编辑视频,默认为待编辑视频;可选择性保留视频原声<br>通过ReferType参数区分参考视频类型:feature为特征参考视频,base为待编辑视频<br>参考视频为待编辑视频时,不能定义视频首尾帧<br>通过KeepOriginalSound参数选择是否保留视频原声,yes为保留,no为不保留;当前参数对特征参考视频(feature)也生效</p><ul><li>视频格式仅支持MP4/MOV</li><li>仅支持时长≥3秒且≤10秒的视频</li><li>视频宽高尺寸需介于720px(含)和2160px(含)之间</li><li>视频帧率基于24fps~60fps,生成视频时会输出为24fps</li><li>至多仅支持上传1段视频,视频大小不超过200MB</li></ul>
400
+ */
401
+ VideoList?: Array<ReferVideoInfo>;
402
+ /**
403
+ * <p>是否生成多镜头视频 当前参数为true时,prompt参数无效,且不支持设定首尾帧生视频 当前参数为false时,shot_type参数及multi_prompt参数无效</p>
404
+ */
405
+ MultiShot?: boolean;
406
+ /**
407
+ * <p>分镜方式 枚举值:customize 当multi_shot参数为true时,当前参数必填</p>
408
+ */
409
+ ShotType?: string;
410
+ /**
411
+ * <p>各分镜信息,如提示词、时长等 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中: 最多支持6个分镜,最小支持1个分镜 每个分镜相关内容的最大长度不超过512 每个分镜的时长不大于当前任务的总时长,不小于1 所有分镜的时长之和等于当前任务的总时长</p>
412
+ */
413
+ MultiPrompt?: Array<MultiPrompt>;
414
+ /**
415
+ * <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
416
+ */
417
+ ElementList?: Array<Element>;
418
+ /**
419
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
420
+ */
421
+ CallbackUrl?: string;
422
+ /**
423
+ * <p>是否开启声音</p>
424
+ */
425
+ Sound?: string;
341
426
  }
342
427
  /**
343
- * DescribeVideoVoiceJob请求参数结构体
428
+ * 生成视频时所引用的音色
344
429
  */
345
- export interface DescribeVideoVoiceJobRequest {
430
+ export interface Voice {
346
431
  /**
347
- * 任务ID。
432
+ * <p>音色id</p>
433
+ */
434
+ VoiceId?: string;
435
+ }
436
+ /**
437
+ * SubmitImageAnimateJob返回参数结构体
438
+ */
439
+ export interface SubmitImageAnimateJobResponse {
440
+ /**
441
+ * 图片跳舞任务ID。
348
442
  */
349
443
  JobId?: string;
444
+ /**
445
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
446
+ */
447
+ RequestId?: string;
350
448
  }
351
449
  /**
352
- * SubmitImageToVideoGeneralJob返回参数结构体
450
+ * SubmitVideoFaceFusionJob返回参数结构体
353
451
  */
354
- export interface SubmitImageToVideoGeneralJobResponse {
452
+ export interface SubmitVideoFaceFusionJobResponse {
355
453
  /**
356
- * 任务ID
454
+ * 视频人脸融合任务的job id(job有效期24小时)
357
455
  */
358
456
  JobId?: string;
359
457
  /**
@@ -362,9 +460,9 @@ export interface SubmitImageToVideoGeneralJobResponse {
362
460
  RequestId?: string;
363
461
  }
364
462
  /**
365
- * DescribeVideoFaceFusionJob返回参数结构体
463
+ * DescribeTemplateToVideoJob返回参数结构体
366
464
  */
367
- export interface DescribeVideoFaceFusionJobResponse {
465
+ export interface DescribeTemplateToVideoJobResponse {
368
466
  /**
369
467
  * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
370
468
  */
@@ -387,97 +485,1141 @@ export interface DescribeVideoFaceFusionJobResponse {
387
485
  RequestId?: string;
388
486
  }
389
487
  /**
390
- * DescribeVideoFaceFusionJob请求参数结构体
488
+ * DescribeReferenceToVideoViduJob返回参数结构体
391
489
  */
392
- export interface DescribeVideoFaceFusionJobRequest {
490
+ export interface DescribeReferenceToVideoViduJobResponse {
393
491
  /**
394
- * 任务ID
492
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
395
493
  */
396
- JobId?: string;
397
- }
398
- /**
399
- * 人脸框信息。
494
+ Status?: string;
495
+ /**
496
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
497
+ */
498
+ ErrorCode?: string;
499
+ /**
500
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
501
+ */
502
+ ErrorMessage?: string;
503
+ /**
504
+ * <p>结果视频 URL。有效期 24 小时。</p>
505
+ */
506
+ ResultVideoUrl?: string;
507
+ /**
508
+ * <p>该任务消耗的积分数量。</p>
509
+ */
510
+ Credits?: number;
511
+ /**
512
+ * <p>任务调用时传入的透传参数。</p>
513
+ */
514
+ Payload?: string;
515
+ /**
516
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
517
+ */
518
+ RequestId?: string;
519
+ }
520
+ /**
521
+ * SubmitMotionControlKlingJob请求参数结构体
522
+ */
523
+ export interface SubmitMotionControlKlingJobRequest {
524
+ /**
525
+ * <p>模型名称 枚举值:kling-v2-6, kling-v3。</p>
526
+ */
527
+ Model?: string;
528
+ /**
529
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
530
+ */
531
+ Prompt?: string;
532
+ /**
533
+ * <p>参考图像,生成视频中的人物、背景等元素均以参考图为准 视频内容需满足以下要求: 人物比例尽量与参考动作比例一致,尽量避免全身动作驱动半身人物进行生成 人物需要露出清晰的上半身或全身的肢体及头部,避免遮挡 画面中人物避免存在极端朝向,比如倒立、平卧等。人物占画面比例不得太低 支持真实/风格化的角色(包括人物/类人动物/部分纯动物/部分类人肢体比例的角色)通过 包含支持传入图片Base64编码或图片URL(确保可访问)。</p>
534
+ */
535
+ Image?: string;
536
+ /**
537
+ * <p>参考视频的获取链接。生成视频中的人物动作与参考视频一致。 视频内容需满足以下要求: 人物需要漏出清晰的上半身或全身的全部肢体及头部,避免遮挡 建议上传1人动作视频,2人及以上会取画面占比最大的人物动作进行生成 推荐使用真人动作,部分风格化的人物/类人肢体比例可以通过 动作视频一镜到底,角色始终出现在画面中,避免切镜、运镜等。否则会被截取 动作避免过快,相对平稳的动作生成效果更佳 视频文件支持.mp4/.mov,文件大小不超过100MB,仅支持长宽的边长均位于340px~3850px之间,上述校验不通过会返回错误码等信息 视频时长下限不短于3秒,时长上限与人物朝向参考(character_orientation)有关: 当人物朝向与视频中人物一致时,视频时长最长可达30秒; 当人物朝向与图片中人物一致时,视频时长最长可达10秒; 如果您的动作难度比较高、速度比较快,有一定概率生成不足上传视频时长的结果,因为模型只能提取有效动作时长进行生成,最短提取出3s可用连续动作即可生成。请注意,因此消耗的积分将无法退还,建议适当调整动作难度与速度 系统会校验视频内容,如有问题会返回错误码等信息。</p>
538
+ */
539
+ Video?: string;
540
+ /**
541
+ * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
542
+ */
543
+ Mode?: string;
544
+ /**
545
+ * <p>可选择是否保留视频原声 枚举值:yes,no 其中yes:保留视频原声 其中no:不保留视频原声。</p>
546
+ */
547
+ KeepOriginalSound?: string;
548
+ /**
549
+ * <p>生成视频中人物的朝向,可选择与图片一致或与视频一致 枚举值:image,video,其中: 其中image:与图片中人物朝向一致;此时参考视频时长不得超过10秒; 其中video:与视频中人物朝向一致;此时参考视频时长不得超过30秒; 引用主体时,生成的视频暂时只能参考视频中的人物朝向。</p>
550
+ */
551
+ CharacterOrientation?: string;
552
+ /**
553
+ * <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
554
+ */
555
+ ElementList?: Array<Element>;
556
+ /**
557
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
558
+ */
559
+ CallbackUrl?: string;
560
+ /**
561
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
562
+ */
563
+ LogoAdd?: number;
564
+ /**
565
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
566
+ */
567
+ LogoParam?: LogoParam;
568
+ }
569
+ /**
570
+ * SubmitVideoExtendKlingJob请求参数结构体
571
+ */
572
+ export interface SubmitVideoExtendKlingJobRequest {
573
+ /**
574
+ * <p>视频ID 支持通过文本、图片和视频延长生成的视频的ID(原视频不能超过3分钟) 请注意,基于目前的清理策略、视频生成30天之后会被清理,则无法进行延长</p>
575
+ */
576
+ VideoId: string;
577
+ /**
578
+ * <p>正向文本提示词 不能超过2500个字符</p>
579
+ */
580
+ Prompt?: string;
581
+ /**
582
+ * <p>负向文本提示词 不能超过2500个字符</p>
583
+ */
584
+ NegativePrompt?: string;
585
+ /**
586
+ * <p>提示词参考强度 取值范围:[0,1],数值越大参考强度越大</p>
587
+ */
588
+ CfgScale?: number;
589
+ /**
590
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
591
+ */
592
+ CallbackUrl?: string;
593
+ /**
594
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
595
+ */
596
+ LogoAdd?: number;
597
+ /**
598
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
599
+ */
600
+ LogoParam?: LogoParam;
601
+ }
602
+ /**
603
+ * SubmitTemplateToVideoJob返回参数结构体
604
+ */
605
+ export interface SubmitTemplateToVideoJobResponse {
606
+ /**
607
+ * <p>任务ID。</p>
608
+ */
609
+ JobId?: string;
610
+ /**
611
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
612
+ */
613
+ RequestId?: string;
614
+ }
615
+ /**
616
+ * SubmitTemplateToVideoJob请求参数结构体
617
+ */
618
+ export interface SubmitTemplateToVideoJobRequest {
619
+ /**
620
+ * <p>特效模板名称。请在 <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板列表</a> 中选择想要生成的特效对应的 template 名称。</p>
621
+ */
622
+ Template: string;
623
+ /**
624
+ * <p>参考图像,不同特效输入图片的数量详见: <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-图片要求说明</a></p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片格式:支持png、jpg、jpeg、webp、bmp、tiff</li><li>图片文件:大小不能超过10MB(base64后),图片分辨率不小于300×300px,不大于4096×4096,图片宽高比应在1:4 ~ 4:1之间</li></ul>
625
+ */
626
+ Images: Array<Image>;
627
+ /**
628
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
629
+ */
630
+ LogoAdd?: number;
631
+ /**
632
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
633
+ */
634
+ LogoParam?: LogoParam;
635
+ /**
636
+ * <p>视频输出分辨率,默认值:360p 。不同特效支持的清晰度及消耗积分数详见:<a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-单次调用消耗积分数列</a></p>
637
+ */
638
+ Resolution?: string;
639
+ /**
640
+ * <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
641
+ */
642
+ BGM?: boolean;
643
+ /**
644
+ * <p>扩展字段。</p>
645
+ */
646
+ ExtraParam?: ExtraParam;
647
+ }
648
+ /**
649
+ * 水印图输入框
650
+ */
651
+ export interface LogoRect {
652
+ /**
653
+ * <p>水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。</p>
654
+ */
655
+ X?: number;
656
+ /**
657
+ * <p>水印图框Y坐标值。当值大于0时,坐标轴原点位于原图上侧,方向指下;当值小于0时,坐标轴原点位于原图下侧,方向指上。</p>
658
+ */
659
+ Y?: number;
660
+ /**
661
+ * <p>水印图框宽度。<br>单位:px</p>
662
+ */
663
+ Width?: number;
664
+ /**
665
+ * <p>水印图框高度。<br>单位:px</p>
666
+ */
667
+ Height?: number;
668
+ }
669
+ /**
670
+ * DescribeVideoEditKlingJob请求参数结构体
671
+ */
672
+ export interface DescribeVideoEditKlingJobRequest {
673
+ /**
674
+ * <p>任务ID</p>
675
+ */
676
+ JobId: string;
677
+ }
678
+ /**
679
+ * SubmitVideoVoiceJob请求参数结构体
680
+ */
681
+ export interface SubmitVideoVoiceJobRequest {
682
+ /**
683
+ * 输入视频的Url 上传视频时长限制:1-15s 视频格式:MP4,MOV 视频大小:不超过1 GB URL地址中不能包含中文字符。
684
+ */
685
+ VideoUrl?: string;
686
+ /**
687
+ * 描述音效内容的正向提示词。输入上限50个字符。
688
+ */
689
+ Prompt?: string;
690
+ /**
691
+ * 音效内容的原始负向提示词。输入上限50个字符。
692
+ */
693
+ NegativePrompt?: string;
694
+ /**
695
+ * 为生成视频添加标识的开关,默认为1。 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。 建议您使用显著标识来提示,该视频是 AI 生成的视频。
696
+ */
697
+ LogoAdd?: number;
698
+ /**
699
+ * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
700
+ */
701
+ LogoParam?: LogoParam;
702
+ }
703
+ /**
704
+ * DescribeTextToVideoJob返回参数结构体
705
+ */
706
+ export interface DescribeTextToVideoJobResponse {
707
+ /**
708
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
709
+ */
710
+ Status?: string;
711
+ /**
712
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
713
+ */
714
+ ErrorCode?: string;
715
+ /**
716
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
717
+ */
718
+ ErrorMessage?: string;
719
+ /**
720
+ * <p>结果视频 URL。有效期 24 小时。</p>
721
+ */
722
+ ResultVideoUrl?: string;
723
+ /**
724
+ * <p>视频id</p>
725
+ */
726
+ VideoId?: string;
727
+ /**
728
+ * <p>视频总时长,单位s</p>
729
+ */
730
+ Duration?: string;
731
+ /**
732
+ * <p>任务最终扣减积分数值</p>
733
+ */
734
+ FinalUnitDeduction?: string;
735
+ /**
736
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
737
+ */
738
+ RequestId?: string;
739
+ }
740
+ /**
741
+ * 扩展字段。
742
+ */
743
+ export interface ExtraParam {
744
+ /**
745
+ * <p>预签名的上传url,支持把视频直接传到客户指定的地址。</p>
746
+ */
747
+ UserDesignatedUrl?: string;
748
+ /**
749
+ * <p>回调地址<br>需要您在创建任务时主动设置 CallbackUrl,请求方法为 POST,当视频生成结束时,我们将向此地址发送生成结果。<br>数据格式如下:<br>{<br> &quot;JobId&quot;: &quot;1397428070633955328&quot;,<br> &quot;Status&quot;: &quot;DONE&quot;,<br> &quot;ErrorCode&quot;: &quot;&quot;,<br> &quot;ErrorMessage&quot;: &quot;&quot;,<br> &quot;ResultVideoUrl&quot;: &quot;https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4&quot;<br>}</p>
750
+ */
751
+ CallbackUrl?: string;
752
+ /**
753
+ * <p>BGM音频文本。</p>
754
+ */
755
+ BGMText?: string;
756
+ }
757
+ /**
758
+ * DescribeVideoEditJob返回参数结构体
759
+ */
760
+ export interface DescribeVideoEditJobResponse {
761
+ /**
762
+ * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
763
+ */
764
+ Status?: string;
765
+ /**
766
+ * 结果视频URL。有效期 24 小时。
767
+ */
768
+ ResultVideoUrl?: string;
769
+ /**
770
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
771
+ */
772
+ ErrorCode?: string;
773
+ /**
774
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
775
+ */
776
+ ErrorMessage?: string;
777
+ /**
778
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
779
+ */
780
+ RequestId?: string;
781
+ }
782
+ /**
783
+ * SubmitVideoStylizationJob返回参数结构体
784
+ */
785
+ export interface SubmitVideoStylizationJobResponse {
786
+ /**
787
+ * 任务ID。任务有效期为48小时。
788
+ */
789
+ JobId?: string;
790
+ /**
791
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
792
+ */
793
+ RequestId?: string;
794
+ }
795
+ /**
796
+ * SubmitVideoFaceFusionJob请求参数结构体
797
+ */
798
+ export interface SubmitVideoFaceFusionJobRequest {
799
+ /**
800
+ * 视频素材下载地址。用户自定义模板视频下载地址,使用前需要先调用视频审核接口进行内容审核。视频限制:分辨率≤4k,fps≤25,视频大小≤1G,时长≤20 秒,支持格式mp4。
801
+
802
+ 输入视频建议:
803
+ 姿态:人脸相对镜头水平方向角度转动不超过 90°,垂直方向角度转动不超过 20°。遮挡:脸部遮挡面积不超过 50%,不要完全遮挡五官,不要有半透明遮挡(强光,玻璃,透明眼镜等)、以及细碎离散的脸部遮挡(如飘落的花瓣)。妆容及光照:避免浓妆、复杂妆容,避免复杂光照、闪烁,这些属性无法完全恢复,并对稳定性有影响。针对特殊表情和微表情,针对局部肌肉控制下的微表情,以及过于夸张的特殊表情等不保证表情效果完全恢复。
804
+ */
805
+ VideoUrl?: string;
806
+ /**
807
+ * 视频素材模板的人脸位置信息。
808
+ 目前最多支持融合视频素材中的 6 张人脸
809
+ 输入图片要求:
810
+ 1、用户图限制大小不超过 10MB
811
+ 2、图片最大分辨率不超过 4k,建议最小为 128, 人脸框最小为 68
812
+ 3、支持格式 jpg,png
813
+ 4、如果用户图中未指定人脸且有多张人脸, 默认融合最大人脸
814
+ 输入图片建议: 包含上述视频中出现的人物的单人照,并且正面、清晰、无遮挡
815
+ */
816
+ TemplateInfos?: Array<FaceTemplateInfo>;
817
+ /**
818
+ * 用户人脸图片位置信息。
819
+ 输入图片要求:
820
+ 1、用户图限制大小不超过 10MB
821
+ 2、图片最大分辨率不超过 4k,建议最小为 128,人脸框最小为 68
822
+ 3、支持格式 jpg,png
823
+ 4、如果未指定人脸且用户图中有多张人脸,
824
+ 默认融合最大人脸
825
+ 输入图建议:
826
+ 正脸无遮挡
827
+ */
828
+ MergeInfos?: Array<FaceMergeInfo>;
829
+ /**
830
+ * 为生成视频添加标识的开关,默认为1。
831
+ 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。
832
+ 建议您使用显著标识来提示,该视频是 AI 生成的视频。
833
+ */
834
+ LogoAdd?: number;
835
+ /**
836
+ * 视频水印Logo参数标识内容设置。
837
+ 默认在融合结果图右下角添加“AI生成”类似字样,您可根据自身需要替换为其他的Logo图片。
838
+ 输入建议:输入水印图片宽高需小于视频宽高
839
+ */
840
+ LogoParam?: LogoParam;
841
+ }
842
+ /**
843
+ * SubmitReferenceToVideoViduJob请求参数结构体
844
+ */
845
+ export interface SubmitReferenceToVideoViduJobRequest {
846
+ /**
847
+ * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:使用Subjects主体参数时,可以通过@主体id 来表示主体内容,例如:&quot;@1 和 @2 在一起吃火锅,并且旁白音说火锅大家都爱吃。&quot;</p>
848
+ */
849
+ Prompt: string;
850
+ /**
851
+ * <p>图像参考<br>【非主体调用时传入】<br>支持上传1~7张图片,模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。<br>支持传入图片 Base64 编码或图片URL(确保可访问)<br>图片支持 png、jpeg、jpg、webp格式<br>图片像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过50M。</p>
852
+ */
853
+ Images?: Array<string>;
854
+ /**
855
+ * <p>参考生图主体信息,支持1-7个主体,主体图片共1 ~ 7张<br>【主体调用时传入】</p>
856
+ */
857
+ Subjects?: Array<ReferenceSubject>;
858
+ /**
859
+ * <p>视频参考支持上传1~2个视频,模型将以此参数中传入的视频作为参考,生成具备主体一致的视频。<br>注1: 仅viduq2-pro模型支持该参数<br>注2:使用视频参考功能时,最多支持上传 1个8秒 视频 或 2个5秒 视频<br>注3:视频支持 mp4、avi、mov格式<br>注4:视频像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过100M。</p>
860
+ */
861
+ Videos?: Array<string>;
862
+ /**
863
+ * <p>模型名称,可选值,当前仅可并且默认viduq2</p><ul><li>viduq2:最新模型</li></ul>
864
+ */
865
+ Model?: string;
866
+ /**
867
+ * <p>是否使用音视频直出能力,默认false,可选值 true、false</p><ul><li>true:使用音视频直出能力。</li><li>false:不使用音视频直出能力。<br>仅上传主体时支持此功能</li></ul>
868
+ */
869
+ Audio?: boolean;
870
+ /**
871
+ * <p>音频类型,audio为true时必填,默认为all</p><p>枚举值:</p><ul><li>all: 音效+人声</li><li>speech_only: 仅人声</li><li>sound_effect_only: 仅音效</li></ul>
872
+ */
873
+ AudioType?: string;
874
+ /**
875
+ * <p>是否为生成的视频添加背景音乐。<br>默认:false,可选值 true 、false<br>【仅支持非主体调用时生效】</p><ul><li>传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</li><li>BGM不限制时长,系统根据视频时长自动适配</li><li>BGM参数在q2系列模型的duration为 9秒 或 10秒 时不生效</li></ul>
876
+ */
877
+ Bgm?: boolean;
878
+ /**
879
+ * <p>视频时长参数:<br>默认5秒,可选:1-10(整数)</p>
880
+ */
881
+ Duration?: number;
882
+ /**
883
+ * <p>比例<br>默认值:16:9<br>【非主体调用时】<br>可选值如下:16:9、9:16、4:3、3:4、1:1</p><p>【主体调用时】<br>可选值如下:16:9、9:16、1:1<br>注:q2模型 支持任意宽高比</p>
884
+ */
885
+ AspectRatio?: string;
886
+ /**
887
+ * <p>分辨率参数<br>默认 720p, 可选:540p、720p、1080p</p>
888
+ */
889
+ Resolution?: string;
890
+ /**
891
+ * <p>运动幅度默认 auto,可选值:auto、small、medium、large<br>注:使用q2系列模型时该参数不生效</p>
892
+ */
893
+ MovementAmplitude?: string;
894
+ /**
895
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,&quot;ContentProducer&quot;: &quot;yourcontentproducer&quot;,&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,&quot;ProduceID&quot;: &quot;yourproductid&quot;, &quot;PropagateID&quot;: &quot;your_propagate_id&quot;,&quot;ReservedCode1&quot;: &quot;yourreservedcode1&quot;, &quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
896
+ */
897
+ MetaData?: string;
898
+ /**
899
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
900
+ */
901
+ CallbackUrl?: string;
902
+ /**
903
+ * <p>透传参数不做任何处理,仅数据传输注:最多 1048576个字符</p>
904
+ */
905
+ Payload?: string;
906
+ /**
907
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
908
+ */
909
+ OffPeak?: boolean;
910
+ /**
911
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
912
+ */
913
+ LogoAdd?: number;
914
+ /**
915
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
916
+ */
917
+ LogoParam?: LogoParam;
918
+ }
919
+ /**
920
+ * SubmitImageToVideoGeneralJob请求参数结构体
921
+ */
922
+ export interface SubmitImageToVideoGeneralJobRequest {
923
+ /**
924
+ * 输入图片
925
+ Base64 和 Url 必须提供一个,如果都提供以ImageUrl为准。
926
+ 上传图url大小不超过 8M
927
+ 支持jpg,png,jpeg,webp,bmp,tiff 格式
928
+ 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
929
+ */
930
+ Image: Image;
931
+ /**
932
+ * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。
933
+ */
934
+ Prompt?: string;
935
+ /**
936
+ * 输出视频分辨率。可选择:480p、720p、1080p。
937
+ */
938
+ Resolution?: string;
939
+ /**
940
+ * 生成视频的帧率,从16, 24, 30中选择。默认值:30
941
+ */
942
+ Fps?: number;
943
+ /**
944
+ * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
945
+ */
946
+ LogoAdd?: number;
947
+ /**
948
+ * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
949
+ */
950
+ LogoParam?: LogoParam;
951
+ }
952
+ /**
953
+ * SubmitImageToVideoViduJob请求参数结构体
954
+ */
955
+ export interface SubmitImageToVideoViduJobRequest {
956
+ /**
957
+ * <p>上传单张图时【首帧生视频】:</p><p>模型将以此参数中传入的图片为首帧画面来生成视频。<br>注1:支持传入图片 Base64 编码或图片URL(确保可访问);<br>注2:支持上传1 张图;<br>注3:图片支持 png、jpeg、jpg、webp格式;<br>注4:图片比例需要小于 1:4 或者 4:1 ;<br>注5:图片大小不超过50M。</p><p>上传两张图时【首尾帧生视频】:<br>上传的第一张图片视作首帧图,第二张图片视作尾帧图,模型将以此参数中传入的图片来生成视频<br>注1: 首尾帧两张输入图的分辨率需相近,首帧图的分辨率/尾帧图的分辨率要在0.8~1.25之间。且图片比例需要小于1:4或者4:1;<br>注2: 支持传入图片 Base64 编码或图片URL(确保可访问);<br>注3: 图片支持 png、jpeg、jpg、webp格式;<br>注4: 图片大小不超过50M;</p>
958
+ */
959
+ Images: Array<string>;
960
+ /**
961
+ * <p>模型名称,可选值,默认值viduq2-turbo</p><ul><li>viduq2-pro:新模型,效果好,细节丰富</li><li>viduq2-turbo:新模型,效果好,生成快</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
962
+ */
963
+ Model?: string;
964
+ /**
965
+ * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:若使用is_rec推荐提示词参数,模型将不考虑此参数所输入的提示词</p>
966
+ */
967
+ Prompt?: string;
968
+ /**
969
+ * <p>是否使用推荐提示词,默认关闭<br>-true:是,由系统自动推荐提示词,并使用提示词内容生成视频,推荐提示词数量=1<br>-false:否,根据输入的prompt生成视频<br>注意:启用推荐提示词后,每个任务多消耗1积分</p>
970
+ */
971
+ IsRec?: boolean;
972
+ /**
973
+ * <p>【首帧生视频】</p><p>是否使用音视频直出能力,默认关闭,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音视频直出,输出带台词以及背景音的视频<br>注1:该参数为true时,voice_id参数才生效<br>注2:该参数为true时,仅q3模型支持错峰<br>注3:当model 为q3-pro或q3-turbo 时,该参数默认值为true</li></ul><p>【首尾帧生视频】</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
974
+ */
975
+ Audio?: boolean;
976
+ /**
977
+ * <p>音色id<br>用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:新音色列表<br>暂不支持声音复刻功能</p>
978
+ */
979
+ VoiceId?: string;
980
+ /**
981
+ * <p>视频时长参数:<br>【首帧生视频】:<br>viduq3-pro、viduq3-turboxa0默认为 5,可选:1 - 16<br>viduq2-pro、viduq2-turboxa0默认为 5,可选:1 - 10</p><p>【首尾帧生视频】:<br>viduq3-proxa0、viduq3-turbo默认为 5,可选:1 - 16<br>viduq2-pro、viduq2-turboxa0默认为 5,可选:1 - 8</p>
982
+ */
983
+ Duration?: number;
984
+ /**
985
+ * <p>分辨率参数<br>【首帧生视频】:</p><ul><li>viduq3-pro 、viduq3-turbo 1-16秒:默认 720p,可选:540p、720p、1080p</li><li>viduq2-pro、viduq2-turbo 1-10秒:默认 720p,可选:720p、1080p<br>示例值:720p</li></ul><p>【首尾帧生视频】:<br>-xa0viduq3-proxa0、viduq3-turbo1-16秒:默认 720p,可选:540p、720p、1080p<br>-xa0viduq2-proxa0、xa0viduq2-turbo1-8秒:默认 720p,可选:540p、720p、1080p</p>
986
+ */
987
+ Resolution?: string;
988
+ /**
989
+ * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:q2、q3系列模型改参数不生效</p>
990
+ */
991
+ MovementAmplitude?: string;
992
+ /**
993
+ * <p>bgm</p>
994
+ */
995
+ Bgm?: boolean;
996
+ /**
997
+ * <p>音频类型,audio为true时必填,默认为all<br>注:该参数目前仅支持q2、q1、2.0系列模型的音频拆分</p><p>枚举值:</p><ul><li>all: 音效+人声</li><li>speech_only: 仅人声</li><li>sound_effect_only: 仅音效</li></ul>
998
+ */
999
+ AudioType?: string;
1000
+ /**
1001
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
1002
+ */
1003
+ MetaData?: string;
1004
+ /**
1005
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
1006
+ */
1007
+ CallbackUrl?: string;
1008
+ /**
1009
+ * <p>透传参数<br>不做任何处理,仅数据传输<br>注:最多 1048576个字符</p>
1010
+ */
1011
+ Payload?: string;
1012
+ /**
1013
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
1014
+ */
1015
+ OffPeak?: boolean;
1016
+ /**
1017
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
1018
+ */
1019
+ LogoAdd?: number;
1020
+ /**
1021
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1022
+ */
1023
+ LogoParam?: LogoParam;
1024
+ }
1025
+ /**
1026
+ * DescribeHumanActorJob请求参数结构体
1027
+ */
1028
+ export interface DescribeHumanActorJobRequest {
1029
+ /**
1030
+ * 任务ID。
1031
+ */
1032
+ JobId: string;
1033
+ }
1034
+ /**
1035
+ * DescribeImageToVideoGeneralJob请求参数结构体
1036
+ */
1037
+ export interface DescribeImageToVideoGeneralJobRequest {
1038
+ /**
1039
+ * 任务ID
1040
+ */
1041
+ JobId: string;
1042
+ }
1043
+ /**
1044
+ * SubmitAigcVideoJob返回参数结构体
1045
+ */
1046
+ export interface SubmitAigcVideoJobResponse {
1047
+ /**
1048
+ * <p>任务ID。</p>
1049
+ */
1050
+ JobId?: string;
1051
+ /**
1052
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1053
+ */
1054
+ RequestId?: string;
1055
+ }
1056
+ /**
1057
+ * SubmitVideoVoiceJob返回参数结构体
1058
+ */
1059
+ export interface SubmitVideoVoiceJobResponse {
1060
+ /**
1061
+ * 任务ID。
1062
+ */
1063
+ JobId?: string;
1064
+ /**
1065
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1066
+ */
1067
+ RequestId?: string;
1068
+ }
1069
+ /**
1070
+ * SubmitImageToVideoViduJob返回参数结构体
1071
+ */
1072
+ export interface SubmitImageToVideoViduJobResponse {
1073
+ /**
1074
+ * <p>任务ID。</p>
1075
+ */
1076
+ JobId?: string;
1077
+ /**
1078
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1079
+ */
1080
+ RequestId?: string;
1081
+ }
1082
+ /**
1083
+ * SubmitPortraitSingJob返回参数结构体
1084
+ */
1085
+ export interface SubmitPortraitSingJobResponse {
1086
+ /**
1087
+ * 任务ID。任务有效期为48小时。
1088
+ */
1089
+ JobId?: string;
1090
+ /**
1091
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1092
+ */
1093
+ RequestId?: string;
1094
+ }
1095
+ /**
1096
+ * DescribeImageToVideoJob返回参数结构体
1097
+ */
1098
+ export interface DescribeImageToVideoJobResponse {
1099
+ /**
1100
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1101
+ */
1102
+ Status?: string;
1103
+ /**
1104
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1105
+ */
1106
+ ErrorCode?: string;
1107
+ /**
1108
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1109
+ */
1110
+ ErrorMessage?: string;
1111
+ /**
1112
+ * <p>结果视频 URL。有效期 24 小时。</p>
1113
+ */
1114
+ ResultVideoUrl?: string;
1115
+ /**
1116
+ * <p>视频id</p>
1117
+ */
1118
+ VideoId?: string;
1119
+ /**
1120
+ * <p>视频总时长,单位s</p>
1121
+ */
1122
+ Duration?: string;
1123
+ /**
1124
+ * <p>任务最终扣减积分数值</p>
1125
+ */
1126
+ FinalUnitDeduction?: string;
1127
+ /**
1128
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1129
+ */
1130
+ RequestId?: string;
1131
+ }
1132
+ /**
1133
+ * DescribePortraitSingJob请求参数结构体
1134
+ */
1135
+ export interface DescribePortraitSingJobRequest {
1136
+ /**
1137
+ * 任务ID
1138
+ */
1139
+ JobId: string;
1140
+ }
1141
+ /**
1142
+ * DescribeHunyuanToVideoJob请求参数结构体
1143
+ */
1144
+ export interface DescribeHunyuanToVideoJobRequest {
1145
+ /**
1146
+ * 任务ID
1147
+ */
1148
+ JobId: string;
1149
+ }
1150
+ /**
1151
+ * DescribeMotionControlKlingJob请求参数结构体
1152
+ */
1153
+ export interface DescribeMotionControlKlingJobRequest {
1154
+ /**
1155
+ * <p>任务ID</p>
1156
+ */
1157
+ JobId: string;
1158
+ }
1159
+ /**
1160
+ * CheckAnimateImageJob返回参数结构体
1161
+ */
1162
+ export interface CheckAnimateImageJobResponse {
1163
+ /**
1164
+ * 输入图是否通过校验。
1165
+ */
1166
+ CheckPass?: boolean;
1167
+ /**
1168
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1169
+ */
1170
+ RequestId?: string;
1171
+ }
1172
+ /**
1173
+ * SubmitVideoEditJob返回参数结构体
1174
+ */
1175
+ export interface SubmitVideoEditJobResponse {
1176
+ /**
1177
+ * <p>任务ID。</p>
1178
+ */
1179
+ JobId?: string;
1180
+ /**
1181
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1182
+ */
1183
+ RequestId?: string;
1184
+ }
1185
+ /**
1186
+ * DescribeVideoStylizationJob请求参数结构体
1187
+ */
1188
+ export interface DescribeVideoStylizationJobRequest {
1189
+ /**
1190
+ * 任务ID
1191
+ */
1192
+ JobId: string;
1193
+ }
1194
+ /**
1195
+ * SubmitHumanActorJob返回参数结构体
1196
+ */
1197
+ export interface SubmitHumanActorJobResponse {
1198
+ /**
1199
+ * 任务ID。
1200
+ */
1201
+ JobId?: string;
1202
+ /**
1203
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1204
+ */
1205
+ RequestId?: string;
1206
+ }
1207
+ /**
1208
+ * 视频编辑参数
1209
+ */
1210
+ export interface VideoEditParam {
1211
+ /**
1212
+ * 魔法词,针对特定场景生效。不同场景传不同的值。默认不传。
1213
+ - 换人场景:1
1214
+ */
1215
+ Magic?: string;
1216
+ }
1217
+ /**
1218
+ * 参考主体,主要用作参考图生视频。由主体id、主体图(三视图)以及声音组成。
1219
+ */
1220
+ export interface ReferenceSubject {
1221
+ /**
1222
+ * <p>主体id,后续生成时在提示词中可以通过@主体id的方式使用。</p>
1223
+ */
1224
+ Id: string;
1225
+ /**
1226
+ * <p>该主体对应的图片url,每个主体最多支持3张图片<br>注1:支持传入图片URL(确保可访问)<br>注2:图片支持 png、jpeg、jpg、webp格式<br>注3:图片像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过50M。</p>
1227
+ */
1228
+ Images: Array<string>;
1229
+ /**
1230
+ * <p>主体id,后续生成时可以通过@主体id的方式使用</p>
1231
+ */
1232
+ Name?: string;
1233
+ /**
1234
+ * <p>主体视频,该主体对应的视频url,与videos必填一个<br>注1: 仅viduq2-pro模型支持使用视频主体<br>注2:每个主体中的图片和视频,共享3个槽位<br>注3:支持1个5秒视频<br>注4:支持传入视频 URL(确保可访问)<br>注5:视频支持 mp4、avi、mov格式<br>注6:视频像素不能小于 128*128,且比例需要小于1:4或者4:1<br>注7:请注意,base64 decode之后的字节长度需要小于20M,且编码必须包含适当的内容类型字符串</p>
1235
+ */
1236
+ Videos?: Array<string>;
1237
+ /**
1238
+ * <p>音色ID用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:[音色列表](URL https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg)</p>
1239
+ */
1240
+ VoiceId?: string;
1241
+ }
1242
+ /**
1243
+ * 参考图列表
1244
+ */
1245
+ export interface ImageInfo {
1246
+ /**
1247
+ * 图片URL
1248
+ */
1249
+ ImageUrl: string;
1250
+ /**
1251
+ * 首帧:first_frame
1252
+ 尾帧:end_frame
1253
+ 其他:空
1254
+
1255
+ */
1256
+ Type?: string;
1257
+ }
1258
+ /**
1259
+ * 图片
1260
+ */
1261
+ export interface Image {
1262
+ /**
1263
+ * 图片Base64
1264
+ */
1265
+ Base64?: string;
1266
+ /**
1267
+ * 图片Url
1268
+ */
1269
+ Url?: string;
1270
+ }
1271
+ /**
1272
+ * DescribeMotionControlKlingJob返回参数结构体
1273
+ */
1274
+ export interface DescribeMotionControlKlingJobResponse {
1275
+ /**
1276
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1277
+ */
1278
+ Status?: string;
1279
+ /**
1280
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1281
+ */
1282
+ ErrorCode?: string;
1283
+ /**
1284
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1285
+ */
1286
+ ErrorMessage?: string;
1287
+ /**
1288
+ * <p>结果视频 URL。有效期 24 小时。</p>
1289
+ */
1290
+ ResultVideoUrl?: string;
1291
+ /**
1292
+ * <p>视频时长。</p>
1293
+ */
1294
+ Duration?: string;
1295
+ /**
1296
+ * <p>消耗积分数。</p>
1297
+ */
1298
+ FinalUnitDeduction?: string;
1299
+ /**
1300
+ * <p>视频id</p>
1301
+ */
1302
+ VideoId?: string;
1303
+ /**
1304
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1305
+ */
1306
+ RequestId?: string;
1307
+ }
1308
+ /**
1309
+ * 参考视频信息
1310
+ */
1311
+ export interface ReferVideoInfo {
1312
+ /**
1313
+ * 视频地址
1314
+ */
1315
+ VideoUrl?: string;
1316
+ /**
1317
+ * 视频类型
1318
+ feature为特征参考视频
1319
+ base为待编辑视频
1320
+ */
1321
+ ReferType?: string;
1322
+ /**
1323
+ * 否保留视频原声,yes为保留,no为不保留;
1324
+ 当前参数对特征参考视频(feature)也生效。
1325
+ */
1326
+ KeepOriginalSound?: string;
1327
+ }
1328
+ /**
1329
+ * SubmitAigcVideoJob请求参数结构体
1330
+ */
1331
+ export interface SubmitAigcVideoJobRequest {
1332
+ /**
1333
+ * <p>模型名称。</p><p>枚举值:</p><p>● Vidu;</p><p>● Kling:可灵;</p><p>● HY:混元;</p><p>● YT:优图;</p><p>示例值:Vidu</p>
1334
+ */
1335
+ Vendor: string;
1336
+ /**
1337
+ * <p>模型版本。</p><p>枚举值:</p><p>● 当Vendor为Vidu时,可选值[q2, q2-pro, q2-turbo, q3-pro, q3-turbo]</p><p>● 当Vendor为Kling时,可选值[v1.6, v2.0, v2.1, v2.5, v2.6]</p><p>● 当Vendor为HY时,默认值:[v1.5]</p><p>● 当Vendor为YT时,默认值:[v2.0]</p>
1338
+ */
1339
+ Model: string;
1340
+ /**
1341
+ * <p>模型参数Json-Format字符串<br> <a href="https://cloud.tencent.com/document/product/1616/128996">模型参数列表</a></p>
1342
+ */
1343
+ ModelParam?: string;
1344
+ /**
1345
+ * <p>正向文本提示词。不能超过2000个字符</p><p>示例值:一只小猫在草地奔跑</p>
1346
+ */
1347
+ Prompt?: string;
1348
+ /**
1349
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
1350
+ */
1351
+ LogoAdd?: number;
1352
+ /**
1353
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1354
+ */
1355
+ LogoParam?: LogoParam;
1356
+ }
1357
+ /**
1358
+ * SubmitReferenceToVideoViduJob返回参数结构体
1359
+ */
1360
+ export interface SubmitReferenceToVideoViduJobResponse {
1361
+ /**
1362
+ * <p>任务ID。</p>
1363
+ */
1364
+ JobId?: string;
1365
+ /**
1366
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1367
+ */
1368
+ RequestId?: string;
1369
+ }
1370
+ /**
1371
+ * logo参数
1372
+ */
1373
+ export interface LogoParam {
1374
+ /**
1375
+ * 水印 Url
1376
+ */
1377
+ LogoUrl?: string;
1378
+ /**
1379
+ * 水印 Base64,Url 和 Base64 二选一传入,如果都提供以 Url 为准
1380
+ */
1381
+ LogoImage?: string;
1382
+ /**
1383
+ * 水印图片位于生成结果图中的坐标及宽高,将按照坐标对标识图片进行位置和大小的拉伸匹配。
1384
+ */
1385
+ LogoRect?: LogoRect;
1386
+ }
1387
+ /**
1388
+ * 模板信息
1389
+ */
1390
+ export interface FaceTemplateInfo {
1391
+ /**
1392
+ * 角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字,建议填"0"、"1",依次累加。
1393
+ */
1394
+ TemplateFaceID?: string;
1395
+ /**
1396
+ * 视频模板中要替换的人脸图片
1397
+ */
1398
+ TemplateFaceImage?: Image;
1399
+ /**
1400
+ * 视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。
1401
+ */
1402
+ TemplateFaceRect?: FaceRect;
1403
+ }
1404
+ /**
1405
+ * DescribeAigcVideoJob请求参数结构体
1406
+ */
1407
+ export interface DescribeAigcVideoJobRequest {
1408
+ /**
1409
+ * 任务ID。
1410
+
1411
+ 示例值:1194931538865782784
1412
+ */
1413
+ JobId?: string;
1414
+ }
1415
+ /**
1416
+ * SubmitImageAnimateJob请求参数结构体
1417
+ */
1418
+ export interface SubmitImageAnimateJobRequest {
1419
+ /**
1420
+ * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1421
+ 图片分辨率:长边分辨率范围【192,4096】;
1422
+ 图片大小:不超过10M;
1423
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1424
+ */
1425
+ ImageUrl?: string;
1426
+ /**
1427
+ * 图片base64数据。
1428
+ 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1429
+ 图片分辨率:长边分辨率范围【192,4096】;
1430
+ 图片大小:不超过10M;
1431
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1432
+ */
1433
+ ImageBase64?: string;
1434
+ /**
1435
+ * 动作模板ID。取值说明:ke3 科目三;tuziwu 兔子舞;huajiangwu 划桨舞。
1436
+
1437
+ */
1438
+ TemplateId?: string;
1439
+ /**
1440
+ * 结果视频是否保留模板音频。默认为true
1441
+ */
1442
+ EnableAudio?: boolean;
1443
+ /**
1444
+ * 是否对输入图采用加强检测方案。
1445
+
1446
+ 默认不加强检测(false),仅对输入图做必要的基础检测。
1447
+
1448
+ 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
1449
+ */
1450
+ EnableBodyJoins?: boolean;
1451
+ /**
1452
+ * 是否对结果视频背景进行分割,默认值为false。
1453
+ true:分割结果视频,结果视频(ResultVideoUrl)将为去除背景的绿幕视频,并返回掩码视频(MaskVideoUrl);
1454
+ false:不分割结果视频,结果视频(ResultVideoUrl)为带背景的视频,掩码视频(MaskVideoUrl)为空字符串。
1455
+ */
1456
+ EnableSegment?: boolean;
1457
+ /**
1458
+ * 为生成视频添加标识的开关,默认为0。
1459
+ 1:添加标识。
1460
+ 0:不添加标识。
1461
+ 其他数值:默认按1处理。
1462
+ 建议您使用显著标识来提示,该视频是 AI 生成的视频。
1463
+ */
1464
+ LogoAdd?: number;
1465
+ /**
1466
+ * 标识内容设置。
1467
+ 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
1468
+ */
1469
+ LogoParam?: LogoParam;
1470
+ /**
1471
+ * 是否开启人脸检测。
1472
+
1473
+ 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
1474
+ */
1475
+ EnableFace?: boolean;
1476
+ }
1477
+ /**
1478
+ * DescribeVideoFaceFusionJob请求参数结构体
400
1479
  */
401
- export interface FaceRect {
1480
+ export interface DescribeVideoFaceFusionJobRequest {
402
1481
  /**
403
- * <p>人脸框左上角横坐标。</p>
1482
+ * 任务ID
404
1483
  */
405
- X?: number;
1484
+ JobId?: string;
1485
+ }
1486
+ /**
1487
+ * DescribeImageToVideoViduJob请求参数结构体
1488
+ */
1489
+ export interface DescribeImageToVideoViduJobRequest {
406
1490
  /**
407
- * <p>人脸框左上角纵坐标。</p>
1491
+ * <p>任务ID</p>
408
1492
  */
409
- Y?: number;
1493
+ JobId: string;
1494
+ }
1495
+ /**
1496
+ * SubmitVideoEditKlingJob返回参数结构体
1497
+ */
1498
+ export interface SubmitVideoEditKlingJobResponse {
410
1499
  /**
411
- * <p>人脸框宽度。<br>单位:px</p>
1500
+ * <p>任务ID</p>
412
1501
  */
413
- Width?: number;
1502
+ JobId?: string;
414
1503
  /**
415
- * <p>人脸框高度。<br>单位:px</p>
1504
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
416
1505
  */
417
- Height?: number;
1506
+ RequestId?: string;
418
1507
  }
419
1508
  /**
420
- * DescribePortraitSingJob请求参数结构体
1509
+ * 指定摄像机在不同方向上的运动或变化
421
1510
  */
422
- export interface DescribePortraitSingJobRequest {
1511
+ export interface CameraControlConfig {
423
1512
  /**
424
- * 任务ID
1513
+ * 水平运镜,控制摄像机在水平方向上的移动量(沿x轴平移)
1514
+
1515
+ 取值范围:[-10, 10],负值表示向左平移,正值表示向右平移
425
1516
  */
426
- JobId: string;
1517
+ Horizontal?: number;
1518
+ /**
1519
+ * 垂直运镜,控制摄像机在垂直方向上的移动量(沿y轴平移)
1520
+
1521
+ 取值范围:[-10, 10],负值表示向下平移,正值表示向上平移
1522
+ */
1523
+ Vertical?: number;
1524
+ /**
1525
+ * 水平摇镜,控制摄像机在水平面上的旋转量(绕y轴旋转)
1526
+
1527
+ 取值范围:[-10, 10],负值表示绕y轴向左旋转,正值表示绕y轴向右旋转
1528
+ */
1529
+ Pan?: number;
1530
+ /**
1531
+ * 垂直摇镜,控制摄像机在垂直面上的旋转量(沿x轴旋转)
1532
+
1533
+ 取值范围:[-10, 10],负值表示绕x轴向下旋转,正值表示绕x轴向上旋转
1534
+ */
1535
+ Tilt?: number;
1536
+ /**
1537
+ * 旋转运镜,控制摄像机的滚动量(绕z轴旋转)
1538
+
1539
+ 取值范围:[-10, 10],负值表示绕z轴逆时针旋转,正值表示绕z轴顺时针旋转
1540
+ */
1541
+ Roll?: number;
1542
+ /**
1543
+ * 变焦,控制摄像机的焦距变化,影响视野的远近
1544
+
1545
+ 取值范围:[-10, 10],负值表示焦距变长、视野范围变小,正值表示焦距变短、视野范围变大
1546
+ */
1547
+ Zoom?: number;
427
1548
  }
428
1549
  /**
429
- * DescribeHunyuanToVideoJob请求参数结构体
1550
+ * DescribeReferenceToVideoViduJob请求参数结构体
430
1551
  */
431
- export interface DescribeHunyuanToVideoJobRequest {
1552
+ export interface DescribeReferenceToVideoViduJobRequest {
432
1553
  /**
433
- * 任务ID
1554
+ * <p>任务ID</p>
434
1555
  */
435
1556
  JobId: string;
436
1557
  }
437
1558
  /**
438
- * SubmitVideoFaceFusionJob返回参数结构体
1559
+ * DescribeImageAnimateJob返回参数结构体
439
1560
  */
440
- export interface SubmitVideoFaceFusionJobResponse {
1561
+ export interface DescribeImageAnimateJobResponse {
441
1562
  /**
442
- * 视频人脸融合任务的job id(job有效期24小时)
1563
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
443
1564
  */
444
- JobId?: string;
1565
+ Status?: string;
1566
+ /**
1567
+ * 错误码。
1568
+ */
1569
+ ErrorCode?: string;
1570
+ /**
1571
+ * 错误信息。
1572
+ */
1573
+ ErrorMessage?: string;
1574
+ /**
1575
+ * 结果视频URL。有效期 24 小时。
1576
+ */
1577
+ ResultVideoUrl?: string;
1578
+ /**
1579
+ * 掩码视频链接
1580
+ */
1581
+ MaskVideoUrl?: string;
445
1582
  /**
446
1583
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
447
1584
  */
448
1585
  RequestId?: string;
449
1586
  }
450
1587
  /**
451
- * DescribeTemplateToVideoJob返回参数结构体
1588
+ * DescribeAigcVideoJob返回参数结构体
452
1589
  */
453
- export interface DescribeTemplateToVideoJobResponse {
1590
+ export interface DescribeAigcVideoJobResponse {
454
1591
  /**
455
1592
  * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1593
+ 示例值:RUN
456
1594
  */
457
1595
  Status?: string;
458
1596
  /**
459
1597
  * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1598
+ 示例值:FailedOperation.DriverFailed
460
1599
  */
461
1600
  ErrorCode?: string;
462
1601
  /**
463
1602
  * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1603
+ 示例值:驱动失败
464
1604
  */
465
1605
  ErrorMessage?: string;
466
1606
  /**
467
1607
  * 结果视频 URL。有效期 24 小时。
1608
+
1609
+ 示例值:https://console.cloud.tencent.com/result.mp4
468
1610
  */
469
- ResultVideoUrl?: string;
1611
+ ResultUrl?: string;
470
1612
  /**
471
1613
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
472
1614
  */
473
1615
  RequestId?: string;
474
1616
  }
475
1617
  /**
476
- * SubmitVideoVoiceJob返回参数结构体
1618
+ * SubmitVideoExtendKlingJob返回参数结构体
477
1619
  */
478
- export interface SubmitVideoVoiceJobResponse {
1620
+ export interface SubmitVideoExtendKlingJobResponse {
479
1621
  /**
480
- * 任务ID
1622
+ * <p>任务ID。</p>
481
1623
  */
482
1624
  JobId?: string;
483
1625
  /**
@@ -486,42 +1628,36 @@ export interface SubmitVideoVoiceJobResponse {
486
1628
  RequestId?: string;
487
1629
  }
488
1630
  /**
489
- * 人脸图片和待被融合的素材模板图的人脸位置信息。
1631
+ * DescribeHumanActorJob返回参数结构体
490
1632
  */
491
- export interface FaceMergeInfo {
1633
+ export interface DescribeHumanActorJobResponse {
492
1634
  /**
493
- * 融合图片
1635
+ * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
494
1636
  */
495
- MergeFaceImage?: Image;
1637
+ Status?: string;
496
1638
  /**
497
- * 上传的图片人脸位置信息(人脸框)
498
- Width、Height >= 30。
1639
+ * 结果视频URL。有效期 24 小时。
499
1640
  */
500
- MergeFaceRect?: FaceRect;
1641
+ ResultVideoUrl?: string;
501
1642
  /**
502
- * 素材人脸ID,不填默认取上传图片中最大人脸。
1643
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
503
1644
  */
504
- TemplateFaceID?: string;
505
- }
506
- /**
507
- * CheckAnimateImageJob返回参数结构体
508
- */
509
- export interface CheckAnimateImageJobResponse {
1645
+ ErrorCode?: string;
510
1646
  /**
511
- * 输入图是否通过校验。
1647
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
512
1648
  */
513
- CheckPass?: boolean;
1649
+ ErrorMessage?: string;
514
1650
  /**
515
1651
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
516
1652
  */
517
1653
  RequestId?: string;
518
1654
  }
519
1655
  /**
520
- * SubmitVideoEditJob返回参数结构体
1656
+ * SubmitMotionControlKlingJob返回参数结构体
521
1657
  */
522
- export interface SubmitVideoEditJobResponse {
1658
+ export interface SubmitMotionControlKlingJobResponse {
523
1659
  /**
524
- * <p>任务ID。</p>
1660
+ * <p>任务ID</p>
525
1661
  */
526
1662
  JobId?: string;
527
1663
  /**
@@ -530,9 +1666,9 @@ export interface SubmitVideoEditJobResponse {
530
1666
  RequestId?: string;
531
1667
  }
532
1668
  /**
533
- * SubmitTemplateToVideoJob返回参数结构体
1669
+ * SubmitTextToVideoJob返回参数结构体
534
1670
  */
535
- export interface SubmitTemplateToVideoJobResponse {
1671
+ export interface SubmitTextToVideoJobResponse {
536
1672
  /**
537
1673
  * <p>任务ID。</p>
538
1674
  */
@@ -543,275 +1679,251 @@ export interface SubmitTemplateToVideoJobResponse {
543
1679
  RequestId?: string;
544
1680
  }
545
1681
  /**
546
- * CheckAnimateImageJob请求参数结构体
1682
+ * 各分镜信息,如提示词、时长等
1683
+
1684
+ 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中:
1685
+
1686
+ 最多支持6个分镜,最小支持1个分镜
1687
+
1688
+ 每个分镜相关内容的最大长度不超过512
1689
+
1690
+ 每个分镜的时长不大于当前任务的总时长,不小于1
1691
+
1692
+ 所有分镜的时长之和等于当前任务的总时长
1693
+
1694
+ 用key:value承载,如下:
1695
+
1696
+ "multi_prompt":[
1697
+ {
1698
+ "index":int,
1699
+ "prompt": "string",
1700
+ "duration": "5"
1701
+ },
1702
+ {
1703
+ "index":int,
1704
+ "prompt": "string",
1705
+ "duration": "5"
1706
+ }
1707
+ ]
1708
+ 当mult_shot参数为true且shot_type参数为customize时,当前参数不得为空
547
1709
  */
548
- export interface CheckAnimateImageJobRequest {
549
- /**
550
- * 动作模板ID。
551
- */
552
- TemplateId: string;
1710
+ export interface MultiPrompt {
553
1711
  /**
554
- * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
555
- 图片分辨率:长边分辨率范围【192,4096】;
556
- 图片大小:不超过10M;
557
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1712
+ * <p>分镜序号</p>
558
1713
  */
559
- ImageUrl?: string;
1714
+ Index?: number;
560
1715
  /**
561
- * 图片base64数据。
562
- 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
563
- 图片分辨率:长边分辨率范围【192,4096】;
564
- 图片大小:不超过10M;
565
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1716
+ * <p>分镜提示词</p>
566
1717
  */
567
- ImageBase64?: string;
1718
+ Prompt?: string;
568
1719
  /**
569
- * 是否对输入图采用加强检测方案。
570
-
571
- 默认不加强检测(false),仅对输入图做必要的基础检测。
572
-
573
- 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
1720
+ * <p>时长</p>
574
1721
  */
575
- EnableBodyJoins?: boolean;
1722
+ Duration?: string;
1723
+ }
1724
+ /**
1725
+ * DescribeTextToVideoJob请求参数结构体
1726
+ */
1727
+ export interface DescribeTextToVideoJobRequest {
576
1728
  /**
577
- * 是否开启人脸检测。
578
-
579
- 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
1729
+ * <p>任务ID。</p>
580
1730
  */
581
- EnableFace?: boolean;
1731
+ JobId: string;
582
1732
  }
583
1733
  /**
584
- * DescribeVideoStylizationJob请求参数结构体
1734
+ * DescribeImageToVideoJob请求参数结构体
585
1735
  */
586
- export interface DescribeVideoStylizationJobRequest {
1736
+ export interface DescribeImageToVideoJobRequest {
587
1737
  /**
588
- * 任务ID
1738
+ * <p>任务ID。</p>
589
1739
  */
590
1740
  JobId: string;
591
1741
  }
592
1742
  /**
593
- * SubmitHumanActorJob返回参数结构体
1743
+ * DescribeTemplateToVideoJob请求参数结构体
594
1744
  */
595
- export interface SubmitHumanActorJobResponse {
1745
+ export interface DescribeTemplateToVideoJobRequest {
596
1746
  /**
597
1747
  * 任务ID。
598
1748
  */
599
- JobId?: string;
600
- /**
601
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
602
- */
603
- RequestId?: string;
1749
+ JobId: string;
604
1750
  }
605
1751
  /**
606
- * DescribeImageAnimateJob返回参数结构体
1752
+ * SubmitTextToVideoViduJob返回参数结构体
607
1753
  */
608
- export interface DescribeImageAnimateJobResponse {
609
- /**
610
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
611
- */
612
- Status?: string;
613
- /**
614
- * 错误码。
615
- */
616
- ErrorCode?: string;
617
- /**
618
- * 错误信息。
619
- */
620
- ErrorMessage?: string;
621
- /**
622
- * 结果视频URL。有效期 24 小时。
623
- */
624
- ResultVideoUrl?: string;
1754
+ export interface SubmitTextToVideoViduJobResponse {
625
1755
  /**
626
- * 掩码视频链接
1756
+ * <p>任务ID。</p>
627
1757
  */
628
- MaskVideoUrl?: string;
1758
+ JobId?: string;
629
1759
  /**
630
1760
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
631
1761
  */
632
1762
  RequestId?: string;
633
1763
  }
634
1764
  /**
635
- * SubmitPortraitSingJob请求参数结构体
1765
+ * DescribeImageAnimateJob请求参数结构体
636
1766
  */
637
- export interface SubmitPortraitSingJobRequest {
638
- /**
639
- * 传入音频URL地址,音频要求:
640
- - 音频时长:2秒 - 60秒
641
- - 音频格式:mp3、wav、m4a
642
- */
643
- AudioUrl: string;
644
- /**
645
- * 传入图片URL地址,图片要求:
646
- - 图片格式:jpg、jpeg、png、bmp、webp
647
- - 图片分辨率:192~4096
648
- - 图片大小:不超过10M
649
- - 图片宽高比:图片【宽:高】在1:2到2:1范围内
650
- - 图片内容:避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
651
- */
652
- ImageUrl?: string;
653
- /**
654
- * 传入图片Base64编码,编码后请求体大小不超过10M。
655
- 图片Base64编码与URL地址必传其一,如果都传以ImageBase64为准。
656
- */
657
- ImageBase64?: string;
1767
+ export interface DescribeImageAnimateJobRequest {
658
1768
  /**
659
- * 唱演模式,默认使用人像模式。
660
- Person:人像模式,仅支持上传人像图片,人像生成效果更好,如果图中未检测到有效人脸将被拦截,生成时会将视频短边分辨率放缩至512。
661
- Pet:宠物模式,支持宠物等非人像图片,固定生成512:512分辨率视频。
1769
+ * 任务ID。
662
1770
  */
663
- Mode?: string;
1771
+ JobId?: string;
1772
+ }
1773
+ /**
1774
+ * DescribePortraitSingJob返回参数结构体
1775
+ */
1776
+ export interface DescribePortraitSingJobResponse {
664
1777
  /**
665
- * 生成视频尺寸。可选取值:"512:512"。
666
-
667
- 人像模式下,如果不传该参数,默认生成视频的短边分辨率为512,长边分辨率不固定、由模型根据生成效果自动适配得到。如需固定生成分辨率可传入512:512。
668
-
669
- 宠物模式下,如果不传该参数,默认将脸部唱演视频回贴原图,生成视频分辨率与原图一致。如不需要脸部回贴,仅保留脸部唱演视频,可传入512:512。
1778
+ * 任务ID
670
1779
  */
671
- Resolution?: string;
1780
+ JobId?: string;
672
1781
  /**
673
- * 为生成视频添加标识的开关,默认为1。
674
- 1:添加标识;
675
- 0:不添加标识;
676
- 其他数值:默认按1处理。
677
- 建议您使用显著标识来提示,该视频是 AI 生成的视频。
1782
+ * 任务状态码
1783
+ —RUN:处理中
1784
+ —FAIL:处理失败
1785
+ —STOP:处理终止
1786
+ —DONE:处理完成
678
1787
  */
679
- LogoAdd?: number;
1788
+ StatusCode?: string;
680
1789
  /**
681
- * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
1790
+ * 任务状态信息
682
1791
  */
683
- LogoParam?: LogoParam;
684
- }
685
- /**
686
- * 水印图输入框
687
- */
688
- export interface LogoRect {
1792
+ StatusMsg?: string;
689
1793
  /**
690
- * <p>水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。</p>
1794
+ * 任务执行错误码。当任务状态不为FAIL时,该值为""。
691
1795
  */
692
- X?: number;
1796
+ ErrorCode?: string;
693
1797
  /**
694
- * <p>水印图框Y坐标值。当值大于0时,坐标轴原点位于原图上侧,方向指下;当值小于0时,坐标轴原点位于原图下侧,方向指上。</p>
1798
+ * 任务执行错误信息。当任务状态不为FAIL时,该值为""。
695
1799
  */
696
- Y?: number;
1800
+ ErrorMessage?: string;
697
1801
  /**
698
- * <p>水印图框宽度。<br>单位:px</p>
1802
+ * 生成视频的URL地址。有效期24小时。
699
1803
  */
700
- Width?: number;
1804
+ ResultVideoUrl?: string;
701
1805
  /**
702
- * <p>水印图框高度。<br>单位:px</p>
1806
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
703
1807
  */
704
- Height?: number;
1808
+ RequestId?: string;
705
1809
  }
706
1810
  /**
707
- * DescribeAigcVideoJob返回参数结构体
1811
+ * DescribeHunyuanToVideoJob返回参数结构体
708
1812
  */
709
- export interface DescribeAigcVideoJobResponse {
1813
+ export interface DescribeHunyuanToVideoJobResponse {
710
1814
  /**
711
1815
  * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
712
- 示例值:RUN
713
1816
  */
714
1817
  Status?: string;
715
1818
  /**
716
1819
  * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
717
- 示例值:FailedOperation.DriverFailed
718
1820
  */
719
1821
  ErrorCode?: string;
720
1822
  /**
721
1823
  * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
722
- 示例值:驱动失败
723
1824
  */
724
1825
  ErrorMessage?: string;
725
1826
  /**
726
1827
  * 结果视频 URL。有效期 24 小时。
727
-
728
- 示例值:https://console.cloud.tencent.com/result.mp4
729
1828
  */
730
- ResultUrl?: string;
1829
+ ResultVideoUrl?: string;
731
1830
  /**
732
1831
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
733
1832
  */
734
1833
  RequestId?: string;
735
1834
  }
736
1835
  /**
737
- * SubmitVideoVoiceJob请求参数结构体
1836
+ * DescribeTextToVideoViduJob请求参数结构体
738
1837
  */
739
- export interface SubmitVideoVoiceJobRequest {
740
- /**
741
- * 输入视频的Url 上传视频时长限制:1-15s 视频格式:MP4,MOV 视频大小:不超过1 GB URL地址中不能包含中文字符。
742
- */
743
- VideoUrl?: string;
744
- /**
745
- * 描述音效内容的正向提示词。输入上限50个字符。
746
- */
747
- Prompt?: string;
1838
+ export interface DescribeTextToVideoViduJobRequest {
748
1839
  /**
749
- * 音效内容的原始负向提示词。输入上限50个字符。
1840
+ * <p>任务ID</p>
750
1841
  */
751
- NegativePrompt?: string;
1842
+ JobId: string;
1843
+ }
1844
+ /**
1845
+ * 运动轨迹坐标序列
1846
+ */
1847
+ export interface Trajectory {
752
1848
  /**
753
- * 为生成视频添加标识的开关,默认为1。 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。 建议您使用显著标识来提示,该视频是 AI 生成的视频。
1849
+ * 轨迹点横坐标(在像素二维坐标系下,以输入图片image左下为原点的像素坐标)
754
1850
  */
755
- LogoAdd?: number;
1851
+ X?: number;
756
1852
  /**
757
- * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
1853
+ * 轨迹点纵坐标(在像素二维坐标系下,以输入图片image左下为原点的像素坐标)
758
1854
  */
759
- LogoParam?: LogoParam;
1855
+ Y?: number;
760
1856
  }
761
1857
  /**
762
- * SubmitAigcVideoJob请求参数结构体
1858
+ * DescribeTextToVideoViduJob返回参数结构体
763
1859
  */
764
- export interface SubmitAigcVideoJobRequest {
1860
+ export interface DescribeTextToVideoViduJobResponse {
765
1861
  /**
766
- * <p>模型名称。</p><p>枚举值:</p><p>● Vidu;</p><p>● Kling:可灵;</p><p>● HY:混元;</p><p>● YT:优图;</p><p>示例值:Vidu</p>
1862
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
767
1863
  */
768
- Vendor: string;
1864
+ Status?: string;
769
1865
  /**
770
- * <p>模型版本。</p><p>枚举值:</p><p>● 当Vendor为Vidu时,可选值[q2, q2-pro, q2-turbo, q3-pro, q3-turbo]</p><p>● 当Vendor为Kling时,可选值[v1.6, v2.0, v2.1, v2.5, v2.6]</p><p>● 当Vendor为HY时,默认值:[v1.5]</p><p>● 当Vendor为YT时,默认值:[v2.0]</p>
1866
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
771
1867
  */
772
- Model: string;
1868
+ ErrorCode?: string;
773
1869
  /**
774
- * <p>模型参数Json-Format字符串<br> <a href="https://cloud.tencent.com/document/product/1616/128996">模型参数列表</a></p>
1870
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
775
1871
  */
776
- ModelParam?: string;
1872
+ ErrorMessage?: string;
777
1873
  /**
778
- * <p>正向文本提示词。不能超过2000个字符</p><p>示例值:一只小猫在草地奔跑</p>
1874
+ * <p>结果视频 URL。有效期 24 小时。</p>
779
1875
  */
780
- Prompt?: string;
1876
+ ResultVideoUrl?: string;
781
1877
  /**
782
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
1878
+ * <p>该任务消耗的积分数量。</p>
783
1879
  */
784
- LogoAdd?: number;
1880
+ Credits?: number;
785
1881
  /**
786
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1882
+ * <p>任务调用时传入的透传参数。</p>
787
1883
  */
788
- LogoParam?: LogoParam;
1884
+ Payload?: string;
1885
+ /**
1886
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1887
+ */
1888
+ RequestId?: string;
789
1889
  }
790
1890
  /**
791
- * SubmitHunyuanToVideoJob返回参数结构体
1891
+ * DescribeVideoVoiceJob请求参数结构体
792
1892
  */
793
- export interface SubmitHunyuanToVideoJobResponse {
1893
+ export interface DescribeVideoVoiceJobRequest {
794
1894
  /**
795
- * 任务ID
1895
+ * 任务ID
796
1896
  */
797
1897
  JobId?: string;
1898
+ }
1899
+ /**
1900
+ * 控制摄像机运动的协议
1901
+ */
1902
+ export interface CameraControl {
798
1903
  /**
799
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1904
+ * 枚举值:“simple”, “down_back”, “forward_up”, “right_turn_forward”, “left_turn_forward”
1905
+ simple:简单运镜,此类型下可在"config"中六选一进行运镜
1906
+ down_back:镜头下压并后退 -> 下移拉远,此类型下config参数无需填写
1907
+ forward_up:镜头前进并上仰 -> 推进上移,此类型下config参数无需填写
1908
+ right_turn_forward:先右旋转后前进 -> 右旋推进,此类型下config参数无需填写
1909
+ left_turn_forward:先左旋并前进 -> 左旋推进,此类型下config参数无需填写
800
1910
  */
801
- RequestId?: string;
1911
+ Type?: string;
1912
+ /**
1913
+ * 包含六个字段,用于指定摄像机在不同方向上的运动或变化。
1914
+ - 当运镜类型指定simple时必填,指定其他类型时不填
1915
+ - 参数6选1,即只能有一个参数不为0,其余参数为0
1916
+ */
1917
+ Config?: CameraControlConfig;
802
1918
  }
803
1919
  /**
804
- * DescribeHumanActorJob返回参数结构体
1920
+ * DescribeVideoFaceFusionJob返回参数结构体
805
1921
  */
806
- export interface DescribeHumanActorJobResponse {
1922
+ export interface DescribeVideoFaceFusionJobResponse {
807
1923
  /**
808
- * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1924
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
809
1925
  */
810
1926
  Status?: string;
811
- /**
812
- * 结果视频URL。有效期 24 小时。
813
- */
814
- ResultVideoUrl?: string;
815
1927
  /**
816
1928
  * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
817
1929
  */
@@ -820,430 +1932,413 @@ export interface DescribeHumanActorJobResponse {
820
1932
  * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
821
1933
  */
822
1934
  ErrorMessage?: string;
1935
+ /**
1936
+ * 结果视频 URL。有效期 24 小时。
1937
+ */
1938
+ ResultVideoUrl?: string;
823
1939
  /**
824
1940
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
825
1941
  */
826
1942
  RequestId?: string;
827
1943
  }
828
1944
  /**
829
- * 扩展字段。
1945
+ * SubmitImageToVideoGeneralJob返回参数结构体
830
1946
  */
831
- export interface ExtraParam {
1947
+ export interface SubmitImageToVideoGeneralJobResponse {
832
1948
  /**
833
- * <p>预签名的上传url,支持把视频直接传到客户指定的地址。</p>
1949
+ * 任务ID
834
1950
  */
835
- UserDesignatedUrl?: string;
1951
+ JobId?: string;
836
1952
  /**
837
- * <p>回调地址<br>需要您在创建任务时主动设置 CallbackUrl,请求方法为 POST,当视频生成结束时,我们将向此地址发送生成结果。<br>数据格式如下:<br>{<br> &quot;JobId&quot;: &quot;1397428070633955328&quot;,<br> &quot;Status&quot;: &quot;DONE&quot;,<br> &quot;ErrorCode&quot;: &quot;&quot;,<br> &quot;ErrorMessage&quot;: &quot;&quot;,<br> &quot;ResultVideoUrl&quot;: &quot;https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4&quot;<br>}</p>
1953
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
838
1954
  */
839
- CallbackUrl?: string;
1955
+ RequestId?: string;
1956
+ }
1957
+ /**
1958
+ * 人脸图片和待被融合的素材模板图的人脸位置信息。
1959
+ */
1960
+ export interface FaceMergeInfo {
840
1961
  /**
841
- * <p>BGM音频文本。</p>
1962
+ * 融合图片
842
1963
  */
843
- BGMText?: string;
1964
+ MergeFaceImage?: Image;
1965
+ /**
1966
+ * 上传的图片人脸位置信息(人脸框)
1967
+ Width、Height >= 30。
1968
+ */
1969
+ MergeFaceRect?: FaceRect;
1970
+ /**
1971
+ * 素材人脸ID,不填默认取上传图片中最大人脸。
1972
+ */
1973
+ TemplateFaceID?: string;
844
1974
  }
845
1975
  /**
846
- * DescribeVideoEditJob返回参数结构体
1976
+ * CheckAnimateImageJob请求参数结构体
847
1977
  */
848
- export interface DescribeVideoEditJobResponse {
1978
+ export interface CheckAnimateImageJobRequest {
849
1979
  /**
850
- * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1980
+ * 动作模板ID。
851
1981
  */
852
- Status?: string;
1982
+ TemplateId: string;
853
1983
  /**
854
- * 结果视频URL。有效期 24 小时。
1984
+ * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1985
+ 图片分辨率:长边分辨率范围【192,4096】;
1986
+ 图片大小:不超过10M;
1987
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
855
1988
  */
856
- ResultVideoUrl?: string;
1989
+ ImageUrl?: string;
857
1990
  /**
858
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1991
+ * 图片base64数据。
1992
+ 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1993
+ 图片分辨率:长边分辨率范围【192,4096】;
1994
+ 图片大小:不超过10M;
1995
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
859
1996
  */
860
- ErrorCode?: string;
1997
+ ImageBase64?: string;
861
1998
  /**
862
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1999
+ * 是否对输入图采用加强检测方案。
2000
+
2001
+ 默认不加强检测(false),仅对输入图做必要的基础检测。
2002
+
2003
+ 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
863
2004
  */
864
- ErrorMessage?: string;
2005
+ EnableBodyJoins?: boolean;
865
2006
  /**
866
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2007
+ * 是否开启人脸检测。
2008
+
2009
+ 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
867
2010
  */
868
- RequestId?: string;
2011
+ EnableFace?: boolean;
869
2012
  }
870
2013
  /**
871
- * DescribeVideoStylizationJob返回参数结构体
2014
+ * DescribeVideoExtendKlingJob返回参数结构体
872
2015
  */
873
- export interface DescribeVideoStylizationJobResponse {
2016
+ export interface DescribeVideoExtendKlingJobResponse {
874
2017
  /**
875
- * 任务ID。
2018
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
876
2019
  */
877
- JobId?: string;
2020
+ Status?: string;
878
2021
  /**
879
- * 任务状态码。取值说明:
880
- JobInit: "初始化中";
881
- JobModerationFailed: "审核失败";
882
- JobRunning: "处理中";
883
- JobFailed: "处理失败";
884
- JobSuccess: "处理完成"。
2022
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
885
2023
  */
886
- StatusCode?: string;
2024
+ ErrorCode?: string;
887
2025
  /**
888
- * 任务状态描述。取值说明:
889
- JobInit: "初始化中";
890
- JobModerationFailed: "审核失败";
891
- JobRunning: "处理中";
892
- JobFailed: "处理失败";
893
- JobSuccess: "处理完成"。
2026
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
894
2027
  */
895
- StatusMsg?: string;
2028
+ ErrorMessage?: string;
896
2029
  /**
897
- * 处理结果视频Url。URL有效期为24小时。
2030
+ * <p>结果视频 URL。有效期 24 小时。</p>
898
2031
  */
899
2032
  ResultVideoUrl?: string;
900
2033
  /**
901
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2034
+ * <p>视频时长。</p>
902
2035
  */
903
- RequestId?: string;
904
- }
905
- /**
906
- * SubmitVideoStylizationJob返回参数结构体
907
- */
908
- export interface SubmitVideoStylizationJobResponse {
2036
+ Duration?: string;
909
2037
  /**
910
- * 任务ID。任务有效期为48小时。
2038
+ * <p>消耗积分数。</p>
911
2039
  */
912
- JobId?: string;
2040
+ FinalUnitDeduction?: string;
2041
+ /**
2042
+ * <p>视频id</p>
2043
+ */
2044
+ VideoId?: string;
913
2045
  /**
914
2046
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
915
2047
  */
916
2048
  RequestId?: string;
917
2049
  }
918
2050
  /**
919
- * SubmitVideoFaceFusionJob请求参数结构体
2051
+ * SubmitPortraitSingJob请求参数结构体
920
2052
  */
921
- export interface SubmitVideoFaceFusionJobRequest {
2053
+ export interface SubmitPortraitSingJobRequest {
922
2054
  /**
923
- * 视频素材下载地址。用户自定义模板视频下载地址,使用前需要先调用视频审核接口进行内容审核。视频限制:分辨率≤4k,fps≤25,视频大小≤1G,时长≤20 秒,支持格式mp4。
924
-
925
- 输入视频建议:
926
- 姿态:人脸相对镜头水平方向角度转动不超过 90°,垂直方向角度转动不超过 20°。遮挡:脸部遮挡面积不超过 50%,不要完全遮挡五官,不要有半透明遮挡(强光,玻璃,透明眼镜等)、以及细碎离散的脸部遮挡(如飘落的花瓣)。妆容及光照:避免浓妆、复杂妆容,避免复杂光照、闪烁,这些属性无法完全恢复,并对稳定性有影响。针对特殊表情和微表情,针对局部肌肉控制下的微表情,以及过于夸张的特殊表情等不保证表情效果完全恢复。
2055
+ * 传入音频URL地址,音频要求:
2056
+ - 音频时长:2秒 - 60秒
2057
+ - 音频格式:mp3、wav、m4a
927
2058
  */
928
- VideoUrl?: string;
2059
+ AudioUrl: string;
929
2060
  /**
930
- * 视频素材模板的人脸位置信息。
931
- 目前最多支持融合视频素材中的 6 张人脸
932
- 输入图片要求:
933
- 1、用户图限制大小不超过 10MB
934
- 2、图片最大分辨率不超过 4k,建议最小为 128, 人脸框最小为 68
935
- 3、支持格式 jpg,png
936
- 4、如果用户图中未指定人脸且有多张人脸, 默认融合最大人脸
937
- 输入图片建议: 包含上述视频中出现的人物的单人照,并且正面、清晰、无遮挡
2061
+ * 传入图片URL地址,图片要求:
2062
+ - 图片格式:jpg、jpeg、png、bmp、webp
2063
+ - 图片分辨率:192~4096
2064
+ - 图片大小:不超过10M
2065
+ - 图片宽高比:图片【宽:高】在1:2到2:1范围内
2066
+ - 图片内容:避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
938
2067
  */
939
- TemplateInfos?: Array<FaceTemplateInfo>;
2068
+ ImageUrl?: string;
940
2069
  /**
941
- * 用户人脸图片位置信息。
942
- 输入图片要求:
943
- 1、用户图限制大小不超过 10MB
944
- 2、图片最大分辨率不超过 4k,建议最小为 128,人脸框最小为 68
945
- 3、支持格式 jpg,png
946
- 4、如果未指定人脸且用户图中有多张人脸,
947
- 默认融合最大人脸
948
- 输入图建议:
949
- 正脸无遮挡
2070
+ * 传入图片Base64编码,编码后请求体大小不超过10M。
2071
+ 图片Base64编码与URL地址必传其一,如果都传以ImageBase64为准。
2072
+ */
2073
+ ImageBase64?: string;
2074
+ /**
2075
+ * 唱演模式,默认使用人像模式。
2076
+ Person:人像模式,仅支持上传人像图片,人像生成效果更好,如果图中未检测到有效人脸将被拦截,生成时会将视频短边分辨率放缩至512。
2077
+ Pet:宠物模式,支持宠物等非人像图片,固定生成512:512分辨率视频。
2078
+ */
2079
+ Mode?: string;
2080
+ /**
2081
+ * 生成视频尺寸。可选取值:"512:512"。
2082
+
2083
+ 人像模式下,如果不传该参数,默认生成视频的短边分辨率为512,长边分辨率不固定、由模型根据生成效果自动适配得到。如需固定生成分辨率可传入512:512。
2084
+
2085
+ 宠物模式下,如果不传该参数,默认将脸部唱演视频回贴原图,生成视频分辨率与原图一致。如不需要脸部回贴,仅保留脸部唱演视频,可传入512:512。
950
2086
  */
951
- MergeInfos?: Array<FaceMergeInfo>;
2087
+ Resolution?: string;
952
2088
  /**
953
2089
  * 为生成视频添加标识的开关,默认为1。
954
- 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。
2090
+ 1:添加标识;
2091
+ 0:不添加标识;
2092
+ 其他数值:默认按1处理。
955
2093
  建议您使用显著标识来提示,该视频是 AI 生成的视频。
956
2094
  */
957
2095
  LogoAdd?: number;
958
2096
  /**
959
- * 视频水印Logo参数标识内容设置。
960
- 默认在融合结果图右下角添加“AI生成”类似字样,您可根据自身需要替换为其他的Logo图片。
961
- 输入建议:输入水印图片宽高需小于视频宽高
2097
+ * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
962
2098
  */
963
2099
  LogoParam?: LogoParam;
964
2100
  }
965
2101
  /**
966
- * SubmitPortraitSingJob返回参数结构体
2102
+ * Element
967
2103
  */
968
- export interface SubmitPortraitSingJobResponse {
969
- /**
970
- * 任务ID。任务有效期为48小时。
971
- */
972
- JobId?: string;
2104
+ export interface Element {
973
2105
  /**
974
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2106
+ * <p>ID配置</p>
975
2107
  */
976
- RequestId?: string;
2108
+ ElementId?: string;
977
2109
  }
978
2110
  /**
979
- * SubmitTemplateToVideoJob请求参数结构体
2111
+ * 动态笔刷
980
2112
  */
981
- export interface SubmitTemplateToVideoJobRequest {
982
- /**
983
- * <p>特效模板名称。请在 <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板列表</a> 中选择想要生成的特效对应的 template 名称。</p>
984
- */
985
- Template: string;
986
- /**
987
- * <p>参考图像,不同特效输入图片的数量详见: <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-图片要求说明</a></p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片格式:支持png、jpg、jpeg、webp、bmp、tiff</li><li>图片文件:大小不能超过10MB(base64后),图片分辨率不小于300×300px,不大于4096×4096,图片宽高比应在1:4 ~ 4:1之间</li></ul>
988
- */
989
- Images: Array<Image>;
990
- /**
991
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
992
- */
993
- LogoAdd?: number;
2113
+ export interface DynamicMask {
994
2114
  /**
995
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
2115
+ * <p>动态笔刷涂抹区域(用户通过运动笔刷涂抹的 mask 图片)</p><p>支持传入图片Base64编码或图片URL(确保可访问,格式要求同 Image 字段)<br>图片格式支持.jpg / .jpeg / .png<br>图片长宽比必须与输入图片相同(即Image字段),否则任务失败<br>StaticMask 和 DynamicMasks.Mask 这两张图片的分辨率必须一致,否则任务失败</p>
996
2116
  */
997
- LogoParam?: LogoParam;
2117
+ Mask?: string;
998
2118
  /**
999
- * <p>视频输出分辨率,默认值:360p 。不同特效支持的清晰度及消耗积分数详见:<a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-单次调用消耗积分数列</a></p>
2119
+ * <p>运动轨迹坐标序列</p><p>生成5s的视频,轨迹长度不超过77,即坐标个数取值范围:[2, 77]<br>轨迹坐标系,以图片左下角为坐标原点<br>注1:坐标点个数越多轨迹刻画越准确,如只有2个轨迹点则为这两点连接的直线<br>注2:轨迹方向以传入顺序为指向,以最先传入的坐标为轨迹起点,依次连接后续坐标形成运动轨迹</p>
1000
2120
  */
1001
- Resolution?: string;
2121
+ Trajectories?: Array<Trajectory>;
2122
+ }
2123
+ /**
2124
+ * SubmitHunyuanToVideoJob返回参数结构体
2125
+ */
2126
+ export interface SubmitHunyuanToVideoJobResponse {
1002
2127
  /**
1003
- * <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
2128
+ * 任务ID
1004
2129
  */
1005
- BGM?: boolean;
2130
+ JobId?: string;
1006
2131
  /**
1007
- * <p>扩展字段。</p>
2132
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1008
2133
  */
1009
- ExtraParam?: ExtraParam;
2134
+ RequestId?: string;
1010
2135
  }
1011
2136
  /**
1012
- * SubmitImageToVideoGeneralJob请求参数结构体
2137
+ * SubmitTextToVideoJob请求参数结构体
1013
2138
  */
1014
- export interface SubmitImageToVideoGeneralJobRequest {
1015
- /**
1016
- * 输入图片
1017
- Base64 和 Url 必须提供一个,如果都提供以ImageUrl为准。
1018
- 上传图url大小不超过 8M
1019
- 支持jpg,png,jpeg,webp,bmp,tiff 格式
1020
- 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
1021
- */
1022
- Image: Image;
2139
+ export interface SubmitTextToVideoJobRequest {
1023
2140
  /**
1024
- * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。
2141
+ * <p>正向文本提示词。不能超过2500个字符</p>
1025
2142
  */
1026
2143
  Prompt?: string;
1027
2144
  /**
1028
- * 输出视频分辨率。可选择:480p、720p、1080p。
2145
+ * <p>模型名称。<br>v1.6:Kling-V1-6<br>v2.0:Kling-V2-Master<br>v2.5:Kling-V2-5-Turbo<br>v2.6:Kling-V2-6<br>v3.0:kling-v3</p>
1029
2146
  */
1030
- Resolution?: string;
2147
+ Model?: string;
1031
2148
  /**
1032
- * 生成视频的帧率,从16, 24, 30中选择。默认值:30
2149
+ * <p>负向文本提示词。不能超过2500个字符</p>
1033
2150
  */
1034
- Fps?: number;
2151
+ NegativePrompt?: string;
1035
2152
  /**
1036
- * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
2153
+ * <p>生成视频时长,单位s。默认值为5。<br>枚举值:34,5,6,7,8,9,10,11,12,13,14,15</p><p>不同模型支持时长不同</p><ul><li>模型v1.6、v2.0、v2.5、v2.6:支持5、10</li><li>模型v3.0:支持3~15s</li></ul>
1037
2154
  */
1038
- LogoAdd?: number;
2155
+ Duration?: string;
1039
2156
  /**
1040
- * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
2157
+ * <p>生成视频的模式;</p><p>枚举值:std,pro</p><ul><li>其中std:标准模式(标准),基础模式,性价比高</li><li>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</li></ul><p>不同模型版本、视频模式支持范围不同</p><ul><li>v1.6:std、pro。</li><li>v2.0、v3.0:模型无需配置。</li><li>v2.5:首尾帧情况下支持pro。</li><li>v2.6:仅支持pro,选择v2.6模型时,默认自动生成高品质pro视频。</li></ul>
1041
2158
  */
1042
- LogoParam?: LogoParam;
1043
- }
1044
- /**
1045
- * SubmitHunyuanToVideoJob请求参数结构体
1046
- */
1047
- export interface SubmitHunyuanToVideoJobRequest {
2159
+ Mode?: string;
1048
2160
  /**
1049
- * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。 示例值:一只猫在草原上奔跑,写实风格
2161
+ * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>取值范围:[0, 1]<br>v2.0、v2.5、v2.6 模型不支持当前参数<br>默认值:0.5。</p>
1050
2162
  */
1051
- Prompt: string;
2163
+ CfgScale?: number;
1052
2164
  /**
1053
- * 输入图片
1054
- 上传图url大小不超过 10M,base64不超过8M。
1055
- 支持jpg,png,jpeg,webp,bmp,tiff 格式
1056
- 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
2165
+ * <p>生成视频的画面纵横比(宽:高)<br>枚举值:16:9, 9:16, 1:1<br>默认值:16:9</p>
1057
2166
  */
1058
- Image?: Image;
2167
+ AspectRatio?: string;
1059
2168
  /**
1060
- * 目前仅支持720p视频分辨率,默认720p。
2169
+ * <p>生成视频时是否同时生成声音</p><ul><li>枚举值:on,off</li></ul><p>仅V2.6及后续版本模型支持当前参数,v2.6模型的std模式只能生成无声的视频</p>
1061
2170
  */
1062
- Resolution?: string;
2171
+ Sound?: string;
1063
2172
  /**
1064
- * 为生成视频添加标识的开关,默认为10 需前往 控制台 申请开启显示标识自主完成方可生效。
1065
- 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
2173
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
1066
2174
  */
1067
2175
  LogoAdd?: number;
1068
2176
  /**
1069
- * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
2177
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1070
2178
  */
1071
2179
  LogoParam?: LogoParam;
1072
- }
1073
- /**
1074
- * 图片
1075
- */
1076
- export interface Image {
1077
2180
  /**
1078
- * 图片Base64
2181
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,prompt参数无效</li><li>当前参数为false时,shot_type参数及multi_prompt参数无效</li></ul>
1079
2182
  */
1080
- Base64?: string;
2183
+ MultiShot?: boolean;
1081
2184
  /**
1082
- * 图片Url
2185
+ * <p>分镜方式</p><p>枚举值:customize,intelligence<br>当MultiShot参数为true时,当前参数必填</p>
1083
2186
  */
1084
- Url?: string;
1085
- }
1086
- /**
1087
- * DescribeVideoEditJob请求参数结构体
1088
- */
1089
- export interface DescribeVideoEditJobRequest {
2187
+ ShotType?: string;
1090
2188
  /**
1091
- * 任务ID。
2189
+ * <p>各分镜提示词,可包含正向描述和负向描述</p><p>通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中:</p><ul><li>最多支持6个分镜,最小支持1个分镜</li><li>每个分镜相关内容的最大长度不超过512</li><li>每个分镜的时长不大于当前任务的总时长,不小于1</li><li>所有分镜的时长之和等于当前任务的总时长</li><li>当MultiShot参数为true且ShotType参数为customize时,当前参数不得为空<br>用key:value承载,如下:<pre><code> &quot;MultiPrompt&quot;:[ { &quot;Index&quot;:int, &quot;Prompt&quot;: &quot;string&quot;, &quot;Duration&quot;: &quot;5&quot; } ]</code></pre></li></ul>
1092
2190
  */
1093
- JobId: string;
1094
- }
1095
- /**
1096
- * DescribeHumanActorJob请求参数结构体
1097
- */
1098
- export interface DescribeHumanActorJobRequest {
2191
+ MultiPrompt?: Array<MultiPrompt>;
1099
2192
  /**
1100
- * 任务ID。
2193
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
1101
2194
  */
1102
- JobId: string;
1103
- }
1104
- /**
1105
- * DescribeImageToVideoGeneralJob请求参数结构体
1106
- */
1107
- export interface DescribeImageToVideoGeneralJobRequest {
2195
+ CameraControl?: CameraControl;
1108
2196
  /**
1109
- * 任务ID
2197
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
1110
2198
  */
1111
- JobId: string;
2199
+ CallbackUrl?: string;
1112
2200
  }
1113
2201
  /**
1114
- * SubmitAigcVideoJob返回参数结构体
2202
+ * DescribeVideoStylizationJob返回参数结构体
1115
2203
  */
1116
- export interface SubmitAigcVideoJobResponse {
2204
+ export interface DescribeVideoStylizationJobResponse {
1117
2205
  /**
1118
- * <p>任务ID。</p>
2206
+ * 任务ID
1119
2207
  */
1120
2208
  JobId?: string;
1121
2209
  /**
1122
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2210
+ * 任务状态码。取值说明:
2211
+ JobInit: "初始化中";
2212
+ JobModerationFailed: "审核失败";
2213
+ JobRunning: "处理中";
2214
+ JobFailed: "处理失败";
2215
+ JobSuccess: "处理完成"。
1123
2216
  */
1124
- RequestId?: string;
1125
- }
1126
- /**
1127
- * DescribeTemplateToVideoJob请求参数结构体
1128
- */
1129
- export interface DescribeTemplateToVideoJobRequest {
2217
+ StatusCode?: string;
1130
2218
  /**
1131
- * 任务ID。
2219
+ * 任务状态描述。取值说明:
2220
+ JobInit: "初始化中";
2221
+ JobModerationFailed: "审核失败";
2222
+ JobRunning: "处理中";
2223
+ JobFailed: "处理失败";
2224
+ JobSuccess: "处理完成"。
1132
2225
  */
1133
- JobId: string;
1134
- }
1135
- /**
1136
- * SubmitVideoEditJob请求参数结构体
1137
- */
1138
- export interface SubmitVideoEditJobRequest {
2226
+ StatusMsg?: string;
1139
2227
  /**
1140
- * <p>参考视频URL。默认为待编辑视频。</p><ul><li>视频格式:支持MP4</li><li>视频时长:输入视频时长≤10秒</li><li>视频大小:不超过200M</li><li>视频文件:输入的视频帧率及分辨率不做限制(建议输入16:9或9:16的视频;分辨率建议在2160px内,帧率建议在60fps内);输出视频是帧率会≥16fps,分辨率为720p</li></ul>
2228
+ * 处理结果视频Url。URL有效期为24小时。
1141
2229
  */
1142
- VideoUrl: string;
2230
+ ResultVideoUrl?: string;
1143
2231
  /**
1144
- * <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
2232
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1145
2233
  */
1146
- Prompt?: string;
2234
+ RequestId?: string;
2235
+ }
2236
+ /**
2237
+ * SubmitHunyuanToVideoJob请求参数结构体
2238
+ */
2239
+ export interface SubmitHunyuanToVideoJobRequest {
1147
2240
  /**
1148
- * <p>参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。</p><ul><li>支持传入图片Base64编码或图片URL</li><li>图片格式:支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>图片文件:大小不能超过10MB(base64后)。单边分辨率不超过5000px,不小于50px,图片长宽限制1:4 ~ 4:1。<br>示例值:[{ &quot;Url&quot;: &quot;https://console.cloud.tencent.com/cos/image.png&quot;}]</li></ul>
2241
+ * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。 示例值:一只猫在草原上奔跑,写实风格
1149
2242
  */
1150
- Images?: Array<Image>;
2243
+ Prompt: string;
1151
2244
  /**
1152
- * <p>图片base64或者图片url</p><ul><li>Base64 和 Url 必须提供一个,如果都提供以Url为准。</li><li>上传图url大小不超过 8M</li><li>支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1</li></ul>
1153
- * @deprecated
2245
+ * 输入图片
2246
+ 上传图url大小不超过 10M,base64不超过8M。
2247
+ 支持jpg,png,jpeg,webp,bmp,tiff 格式
2248
+ 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
1154
2249
  */
1155
2250
  Image?: Image;
1156
2251
  /**
1157
- * <p>扩展字段。</p>
2252
+ * 目前仅支持720p视频分辨率,默认720p。
1158
2253
  */
1159
- VideoEditParam?: VideoEditParam;
2254
+ Resolution?: string;
1160
2255
  /**
1161
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
2256
+ * 为生成视频添加标识的开关,默认为10 需前往 控制台 申请开启显示标识自主完成方可生效。
2257
+ 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
1162
2258
  */
1163
2259
  LogoAdd?: number;
1164
2260
  /**
1165
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
2261
+ * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
1166
2262
  */
1167
2263
  LogoParam?: LogoParam;
1168
2264
  }
1169
2265
  /**
1170
- * DescribeImageAnimateJob请求参数结构体
2266
+ * DescribeVideoEditJob请求参数结构体
1171
2267
  */
1172
- export interface DescribeImageAnimateJobRequest {
2268
+ export interface DescribeVideoEditJobRequest {
1173
2269
  /**
1174
2270
  * 任务ID。
1175
2271
  */
1176
- JobId?: string;
2272
+ JobId: string;
1177
2273
  }
1178
2274
  /**
1179
- * DescribePortraitSingJob返回参数结构体
2275
+ * DescribeVideoEditKlingJob返回参数结构体
1180
2276
  */
1181
- export interface DescribePortraitSingJobResponse {
2277
+ export interface DescribeVideoEditKlingJobResponse {
1182
2278
  /**
1183
- * 任务ID
2279
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1184
2280
  */
1185
- JobId?: string;
2281
+ Status?: string;
1186
2282
  /**
1187
- * 任务状态码
1188
- —RUN:处理中
1189
- —FAIL:处理失败
1190
- —STOP:处理终止
1191
- —DONE:处理完成
2283
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1192
2284
  */
1193
- StatusCode?: string;
2285
+ ErrorCode?: string;
1194
2286
  /**
1195
- * 任务状态信息
2287
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1196
2288
  */
1197
- StatusMsg?: string;
2289
+ ErrorMessage?: string;
1198
2290
  /**
1199
- * 任务执行错误码。当任务状态不为FAIL时,该值为""。
2291
+ * <p>结果视频 URL。有效期 24 小时。</p>
1200
2292
  */
1201
- ErrorCode?: string;
2293
+ ResultVideoUrl?: string;
1202
2294
  /**
1203
- * 任务执行错误信息。当任务状态不为FAIL时,该值为""。
2295
+ * <p>视频id</p>
1204
2296
  */
1205
- ErrorMessage?: string;
2297
+ VideoId?: string;
1206
2298
  /**
1207
- * 生成视频的URL地址。有效期24小时。
2299
+ * <p>时长</p>
1208
2300
  */
1209
- ResultVideoUrl?: string;
2301
+ Duration?: string;
2302
+ /**
2303
+ * <p>消耗积分数</p>
2304
+ */
2305
+ FinalUnitDeduction?: string;
1210
2306
  /**
1211
2307
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1212
2308
  */
1213
2309
  RequestId?: string;
1214
2310
  }
1215
2311
  /**
1216
- * DescribeHunyuanToVideoJob返回参数结构体
2312
+ * 人脸框信息。
1217
2313
  */
1218
- export interface DescribeHunyuanToVideoJobResponse {
1219
- /**
1220
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1221
- */
1222
- Status?: string;
2314
+ export interface FaceRect {
1223
2315
  /**
1224
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
2316
+ * <p>人脸框左上角横坐标。</p>
1225
2317
  */
1226
- ErrorCode?: string;
2318
+ X?: number;
1227
2319
  /**
1228
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
2320
+ * <p>人脸框左上角纵坐标。</p>
1229
2321
  */
1230
- ErrorMessage?: string;
2322
+ Y?: number;
1231
2323
  /**
1232
- * 结果视频 URL。有效期 24 小时。
2324
+ * <p>人脸框宽度。<br>单位:px</p>
1233
2325
  */
1234
- ResultVideoUrl?: string;
2326
+ Width?: number;
1235
2327
  /**
1236
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2328
+ * <p>人脸框高度。<br>单位:px</p>
1237
2329
  */
1238
- RequestId?: string;
2330
+ Height?: number;
1239
2331
  }
1240
2332
  /**
1241
- * 视频编辑参数
2333
+ * SubmitImageToVideoJob返回参数结构体
1242
2334
  */
1243
- export interface VideoEditParam {
2335
+ export interface SubmitImageToVideoJobResponse {
1244
2336
  /**
1245
- * 魔法词,针对特定场景生效。不同场景传不同的值。默认不传。
1246
- - 换人场景:1
2337
+ * <p>任务ID。</p>
1247
2338
  */
1248
- Magic?: string;
2339
+ JobId?: string;
2340
+ /**
2341
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2342
+ */
2343
+ RequestId?: string;
1249
2344
  }