tencentcloud-sdk-nodejs 4.1.213 → 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 (69) 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/mps/v20190612/mps_client.js +18 -6
  5. package/es/services/organization/v20210331/organization_client.js +5 -2
  6. package/es/services/tcbr/v20220217/tcbr_client.js +8 -2
  7. package/es/services/tdmq/v20200217/tdmq_client.js +5 -2
  8. package/es/services/tdmysql/v20211122/tdmysql_client.js +5 -2
  9. package/es/services/vclm/v20240523/vclm_client.js +52 -4
  10. package/es/services/vpc/v20170312/vpc_client.js +3 -0
  11. package/package.json +1 -1
  12. package/tencentcloud/common/sdk_version.d.ts +1 -1
  13. package/tencentcloud/common/sdk_version.js +1 -1
  14. package/tencentcloud/services/ags/v20250920/ags_models.d.ts +12 -0
  15. package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_models.d.ts +39 -4
  16. package/tencentcloud/services/cfw/v20190904/cfw_client.d.ts +7 -3
  17. package/tencentcloud/services/cfw/v20190904/cfw_client.js +9 -3
  18. package/tencentcloud/services/cfw/v20190904/cfw_models.d.ts +235 -5
  19. package/tencentcloud/services/cls/v20201016/cls_client.d.ts +1 -1
  20. package/tencentcloud/services/cls/v20201016/cls_client.js +1 -1
  21. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +6 -6
  22. package/tencentcloud/services/config/v20220802/config_models.d.ts +20 -12
  23. package/tencentcloud/services/csip/v20221121/csip_models.d.ts +4 -0
  24. package/tencentcloud/services/dts/v20211206/dts_models.d.ts +30 -44
  25. package/tencentcloud/services/emr/v20190103/emr_client.d.ts +19 -11
  26. package/tencentcloud/services/emr/v20190103/emr_client.js +26 -14
  27. package/tencentcloud/services/emr/v20190103/emr_models.d.ts +145 -10
  28. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +2 -2
  29. package/tencentcloud/services/ess/v20201111/ess_client.js +2 -2
  30. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +84 -311
  31. package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +2 -2
  32. package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +2 -2
  33. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +69 -236
  34. package/tencentcloud/services/hai/v20230812/hai_models.d.ts +6 -2
  35. package/tencentcloud/services/hcm/v20181106/hcm_models.d.ts +4 -4
  36. package/tencentcloud/services/iss/v20230517/iss_models.d.ts +53 -33
  37. package/tencentcloud/services/live/v20180801/live_models.d.ts +4 -0
  38. package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts +28 -60
  39. package/tencentcloud/services/mps/v20190612/mps_client.d.ts +24 -8
  40. package/tencentcloud/services/mps/v20190612/mps_client.js +34 -10
  41. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +298 -476
  42. package/tencentcloud/services/mrs/v20200910/mrs_models.d.ts +53 -31
  43. package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +78 -65
  44. package/tencentcloud/services/organization/v20210331/organization_client.d.ts +7 -3
  45. package/tencentcloud/services/organization/v20210331/organization_client.js +9 -3
  46. package/tencentcloud/services/organization/v20210331/organization_models.d.ts +26 -0
  47. package/tencentcloud/services/redis/v20180412/redis_models.d.ts +1 -1
  48. package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts +46 -41
  49. package/tencentcloud/services/tcbr/v20220217/tcbr_client.d.ts +11 -3
  50. package/tencentcloud/services/tcbr/v20220217/tcbr_client.js +15 -3
  51. package/tencentcloud/services/tcbr/v20220217/tcbr_models.d.ts +83 -27
  52. package/tencentcloud/services/tdmq/v20200217/tdmq_client.d.ts +7 -3
  53. package/tencentcloud/services/tdmq/v20200217/tdmq_client.js +9 -3
  54. package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +106 -25
  55. package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.d.ts +7 -3
  56. package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.js +9 -3
  57. package/tencentcloud/services/tdmysql/v20211122/tdmysql_models.d.ts +142 -28
  58. package/tencentcloud/services/teo/v20220901/teo_models.d.ts +2 -56
  59. package/tencentcloud/services/tke/v20180525/tke_client.d.ts +10 -10
  60. package/tencentcloud/services/tke/v20180525/tke_client.js +10 -10
  61. package/tencentcloud/services/tke/v20180525/tke_models.d.ts +182 -136
  62. package/tencentcloud/services/tke/v20220501/tke_models.d.ts +26 -0
  63. package/tencentcloud/services/vclm/v20240523/vclm_client.d.ts +69 -5
  64. package/tencentcloud/services/vclm/v20240523/vclm_client.js +102 -6
  65. package/tencentcloud/services/vclm/v20240523/vclm_models.d.ts +1673 -492
  66. package/tencentcloud/services/vod/v20180717/vod_models.d.ts +8 -0
  67. package/tencentcloud/services/vpc/v20170312/vpc_client.d.ts +5 -1
  68. package/tencentcloud/services/vpc/v20170312/vpc_client.js +6 -0
  69. package/tencentcloud/services/vpc/v20170312/vpc_models.d.ts +32 -2
@@ -54,21 +54,89 @@ export interface SubmitVideoStylizationJobRequest {
54
54
  StyleStrength?: string;
55
55
  }
56
56
  /**
57
- * logo参数
57
+ * SubmitImageToVideoJob请求参数结构体
58
58
  */
59
- export interface LogoParam {
59
+ export interface SubmitImageToVideoJobRequest {
60
60
  /**
61
- * 水印 Url
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
- LogoUrl?: string;
63
+ Model?: string;
64
64
  /**
65
- * 水印 Base64,Url Base64 二选一传入,如果都提供以 Url 为准
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
- LogoImage?: string;
67
+ Image?: Image;
68
68
  /**
69
- * 水印图片位于生成结果图中的坐标及宽高,将按照坐标对标识图片进行位置和大小的拉伸匹配。
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
- LogoRect?: LogoRect;
71
+ ImageTail?: Image;
72
+ /**
73
+ * <p>正向文本提示词。不能超过2500个字符</p>
74
+ */
75
+ Prompt?: string;
76
+ /**
77
+ * <p>负向文本提示词。不能超过2500个字符</p>
78
+ */
79
+ NegativePrompt?: string;
80
+ /**
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
+ */
83
+ Duration?: string;
84
+ /**
85
+ * <p>生成视频的模式<br>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p><p>不同模型版本、视频模式支持范围不同</p><ul><li>v1.6:首尾帧与仅首帧情况下只支持pro</li><li>v2.0、v3.0 :无需配置</li><li>v2.1、v2.5、v2.6:首尾帧情况下只支持pro</li></ul>
86
+ */
87
+ Mode?: string;
88
+ /**
89
+ * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>v2.0、v2.5、v2.6模型的不支持当前参数<br>取值范围:[0, 1]</p>
90
+ */
91
+ CfgScale?: number;
92
+ /**
93
+ * <p>生成视频时是否同时生成声音<br>枚举值:on,off<br>不同模型版本、视频模式支持范围不同</p><ul><li>v2.6:有首尾帧的pro模式只能生成无声的视频</li></ul>
94
+ */
95
+ Sound?: string;
96
+ /**
97
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
98
+ */
99
+ LogoAdd?: number;
100
+ /**
101
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
102
+ */
103
+ LogoParam?: LogoParam;
104
+ /**
105
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,Prompt参数无效,且不支持设定首尾帧生视频</li><li>当前参数为false时,ShotType参数及MultiPrompt参数无效</li></ul>
106
+ */
107
+ MultiShot?: boolean;
108
+ /**
109
+ * <p>分镜方式</p><ul><li>枚举值:customize,intelligence</li><li>当MultiShot参数为true时,当前参数必填</li></ul>
110
+ */
111
+ ShotType?: string;
112
+ /**
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
+ */
115
+ MultiPrompt?: Array<MultiPrompt>;
116
+ /**
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
+ */
119
+ ElementList?: Array<Element>;
120
+ /**
121
+ * <p>静态笔刷涂抹区域(用户通过运动笔刷涂抹的 mask 图片)<br>“运动笔刷”能力包含“动态笔刷 DynamicMasks”和“静态笔刷 StaticMask”两种<br>支持传入图片Base64编码或图片URL(确保可访问,格式要求同 Image 字段)<br>图片格式支持.jpg / .jpeg / .png<br>图片长宽比必须与输入图片相同(即Image字段),否则任务失败(failed)<br>StaticMask和 DynamicMasks.Mask这两张图片的分辨率必须一致,否则任务失败(failed)</p>
122
+ */
123
+ StaticMask?: string;
124
+ /**
125
+ * <p>动态笔刷配置列表<br>可配置多组(最多6组),每组包含“涂抹区域 Mask”与“运动轨迹 Trajectories”序列</p>
126
+ */
127
+ DynamicMasks?: Array<DynamicMask>;
128
+ /**
129
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
130
+ */
131
+ CameraControl?: CameraControl;
132
+ /**
133
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
134
+ */
135
+ CallbackUrl?: string;
136
+ /**
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>
138
+ */
139
+ VoiceList?: Array<Voice>;
72
140
  }
73
141
  /**
74
142
  * DescribeVideoVoiceJob返回参数结构体
@@ -151,202 +219,232 @@ export interface SubmitHumanActorJobRequest {
151
219
  LogoParam?: LogoParam;
152
220
  }
153
221
  /**
154
- * SubmitImageAnimateJob返回参数结构体
222
+ * DescribeImageToVideoViduJob返回参数结构体
155
223
  */
156
- export interface SubmitImageAnimateJobResponse {
224
+ export interface DescribeImageToVideoViduJobResponse {
157
225
  /**
158
- * 图片跳舞任务ID。
226
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
159
227
  */
160
- 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;
161
249
  /**
162
250
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
163
251
  */
164
252
  RequestId?: string;
165
253
  }
166
254
  /**
167
- * 模板信息
255
+ * SubmitTextToVideoViduJob请求参数结构体
168
256
  */
169
- export interface FaceTemplateInfo {
257
+ export interface SubmitTextToVideoViduJobRequest {
170
258
  /**
171
- * 角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字,建议填"0"、"1",依次累加。
259
+ * <p>文本提示词<br>生成视频的文本描述。<br>注:字符长度不能超过 2000 个字符</p>
172
260
  */
173
- TemplateFaceID?: string;
261
+ Prompt: string;
174
262
  /**
175
- * 视频模板中要替换的人脸图片
263
+ * <p>模型名称,可选值,默认viduq2</p><ul><li>viduq2:最新模型</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
176
264
  */
177
- TemplateFaceImage?: Image;
265
+ Model?: string;
178
266
  /**
179
- * 视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。
267
+ * <p>视频时长参数,默认值依据模型而定:</p><ul><li>viduq3-pro、viduq3-turbo: 默认5秒,可选:1-16</li><li>viduq2 : 默认5秒,可选:1-10</li></ul>
180
268
  */
181
- TemplateFaceRect?: FaceRect;
182
- }
183
- /**
184
- * DescribeAigcVideoJob请求参数结构体
185
- */
186
- export interface DescribeAigcVideoJobRequest {
269
+ Duration?: number;
187
270
  /**
188
- * 任务ID。
189
-
190
- 示例值:1194931538865782784
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>
191
272
  */
192
- JobId?: string;
193
- }
194
- /**
195
- * SubmitImageAnimateJob请求参数结构体
196
- */
197
- export interface SubmitImageAnimateJobRequest {
273
+ Bgm?: boolean;
198
274
  /**
199
- * 图片格式:支持PNGJPGJPEGBMPWEBP格式;
200
- 图片分辨率:长边分辨率范围【192,4096】;
201
- 图片大小:不超过10M;
202
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
275
+ * <p>比例<br>默认 16:9,可选值如下:16:99:164:33:41:1</p>
203
276
  */
204
- ImageUrl?: string;
277
+ AspectRatio?: string;
205
278
  /**
206
- * 图片base64数据。
207
- 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
208
- 图片分辨率:长边分辨率范围【192,4096】;
209
- 图片大小:不超过10M;
210
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
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>
211
280
  */
212
- ImageBase64?: string;
281
+ Resolution?: string;
213
282
  /**
214
- * 动作模板ID。取值说明:ke3 科目三;tuziwu 兔子舞;huajiangwu 划桨舞。
215
-
283
+ * <p>风格<br>默认 general,可选值:general、anime<br>general:通用风格,可以通过提示词来控制风格<br>anime:动漫风格,仅在动漫风格表现突出,可以通过不同的动漫风格提示词来控制<br>注:使用q2、q3系列模型时该参数不生效</p>
216
284
  */
217
- TemplateId?: string;
285
+ Style?: string;
218
286
  /**
219
- * 结果视频是否保留模板音频。默认为true
287
+ * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:使用q2、q3系列模型时该参数不生效</p>
220
288
  */
221
- EnableAudio?: boolean;
289
+ MovementAmplitude?: string;
222
290
  /**
223
- * 是否对输入图采用加强检测方案。
224
-
225
- 默认不加强检测(false),仅对输入图做必要的基础检测。
226
-
227
- 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
291
+ * <p>是否使用音视频直出能力,默认为true,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
228
292
  */
229
- EnableBodyJoins?: boolean;
293
+ Audio?: boolean;
230
294
  /**
231
- * 是否对结果视频背景进行分割,默认值为false。
232
- true:分割结果视频,结果视频(ResultVideoUrl)将为去除背景的绿幕视频,并返回掩码视频(MaskVideoUrl);
233
- false:不分割结果视频,结果视频(ResultVideoUrl)为带背景的视频,掩码视频(MaskVideoUrl)为空字符串。
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>
234
296
  */
235
- EnableSegment?: boolean;
297
+ MetaData?: string;
236
298
  /**
237
- * 为生成视频添加标识的开关,默认为0。
238
- 1:添加标识。
239
- 0:不添加标识。
240
- 其他数值:默认按1处理。
241
- 建议您使用显著标识来提示,该视频是 AI 生成的视频。
299
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
242
300
  */
243
- LogoAdd?: number;
301
+ CallbackUrl?: string;
244
302
  /**
245
- * 标识内容设置。
246
- 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
303
+ * <p>透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符</p>
247
304
  */
248
- LogoParam?: LogoParam;
305
+ Payload?: string;
249
306
  /**
250
- * 是否开启人脸检测。
251
-
252
- 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
307
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
253
308
  */
254
- EnableFace?: boolean;
255
- }
256
- /**
257
- * DescribeVideoVoiceJob请求参数结构体
258
- */
259
- export interface DescribeVideoVoiceJobRequest {
309
+ OffPeak?: boolean;
260
310
  /**
261
- * 任务ID。
311
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
262
312
  */
263
- JobId?: string;
313
+ LogoAdd?: number;
314
+ /**
315
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
316
+ */
317
+ LogoParam?: LogoParam;
264
318
  }
265
319
  /**
266
- * SubmitImageToVideoGeneralJob返回参数结构体
320
+ * SubmitVideoEditJob请求参数结构体
267
321
  */
268
- export interface SubmitImageToVideoGeneralJobResponse {
322
+ export interface SubmitVideoEditJobRequest {
269
323
  /**
270
- * 任务ID
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>
271
325
  */
272
- JobId?: string;
326
+ VideoUrl: string;
273
327
  /**
274
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
328
+ * <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
275
329
  */
276
- RequestId?: string;
277
- }
278
- /**
279
- * DescribeVideoFaceFusionJob返回参数结构体
280
- */
281
- export interface DescribeVideoFaceFusionJobResponse {
330
+ Prompt?: string;
282
331
  /**
283
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
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>
284
333
  */
285
- Status?: string;
334
+ Images?: Array<Image>;
286
335
  /**
287
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
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
288
338
  */
289
- ErrorCode?: string;
339
+ Image?: Image;
290
340
  /**
291
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
341
+ * <p>扩展字段。</p>
292
342
  */
293
- ErrorMessage?: string;
343
+ VideoEditParam?: VideoEditParam;
294
344
  /**
295
- * 结果视频 URL。有效期 24 小时。
345
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
296
346
  */
297
- ResultVideoUrl?: string;
347
+ LogoAdd?: number;
298
348
  /**
299
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
349
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
300
350
  */
301
- RequestId?: string;
351
+ LogoParam?: LogoParam;
302
352
  }
303
353
  /**
304
- * DescribeVideoFaceFusionJob请求参数结构体
354
+ * DescribeVideoExtendKlingJob请求参数结构体
305
355
  */
306
- export interface DescribeVideoFaceFusionJobRequest {
356
+ export interface DescribeVideoExtendKlingJobRequest {
307
357
  /**
308
- * 任务ID
358
+ * <p>任务ID。</p>
309
359
  */
310
360
  JobId?: string;
311
361
  }
312
362
  /**
313
- * 人脸框信息。
363
+ * SubmitVideoEditKlingJob请求参数结构体
314
364
  */
315
- export interface FaceRect {
365
+ export interface SubmitVideoEditKlingJobRequest {
316
366
  /**
317
- * <p>人脸框左上角横坐标。</p>
367
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
318
368
  */
319
- X?: number;
369
+ Prompt?: string;
320
370
  /**
321
- * <p>人脸框左上角纵坐标。</p>
371
+ * <p>模型名称,支持kling-video-o1,kling-v3-omni。默认kling-video-o1。</p>
322
372
  */
323
- Y?: number;
373
+ Model?: string;
324
374
  /**
325
- * <p>人脸框宽度。<br>单位:px</p>
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>
326
376
  */
327
- Width?: number;
377
+ ImageList?: Array<ImageInfo>;
328
378
  /**
329
- * <p>人脸框高度。<br>单位:px</p>
379
+ * <p>生成视频的画面纵横比(宽:高)</p><p>枚举值:16:9, 9:16, 1:1</p><p>未使用首帧参考或视频编辑功能时,当前参数必填</p>
330
380
  */
331
- Height?: number;
381
+ AspectRatio?: string;
382
+ /**
383
+ * <p>生成视频时长,单位s</p><p>枚举值:3,4,5,6,7,8,9,10,其中:使用文生视频、首帧图生视频时,仅支持5和10s<br>使用视频编辑功能(“refer_type”:“base”)时,输出结果与传入视频时长相同,此时当前参数无效;此时,按输入视频时长四舍五入取整计量计费</p>
384
+ */
385
+ Duration?: number;
386
+ /**
387
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
388
+ */
389
+ LogoAdd?: number;
390
+ /**
391
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
392
+ */
393
+ LogoParam?: LogoParam;
394
+ /**
395
+ * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
396
+ */
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;
332
426
  }
333
427
  /**
334
- * DescribePortraitSingJob请求参数结构体
428
+ * 生成视频时所引用的音色
335
429
  */
336
- export interface DescribePortraitSingJobRequest {
430
+ export interface Voice {
337
431
  /**
338
- * 任务ID
432
+ * <p>音色id</p>
339
433
  */
340
- JobId: string;
434
+ VoiceId?: string;
341
435
  }
342
436
  /**
343
- * DescribeHunyuanToVideoJob请求参数结构体
437
+ * SubmitImageAnimateJob返回参数结构体
344
438
  */
345
- export interface DescribeHunyuanToVideoJobRequest {
439
+ export interface SubmitImageAnimateJobResponse {
346
440
  /**
347
- * 任务ID
441
+ * 图片跳舞任务ID
348
442
  */
349
- JobId: string;
443
+ JobId?: string;
444
+ /**
445
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
446
+ */
447
+ RequestId?: string;
350
448
  }
351
449
  /**
352
450
  * SubmitVideoFaceFusionJob返回参数结构体
@@ -387,265 +485,195 @@ export interface DescribeTemplateToVideoJobResponse {
387
485
  RequestId?: string;
388
486
  }
389
487
  /**
390
- * SubmitVideoVoiceJob返回参数结构体
488
+ * DescribeReferenceToVideoViduJob返回参数结构体
391
489
  */
392
- export interface SubmitVideoVoiceJobResponse {
490
+ export interface DescribeReferenceToVideoViduJobResponse {
393
491
  /**
394
- * 任务ID。
492
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
395
493
  */
396
- JobId?: string;
494
+ Status?: string;
397
495
  /**
398
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
496
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
399
497
  */
400
- RequestId?: string;
401
- }
402
- /**
403
- * 人脸图片和待被融合的素材模板图的人脸位置信息。
404
- */
405
- export interface FaceMergeInfo {
498
+ ErrorCode?: string;
406
499
  /**
407
- * 融合图片
500
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
408
501
  */
409
- MergeFaceImage?: Image;
502
+ ErrorMessage?: string;
410
503
  /**
411
- * 上传的图片人脸位置信息(人脸框)
412
- Width、Height >= 30。
504
+ * <p>结果视频 URL。有效期 24 小时。</p>
413
505
  */
414
- MergeFaceRect?: FaceRect;
506
+ ResultVideoUrl?: string;
415
507
  /**
416
- * 素材人脸ID,不填默认取上传图片中最大人脸。
508
+ * <p>该任务消耗的积分数量。</p>
417
509
  */
418
- TemplateFaceID?: string;
419
- }
420
- /**
421
- * CheckAnimateImageJob返回参数结构体
422
- */
423
- export interface CheckAnimateImageJobResponse {
510
+ Credits?: number;
424
511
  /**
425
- * 输入图是否通过校验。
512
+ * <p>任务调用时传入的透传参数。</p>
426
513
  */
427
- CheckPass?: boolean;
514
+ Payload?: string;
428
515
  /**
429
516
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
430
517
  */
431
518
  RequestId?: string;
432
519
  }
433
520
  /**
434
- * SubmitVideoEditJob返回参数结构体
521
+ * SubmitMotionControlKlingJob请求参数结构体
435
522
  */
436
- export interface SubmitVideoEditJobResponse {
523
+ export interface SubmitMotionControlKlingJobRequest {
437
524
  /**
438
- * <p>任务ID。</p>
525
+ * <p>模型名称 枚举值:kling-v2-6, kling-v3。</p>
439
526
  */
440
- JobId?: string;
527
+ Model?: string;
441
528
  /**
442
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
529
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
443
530
  */
444
- RequestId?: string;
445
- }
446
- /**
447
- * SubmitTemplateToVideoJob返回参数结构体
448
- */
449
- export interface SubmitTemplateToVideoJobResponse {
531
+ Prompt?: string;
450
532
  /**
451
- * <p>任务ID。</p>
533
+ * <p>参考图像,生成视频中的人物、背景等元素均以参考图为准 视频内容需满足以下要求: 人物比例尽量与参考动作比例一致,尽量避免全身动作驱动半身人物进行生成 人物需要露出清晰的上半身或全身的肢体及头部,避免遮挡 画面中人物避免存在极端朝向,比如倒立、平卧等。人物占画面比例不得太低 支持真实/风格化的角色(包括人物/类人动物/部分纯动物/部分类人肢体比例的角色)通过 包含支持传入图片Base64编码或图片URL(确保可访问)。</p>
452
534
  */
453
- JobId?: string;
535
+ Image?: string;
454
536
  /**
455
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
537
+ * <p>参考视频的获取链接。生成视频中的人物动作与参考视频一致。 视频内容需满足以下要求: 人物需要漏出清晰的上半身或全身的全部肢体及头部,避免遮挡 建议上传1人动作视频,2人及以上会取画面占比最大的人物动作进行生成 推荐使用真人动作,部分风格化的人物/类人肢体比例可以通过 动作视频一镜到底,角色始终出现在画面中,避免切镜、运镜等。否则会被截取 动作避免过快,相对平稳的动作生成效果更佳 视频文件支持.mp4/.mov,文件大小不超过100MB,仅支持长宽的边长均位于340px~3850px之间,上述校验不通过会返回错误码等信息 视频时长下限不短于3秒,时长上限与人物朝向参考(character_orientation)有关: 当人物朝向与视频中人物一致时,视频时长最长可达30秒; 当人物朝向与图片中人物一致时,视频时长最长可达10秒; 如果您的动作难度比较高、速度比较快,有一定概率生成不足上传视频时长的结果,因为模型只能提取有效动作时长进行生成,最短提取出3s可用连续动作即可生成。请注意,因此消耗的积分将无法退还,建议适当调整动作难度与速度 系统会校验视频内容,如有问题会返回错误码等信息。</p>
456
538
  */
457
- RequestId?: string;
458
- }
459
- /**
460
- * CheckAnimateImageJob请求参数结构体
461
- */
462
- export interface CheckAnimateImageJobRequest {
539
+ Video?: string;
463
540
  /**
464
- * 动作模板ID。
541
+ * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
465
542
  */
466
- TemplateId: string;
543
+ Mode?: string;
467
544
  /**
468
- * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
469
- 图片分辨率:长边分辨率范围【192,4096】;
470
- 图片大小:不超过10M;
471
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
545
+ * <p>可选择是否保留视频原声 枚举值:yes,no 其中yes:保留视频原声 其中no:不保留视频原声。</p>
472
546
  */
473
- ImageUrl?: string;
547
+ KeepOriginalSound?: string;
474
548
  /**
475
- * 图片base64数据。
476
- 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
477
- 图片分辨率:长边分辨率范围【192,4096】;
478
- 图片大小:不超过10M;
479
- 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
549
+ * <p>生成视频中人物的朝向,可选择与图片一致或与视频一致 枚举值:image,video,其中: 其中image:与图片中人物朝向一致;此时参考视频时长不得超过10秒; 其中video:与视频中人物朝向一致;此时参考视频时长不得超过30秒; 引用主体时,生成的视频暂时只能参考视频中的人物朝向。</p>
480
550
  */
481
- ImageBase64?: string;
551
+ CharacterOrientation?: string;
482
552
  /**
483
- * 是否对输入图采用加强检测方案。
484
-
485
- 默认不加强检测(false),仅对输入图做必要的基础检测。
486
-
487
- 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
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>
488
554
  */
489
- EnableBodyJoins?: boolean;
555
+ ElementList?: Array<Element>;
490
556
  /**
491
- * 是否开启人脸检测。
492
-
493
- 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
557
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
494
558
  */
495
- EnableFace?: boolean;
496
- }
497
- /**
498
- * DescribeVideoStylizationJob请求参数结构体
499
- */
500
- export interface DescribeVideoStylizationJobRequest {
559
+ CallbackUrl?: string;
501
560
  /**
502
- * 任务ID
561
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
503
562
  */
504
- JobId: string;
563
+ LogoAdd?: number;
564
+ /**
565
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
566
+ */
567
+ LogoParam?: LogoParam;
505
568
  }
506
569
  /**
507
- * SubmitHumanActorJob返回参数结构体
570
+ * SubmitVideoExtendKlingJob请求参数结构体
508
571
  */
509
- export interface SubmitHumanActorJobResponse {
572
+ export interface SubmitVideoExtendKlingJobRequest {
510
573
  /**
511
- * 任务ID
574
+ * <p>视频ID 支持通过文本、图片和视频延长生成的视频的ID(原视频不能超过3分钟) 请注意,基于目前的清理策略、视频生成30天之后会被清理,则无法进行延长</p>
512
575
  */
513
- JobId?: string;
576
+ VideoId: string;
514
577
  /**
515
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
578
+ * <p>正向文本提示词 不能超过2500个字符</p>
516
579
  */
517
- RequestId?: string;
518
- }
519
- /**
520
- * DescribeImageAnimateJob返回参数结构体
521
- */
522
- export interface DescribeImageAnimateJobResponse {
580
+ Prompt?: string;
523
581
  /**
524
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
582
+ * <p>负向文本提示词 不能超过2500个字符</p>
525
583
  */
526
- Status?: string;
584
+ NegativePrompt?: string;
527
585
  /**
528
- * 错误码。
586
+ * <p>提示词参考强度 取值范围:[0,1],数值越大参考强度越大</p>
529
587
  */
530
- ErrorCode?: string;
588
+ CfgScale?: number;
531
589
  /**
532
- * 错误信息。
590
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
533
591
  */
534
- ErrorMessage?: string;
592
+ CallbackUrl?: string;
535
593
  /**
536
- * 结果视频URL。有效期 24 小时。
594
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
537
595
  */
538
- ResultVideoUrl?: string;
596
+ LogoAdd?: number;
539
597
  /**
540
- * 掩码视频链接
598
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
541
599
  */
542
- MaskVideoUrl?: string;
600
+ LogoParam?: LogoParam;
601
+ }
602
+ /**
603
+ * SubmitTemplateToVideoJob返回参数结构体
604
+ */
605
+ export interface SubmitTemplateToVideoJobResponse {
606
+ /**
607
+ * <p>任务ID。</p>
608
+ */
609
+ JobId?: string;
543
610
  /**
544
611
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
545
612
  */
546
613
  RequestId?: string;
547
614
  }
548
615
  /**
549
- * SubmitPortraitSingJob请求参数结构体
616
+ * SubmitTemplateToVideoJob请求参数结构体
550
617
  */
551
- export interface SubmitPortraitSingJobRequest {
618
+ export interface SubmitTemplateToVideoJobRequest {
552
619
  /**
553
- * 传入音频URL地址,音频要求:
554
- - 音频时长:2秒 - 60秒
555
- - 音频格式:mp3、wav、m4a
620
+ * <p>特效模板名称。请在 <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板列表</a> 中选择想要生成的特效对应的 template 名称。</p>
556
621
  */
557
- AudioUrl: string;
622
+ Template: string;
558
623
  /**
559
- * 传入图片URL地址,图片要求:
560
- - 图片格式:jpg、jpeg、png、bmp、webp
561
- - 图片分辨率:192~4096
562
- - 图片大小:不超过10M
563
- - 图片宽高比:图片【宽:高】在1:2到2:1范围内
564
- - 图片内容:避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
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>
565
625
  */
566
- ImageUrl?: string;
626
+ Images: Array<Image>;
567
627
  /**
568
- * 传入图片Base64编码,编码后请求体大小不超过10M。
569
- 图片Base64编码与URL地址必传其一,如果都传以ImageBase64为准。
628
+ * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
570
629
  */
571
- ImageBase64?: string;
630
+ LogoAdd?: number;
572
631
  /**
573
- * 唱演模式,默认使用人像模式。
574
- Person:人像模式,仅支持上传人像图片,人像生成效果更好,如果图中未检测到有效人脸将被拦截,生成时会将视频短边分辨率放缩至512。
575
- Pet:宠物模式,支持宠物等非人像图片,固定生成512:512分辨率视频。
632
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
576
633
  */
577
- Mode?: string;
634
+ LogoParam?: LogoParam;
578
635
  /**
579
- * 生成视频尺寸。可选取值:"512:512"
580
-
581
- 人像模式下,如果不传该参数,默认生成视频的短边分辨率为512,长边分辨率不固定、由模型根据生成效果自动适配得到。如需固定生成分辨率可传入512:512。
582
-
583
- 宠物模式下,如果不传该参数,默认将脸部唱演视频回贴原图,生成视频分辨率与原图一致。如不需要脸部回贴,仅保留脸部唱演视频,可传入512:512。
636
+ * <p>视频输出分辨率,默认值:360p 。不同特效支持的清晰度及消耗积分数详见:<a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-单次调用消耗积分数列</a></p>
584
637
  */
585
638
  Resolution?: string;
586
639
  /**
587
- * 为生成视频添加标识的开关,默认为1。
588
- 1:添加标识;
589
- 0:不添加标识;
590
- 其他数值:默认按1处理。
591
- 建议您使用显著标识来提示,该视频是 AI 生成的视频。
640
+ * <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
592
641
  */
593
- LogoAdd?: number;
642
+ BGM?: boolean;
594
643
  /**
595
- * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
644
+ * <p>扩展字段。</p>
596
645
  */
597
- LogoParam?: LogoParam;
646
+ ExtraParam?: ExtraParam;
598
647
  }
599
648
  /**
600
649
  * 水印图输入框
601
650
  */
602
651
  export interface LogoRect {
603
652
  /**
604
- * 水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。
653
+ * <p>水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。</p>
605
654
  */
606
655
  X?: number;
607
656
  /**
608
- * 水印图框Y坐标值。当值大于0时,坐标轴原点位于原图上侧,方向指下;当值小于0时,坐标轴原点位于原图下侧,方向指上。
657
+ * <p>水印图框Y坐标值。当值大于0时,坐标轴原点位于原图上侧,方向指下;当值小于0时,坐标轴原点位于原图下侧,方向指上。</p>
609
658
  */
610
659
  Y?: number;
611
660
  /**
612
- * 水印图框宽度。
661
+ * <p>水印图框宽度。<br>单位:px</p>
613
662
  */
614
663
  Width?: number;
615
664
  /**
616
- * 水印图框高度。
665
+ * <p>水印图框高度。<br>单位:px</p>
617
666
  */
618
667
  Height?: number;
619
668
  }
620
669
  /**
621
- * DescribeAigcVideoJob返回参数结构体
670
+ * DescribeVideoEditKlingJob请求参数结构体
622
671
  */
623
- export interface DescribeAigcVideoJobResponse {
624
- /**
625
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
626
- 示例值:RUN
627
- */
628
- Status?: string;
629
- /**
630
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
631
- 示例值:FailedOperation.DriverFailed
632
- */
633
- ErrorCode?: string;
634
- /**
635
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
636
- 示例值:驱动失败
637
- */
638
- ErrorMessage?: string;
639
- /**
640
- * 结果视频 URL。有效期 24 小时。
641
-
642
- 示例值:https://console.cloud.tencent.com/result.mp4
643
- */
644
- ResultUrl?: string;
672
+ export interface DescribeVideoEditKlingJobRequest {
645
673
  /**
646
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
674
+ * <p>任务ID</p>
647
675
  */
648
- RequestId?: string;
676
+ JobId: string;
649
677
  }
650
678
  /**
651
679
  * SubmitVideoVoiceJob请求参数结构体
@@ -673,67 +701,37 @@ export interface SubmitVideoVoiceJobRequest {
673
701
  LogoParam?: LogoParam;
674
702
  }
675
703
  /**
676
- * SubmitAigcVideoJob请求参数结构体
704
+ * DescribeTextToVideoJob返回参数结构体
677
705
  */
678
- export interface SubmitAigcVideoJobRequest {
679
- /**
680
- * <p>模型名称。</p><p>枚举值:</p><p>● Vidu;</p><p>● Kling:可灵;</p><p>● HY:混元;</p><p>● YT:优图;</p><p>示例值:Vidu</p>
681
- */
682
- Vendor: string;
683
- /**
684
- * <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>
685
- */
686
- Model: string;
687
- /**
688
- * <p>模型参数Json-Format字符串<br> <a href="https://cloud.tencent.com/document/product/1616/128996">模型参数列表</a></p>
689
- */
690
- ModelParam?: string;
691
- /**
692
- * <p>正向文本提示词。不能超过2000个字符</p><p>示例值:一只小猫在草地奔跑</p>
693
- */
694
- Prompt?: string;
695
- /**
696
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
697
- */
698
- LogoAdd?: number;
706
+ export interface DescribeTextToVideoJobResponse {
699
707
  /**
700
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
708
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
701
709
  */
702
- LogoParam?: LogoParam;
703
- }
704
- /**
705
- * SubmitHunyuanToVideoJob返回参数结构体
706
- */
707
- export interface SubmitHunyuanToVideoJobResponse {
710
+ Status?: string;
708
711
  /**
709
- * 任务ID
712
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
710
713
  */
711
- JobId?: string;
714
+ ErrorCode?: string;
712
715
  /**
713
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
716
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
714
717
  */
715
- RequestId?: string;
716
- }
717
- /**
718
- * DescribeHumanActorJob返回参数结构体
719
- */
720
- export interface DescribeHumanActorJobResponse {
718
+ ErrorMessage?: string;
721
719
  /**
722
- * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
720
+ * <p>结果视频 URL。有效期 24 小时。</p>
723
721
  */
724
- Status?: string;
722
+ ResultVideoUrl?: string;
725
723
  /**
726
- * 结果视频URL。有效期 24 小时。
724
+ * <p>视频id</p>
727
725
  */
728
- ResultVideoUrl?: string;
726
+ VideoId?: string;
729
727
  /**
730
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
728
+ * <p>视频总时长,单位s</p>
731
729
  */
732
- ErrorCode?: string;
730
+ Duration?: string;
733
731
  /**
734
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
732
+ * <p>任务最终扣减积分数值</p>
735
733
  */
736
- ErrorMessage?: string;
734
+ FinalUnitDeduction?: string;
737
735
  /**
738
736
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
739
737
  */
@@ -782,57 +780,22 @@ export interface DescribeVideoEditJobResponse {
782
780
  RequestId?: string;
783
781
  }
784
782
  /**
785
- * DescribeVideoStylizationJob返回参数结构体
783
+ * SubmitVideoStylizationJob返回参数结构体
786
784
  */
787
- export interface DescribeVideoStylizationJobResponse {
785
+ export interface SubmitVideoStylizationJobResponse {
788
786
  /**
789
- * 任务ID
787
+ * 任务ID。任务有效期为48小时。
790
788
  */
791
789
  JobId?: string;
792
790
  /**
793
- * 任务状态码。取值说明:
794
- JobInit: "初始化中";
795
- JobModerationFailed: "审核失败";
796
- JobRunning: "处理中";
797
- JobFailed: "处理失败";
798
- JobSuccess: "处理完成"。
791
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
799
792
  */
800
- StatusCode?: string;
801
- /**
802
- * 任务状态描述。取值说明:
803
- JobInit: "初始化中";
804
- JobModerationFailed: "审核失败";
805
- JobRunning: "处理中";
806
- JobFailed: "处理失败";
807
- JobSuccess: "处理完成"。
808
- */
809
- StatusMsg?: string;
810
- /**
811
- * 处理结果视频Url。URL有效期为24小时。
812
- */
813
- ResultVideoUrl?: string;
814
- /**
815
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
816
- */
817
- RequestId?: string;
818
- }
819
- /**
820
- * SubmitVideoStylizationJob返回参数结构体
821
- */
822
- export interface SubmitVideoStylizationJobResponse {
823
- /**
824
- * 任务ID。任务有效期为48小时。
825
- */
826
- JobId?: string;
827
- /**
828
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
829
- */
830
- RequestId?: string;
831
- }
832
- /**
833
- * SubmitVideoFaceFusionJob请求参数结构体
834
- */
835
- export interface SubmitVideoFaceFusionJobRequest {
793
+ RequestId?: string;
794
+ }
795
+ /**
796
+ * SubmitVideoFaceFusionJob请求参数结构体
797
+ */
798
+ export interface SubmitVideoFaceFusionJobRequest {
836
799
  /**
837
800
  * 视频素材下载地址。用户自定义模板视频下载地址,使用前需要先调用视频审核接口进行内容审核。视频限制:分辨率≤4k,fps≤25,视频大小≤1G,时长≤20 秒,支持格式mp4。
838
801
 
@@ -877,50 +840,81 @@ export interface SubmitVideoFaceFusionJobRequest {
877
840
  LogoParam?: LogoParam;
878
841
  }
879
842
  /**
880
- * SubmitPortraitSingJob返回参数结构体
843
+ * SubmitReferenceToVideoViduJob请求参数结构体
881
844
  */
882
- export interface SubmitPortraitSingJobResponse {
845
+ export interface SubmitReferenceToVideoViduJobRequest {
883
846
  /**
884
- * 任务ID。任务有效期为48小时。
847
+ * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:使用Subjects主体参数时,可以通过@主体id 来表示主体内容,例如:&quot;@1 和 @2 在一起吃火锅,并且旁白音说火锅大家都爱吃。&quot;</p>
885
848
  */
886
- JobId?: string;
849
+ Prompt: string;
887
850
  /**
888
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
851
+ * <p>图像参考<br>【非主体调用时传入】<br>支持上传1~7张图片,模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。<br>支持传入图片 Base64 编码或图片URL(确保可访问)<br>图片支持 png、jpeg、jpg、webp格式<br>图片像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过50M。</p>
889
852
  */
890
- RequestId?: string;
891
- }
892
- /**
893
- * SubmitTemplateToVideoJob请求参数结构体
894
- */
895
- export interface SubmitTemplateToVideoJobRequest {
853
+ Images?: Array<string>;
896
854
  /**
897
- * <p>特效模板名称。请在 <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板列表</a> 中选择想要生成的特效对应的 template 名称。</p>
855
+ * <p>参考生图主体信息,支持1-7个主体,主体图片共1 7张<br>【主体调用时传入】</p>
898
856
  */
899
- Template: string;
857
+ Subjects?: Array<ReferenceSubject>;
900
858
  /**
901
- * <p>参考图像,不同特效输入图片的数量详见: <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-图片要求说明</a></p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片格式:支持pngjpgjpeg、webp、bmp、tiff</li><li>图片文件:大小不能超过10MB(base64后),图片分辨率不小于300×300px,不大于4096×4096,图片宽高比应在1:4 ~ 4:1之间</li></ul>
859
+ * <p>视频参考支持上传1~2个视频,模型将以此参数中传入的视频作为参考,生成具备主体一致的视频。<br>注1: 仅viduq2-pro模型支持该参数<br>注2:使用视频参考功能时,最多支持上传 1个8秒 视频 或 2个5秒 视频<br>注3:视频支持 mp4avimov格式<br>注4:视频像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过100M。</p>
902
860
  */
903
- Images: Array<Image>;
861
+ Videos?: Array<string>;
904
862
  /**
905
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
863
+ * <p>模型名称,可选值,当前仅可并且默认viduq2</p><ul><li>viduq2:最新模型</li></ul>
906
864
  */
907
- LogoAdd?: number;
865
+ Model?: string;
908
866
  /**
909
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
867
+ * <p>是否使用音视频直出能力,默认false,可选值 true、false</p><ul><li>true:使用音视频直出能力。</li><li>false:不使用音视频直出能力。<br>仅上传主体时支持此功能</li></ul>
910
868
  */
911
- LogoParam?: LogoParam;
869
+ Audio?: boolean;
912
870
  /**
913
- * <p>视频输出分辨率,默认值:360p 。不同特效支持的清晰度及消耗积分数详见:<a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板-单次调用消耗积分数列</a></p>
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>
914
888
  */
915
889
  Resolution?: string;
916
890
  /**
917
- * <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
891
+ * <p>运动幅度默认 auto,可选值:auto、small、medium、large<br>注:使用q2系列模型时该参数不生效</p>
918
892
  */
919
- BGM?: boolean;
893
+ MovementAmplitude?: string;
920
894
  /**
921
- * <p>扩展字段。</p>
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>
922
896
  */
923
- ExtraParam?: ExtraParam;
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;
924
918
  }
925
919
  /**
926
920
  * SubmitImageToVideoGeneralJob请求参数结构体
@@ -956,55 +950,77 @@ export interface SubmitImageToVideoGeneralJobRequest {
956
950
  LogoParam?: LogoParam;
957
951
  }
958
952
  /**
959
- * SubmitHunyuanToVideoJob请求参数结构体
953
+ * SubmitImageToVideoViduJob请求参数结构体
960
954
  */
961
- export interface SubmitHunyuanToVideoJobRequest {
955
+ export interface SubmitImageToVideoViduJobRequest {
962
956
  /**
963
- * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。 示例值:一只猫在草原上奔跑,写实风格
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>
964
958
  */
965
- Prompt: string;
959
+ Images: Array<string>;
966
960
  /**
967
- * 输入图片
968
- 上传图url大小不超过 10M,base64不超过8M。
969
- 支持jpg,png,jpeg,webp,bmp,tiff 格式
970
- 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
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>
971
962
  */
972
- Image?: Image;
963
+ Model?: string;
973
964
  /**
974
- * 目前仅支持720p视频分辨率,默认720p。
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>
975
986
  */
976
987
  Resolution?: string;
977
988
  /**
978
- * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。
979
- 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
989
+ * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:q2、q3系列模型改参数不生效</p>
980
990
  */
981
- LogoAdd?: number;
991
+ MovementAmplitude?: string;
982
992
  /**
983
- * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
993
+ * <p>bgm</p>
984
994
  */
985
- LogoParam?: LogoParam;
986
- }
987
- /**
988
- * 图片
989
- */
990
- export interface Image {
995
+ Bgm?: boolean;
991
996
  /**
992
- * 图片Base64
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>
993
998
  */
994
- Base64?: string;
999
+ AudioType?: string;
995
1000
  /**
996
- * 图片Url
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>
997
1002
  */
998
- Url?: string;
999
- }
1000
- /**
1001
- * DescribeVideoEditJob请求参数结构体
1002
- */
1003
- export interface DescribeVideoEditJobRequest {
1003
+ MetaData?: string;
1004
1004
  /**
1005
- * 任务ID。
1005
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
1006
1006
  */
1007
- JobId: string;
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;
1008
1024
  }
1009
1025
  /**
1010
1026
  * DescribeHumanActorJob请求参数结构体
@@ -1038,126 +1054,1291 @@ export interface SubmitAigcVideoJobResponse {
1038
1054
  RequestId?: string;
1039
1055
  }
1040
1056
  /**
1041
- * DescribeTemplateToVideoJob请求参数结构体
1057
+ * SubmitVideoVoiceJob返回参数结构体
1042
1058
  */
1043
- export interface DescribeTemplateToVideoJobRequest {
1059
+ export interface SubmitVideoVoiceJobResponse {
1044
1060
  /**
1045
1061
  * 任务ID。
1046
1062
  */
1047
- JobId: string;
1063
+ JobId?: string;
1064
+ /**
1065
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1066
+ */
1067
+ RequestId?: string;
1048
1068
  }
1049
1069
  /**
1050
- * SubmitVideoEditJob请求参数结构体
1070
+ * SubmitImageToVideoViduJob返回参数结构体
1051
1071
  */
1052
- export interface SubmitVideoEditJobRequest {
1053
- /**
1054
- * <p>参考视频URL。默认为待编辑视频。</p><ul><li>视频格式:支持MP4</li><li>视频时长:输入视频时长≤10秒</li><li>视频大小:不超过200M</li><li>视频文件:输入的视频帧率及分辨率不做限制(建议输入16:9或9:16的视频;分辨率建议在2160px内,帧率建议在60fps内);输出视频是帧率会≥16fps,分辨率为720p</li></ul>
1055
- */
1056
- VideoUrl: string;
1057
- /**
1058
- * <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
1059
- */
1060
- Prompt?: string;
1061
- /**
1062
- * <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>
1063
- */
1064
- Images?: Array<Image>;
1065
- /**
1066
- * <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>
1067
- * @deprecated
1068
- */
1069
- Image?: Image;
1070
- /**
1071
- * <p>扩展字段。</p>
1072
- */
1073
- VideoEditParam?: VideoEditParam;
1072
+ export interface SubmitImageToVideoViduJobResponse {
1074
1073
  /**
1075
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
1074
+ * <p>任务ID。</p>
1076
1075
  */
1077
- LogoAdd?: number;
1076
+ JobId?: string;
1078
1077
  /**
1079
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
1078
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1080
1079
  */
1081
- LogoParam?: LogoParam;
1080
+ RequestId?: string;
1082
1081
  }
1083
1082
  /**
1084
- * DescribeImageAnimateJob请求参数结构体
1083
+ * SubmitPortraitSingJob返回参数结构体
1085
1084
  */
1086
- export interface DescribeImageAnimateJobRequest {
1085
+ export interface SubmitPortraitSingJobResponse {
1087
1086
  /**
1088
- * 任务ID
1087
+ * 任务ID。任务有效期为48小时。
1089
1088
  */
1090
1089
  JobId?: string;
1090
+ /**
1091
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1092
+ */
1093
+ RequestId?: string;
1091
1094
  }
1092
1095
  /**
1093
- * DescribePortraitSingJob返回参数结构体
1096
+ * DescribeImageToVideoJob返回参数结构体
1094
1097
  */
1095
- export interface DescribePortraitSingJobResponse {
1098
+ export interface DescribeImageToVideoJobResponse {
1096
1099
  /**
1097
- * 任务ID
1100
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1098
1101
  */
1099
- JobId?: string;
1102
+ Status?: string;
1100
1103
  /**
1101
- * 任务状态码
1102
- —RUN:处理中
1103
- —FAIL:处理失败
1104
- —STOP:处理终止
1105
- —DONE:处理完成
1104
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1106
1105
  */
1107
- StatusCode?: string;
1106
+ ErrorCode?: string;
1108
1107
  /**
1109
- * 任务状态信息
1108
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1110
1109
  */
1111
- StatusMsg?: string;
1110
+ ErrorMessage?: string;
1112
1111
  /**
1113
- * 任务执行错误码。当任务状态不为FAIL时,该值为""。
1112
+ * <p>结果视频 URL。有效期 24 小时。</p>
1114
1113
  */
1115
- ErrorCode?: string;
1114
+ ResultVideoUrl?: string;
1116
1115
  /**
1117
- * 任务执行错误信息。当任务状态不为FAIL时,该值为""。
1116
+ * <p>视频id</p>
1118
1117
  */
1119
- ErrorMessage?: string;
1118
+ VideoId?: string;
1120
1119
  /**
1121
- * 生成视频的URL地址。有效期24小时。
1120
+ * <p>视频总时长,单位s</p>
1122
1121
  */
1123
- ResultVideoUrl?: string;
1122
+ Duration?: string;
1123
+ /**
1124
+ * <p>任务最终扣减积分数值</p>
1125
+ */
1126
+ FinalUnitDeduction?: string;
1124
1127
  /**
1125
1128
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1126
1129
  */
1127
1130
  RequestId?: string;
1128
1131
  }
1129
1132
  /**
1130
- * DescribeHunyuanToVideoJob返回参数结构体
1133
+ * DescribePortraitSingJob请求参数结构体
1131
1134
  */
1132
- export interface DescribeHunyuanToVideoJobResponse {
1135
+ export interface DescribePortraitSingJobRequest {
1133
1136
  /**
1134
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1137
+ * 任务ID
1135
1138
  */
1136
- Status?: string;
1139
+ JobId: string;
1140
+ }
1141
+ /**
1142
+ * DescribeHunyuanToVideoJob请求参数结构体
1143
+ */
1144
+ export interface DescribeHunyuanToVideoJobRequest {
1137
1145
  /**
1138
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1146
+ * 任务ID
1139
1147
  */
1140
- ErrorCode?: string;
1148
+ JobId: string;
1149
+ }
1150
+ /**
1151
+ * DescribeMotionControlKlingJob请求参数结构体
1152
+ */
1153
+ export interface DescribeMotionControlKlingJobRequest {
1141
1154
  /**
1142
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1155
+ * <p>任务ID</p>
1143
1156
  */
1144
- ErrorMessage?: string;
1157
+ JobId: string;
1158
+ }
1159
+ /**
1160
+ * CheckAnimateImageJob返回参数结构体
1161
+ */
1162
+ export interface CheckAnimateImageJobResponse {
1145
1163
  /**
1146
- * 结果视频 URL。有效期 24 小时。
1164
+ * 输入图是否通过校验。
1147
1165
  */
1148
- ResultVideoUrl?: string;
1166
+ CheckPass?: boolean;
1149
1167
  /**
1150
1168
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1151
1169
  */
1152
1170
  RequestId?: string;
1153
1171
  }
1154
1172
  /**
1155
- * 视频编辑参数
1173
+ * SubmitVideoEditJob返回参数结构体
1156
1174
  */
1157
- export interface VideoEditParam {
1175
+ export interface SubmitVideoEditJobResponse {
1158
1176
  /**
1159
- * 魔法词,针对特定场景生效。不同场景传不同的值。默认不传。
1160
- - 换人场景:1
1177
+ * <p>任务ID。</p>
1161
1178
  */
1162
- Magic?: string;
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请求参数结构体
1479
+ */
1480
+ export interface DescribeVideoFaceFusionJobRequest {
1481
+ /**
1482
+ * 任务ID
1483
+ */
1484
+ JobId?: string;
1485
+ }
1486
+ /**
1487
+ * DescribeImageToVideoViduJob请求参数结构体
1488
+ */
1489
+ export interface DescribeImageToVideoViduJobRequest {
1490
+ /**
1491
+ * <p>任务ID</p>
1492
+ */
1493
+ JobId: string;
1494
+ }
1495
+ /**
1496
+ * SubmitVideoEditKlingJob返回参数结构体
1497
+ */
1498
+ export interface SubmitVideoEditKlingJobResponse {
1499
+ /**
1500
+ * <p>任务ID</p>
1501
+ */
1502
+ JobId?: string;
1503
+ /**
1504
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1505
+ */
1506
+ RequestId?: string;
1507
+ }
1508
+ /**
1509
+ * 指定摄像机在不同方向上的运动或变化
1510
+ */
1511
+ export interface CameraControlConfig {
1512
+ /**
1513
+ * 水平运镜,控制摄像机在水平方向上的移动量(沿x轴平移)
1514
+
1515
+ 取值范围:[-10, 10],负值表示向左平移,正值表示向右平移
1516
+ */
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;
1548
+ }
1549
+ /**
1550
+ * DescribeReferenceToVideoViduJob请求参数结构体
1551
+ */
1552
+ export interface DescribeReferenceToVideoViduJobRequest {
1553
+ /**
1554
+ * <p>任务ID</p>
1555
+ */
1556
+ JobId: string;
1557
+ }
1558
+ /**
1559
+ * DescribeImageAnimateJob返回参数结构体
1560
+ */
1561
+ export interface DescribeImageAnimateJobResponse {
1562
+ /**
1563
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1564
+ */
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;
1582
+ /**
1583
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1584
+ */
1585
+ RequestId?: string;
1586
+ }
1587
+ /**
1588
+ * DescribeAigcVideoJob返回参数结构体
1589
+ */
1590
+ export interface DescribeAigcVideoJobResponse {
1591
+ /**
1592
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1593
+ 示例值:RUN
1594
+ */
1595
+ Status?: string;
1596
+ /**
1597
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1598
+ 示例值:FailedOperation.DriverFailed
1599
+ */
1600
+ ErrorCode?: string;
1601
+ /**
1602
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1603
+ 示例值:驱动失败
1604
+ */
1605
+ ErrorMessage?: string;
1606
+ /**
1607
+ * 结果视频 URL。有效期 24 小时。
1608
+
1609
+ 示例值:https://console.cloud.tencent.com/result.mp4
1610
+ */
1611
+ ResultUrl?: string;
1612
+ /**
1613
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1614
+ */
1615
+ RequestId?: string;
1616
+ }
1617
+ /**
1618
+ * SubmitVideoExtendKlingJob返回参数结构体
1619
+ */
1620
+ export interface SubmitVideoExtendKlingJobResponse {
1621
+ /**
1622
+ * <p>任务ID。</p>
1623
+ */
1624
+ JobId?: string;
1625
+ /**
1626
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1627
+ */
1628
+ RequestId?: string;
1629
+ }
1630
+ /**
1631
+ * DescribeHumanActorJob返回参数结构体
1632
+ */
1633
+ export interface DescribeHumanActorJobResponse {
1634
+ /**
1635
+ * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1636
+ */
1637
+ Status?: string;
1638
+ /**
1639
+ * 结果视频URL。有效期 24 小时。
1640
+ */
1641
+ ResultVideoUrl?: string;
1642
+ /**
1643
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1644
+ */
1645
+ ErrorCode?: string;
1646
+ /**
1647
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1648
+ */
1649
+ ErrorMessage?: string;
1650
+ /**
1651
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1652
+ */
1653
+ RequestId?: string;
1654
+ }
1655
+ /**
1656
+ * SubmitMotionControlKlingJob返回参数结构体
1657
+ */
1658
+ export interface SubmitMotionControlKlingJobResponse {
1659
+ /**
1660
+ * <p>任务ID</p>
1661
+ */
1662
+ JobId?: string;
1663
+ /**
1664
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1665
+ */
1666
+ RequestId?: string;
1667
+ }
1668
+ /**
1669
+ * SubmitTextToVideoJob返回参数结构体
1670
+ */
1671
+ export interface SubmitTextToVideoJobResponse {
1672
+ /**
1673
+ * <p>任务ID。</p>
1674
+ */
1675
+ JobId?: string;
1676
+ /**
1677
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1678
+ */
1679
+ RequestId?: string;
1680
+ }
1681
+ /**
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时,当前参数不得为空
1709
+ */
1710
+ export interface MultiPrompt {
1711
+ /**
1712
+ * <p>分镜序号</p>
1713
+ */
1714
+ Index?: number;
1715
+ /**
1716
+ * <p>分镜提示词</p>
1717
+ */
1718
+ Prompt?: string;
1719
+ /**
1720
+ * <p>时长</p>
1721
+ */
1722
+ Duration?: string;
1723
+ }
1724
+ /**
1725
+ * DescribeTextToVideoJob请求参数结构体
1726
+ */
1727
+ export interface DescribeTextToVideoJobRequest {
1728
+ /**
1729
+ * <p>任务ID。</p>
1730
+ */
1731
+ JobId: string;
1732
+ }
1733
+ /**
1734
+ * DescribeImageToVideoJob请求参数结构体
1735
+ */
1736
+ export interface DescribeImageToVideoJobRequest {
1737
+ /**
1738
+ * <p>任务ID。</p>
1739
+ */
1740
+ JobId: string;
1741
+ }
1742
+ /**
1743
+ * DescribeTemplateToVideoJob请求参数结构体
1744
+ */
1745
+ export interface DescribeTemplateToVideoJobRequest {
1746
+ /**
1747
+ * 任务ID。
1748
+ */
1749
+ JobId: string;
1750
+ }
1751
+ /**
1752
+ * SubmitTextToVideoViduJob返回参数结构体
1753
+ */
1754
+ export interface SubmitTextToVideoViduJobResponse {
1755
+ /**
1756
+ * <p>任务ID。</p>
1757
+ */
1758
+ JobId?: string;
1759
+ /**
1760
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1761
+ */
1762
+ RequestId?: string;
1763
+ }
1764
+ /**
1765
+ * DescribeImageAnimateJob请求参数结构体
1766
+ */
1767
+ export interface DescribeImageAnimateJobRequest {
1768
+ /**
1769
+ * 任务ID。
1770
+ */
1771
+ JobId?: string;
1772
+ }
1773
+ /**
1774
+ * DescribePortraitSingJob返回参数结构体
1775
+ */
1776
+ export interface DescribePortraitSingJobResponse {
1777
+ /**
1778
+ * 任务ID
1779
+ */
1780
+ JobId?: string;
1781
+ /**
1782
+ * 任务状态码
1783
+ —RUN:处理中
1784
+ —FAIL:处理失败
1785
+ —STOP:处理终止
1786
+ —DONE:处理完成
1787
+ */
1788
+ StatusCode?: string;
1789
+ /**
1790
+ * 任务状态信息
1791
+ */
1792
+ StatusMsg?: string;
1793
+ /**
1794
+ * 任务执行错误码。当任务状态不为FAIL时,该值为""。
1795
+ */
1796
+ ErrorCode?: string;
1797
+ /**
1798
+ * 任务执行错误信息。当任务状态不为FAIL时,该值为""。
1799
+ */
1800
+ ErrorMessage?: string;
1801
+ /**
1802
+ * 生成视频的URL地址。有效期24小时。
1803
+ */
1804
+ ResultVideoUrl?: string;
1805
+ /**
1806
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1807
+ */
1808
+ RequestId?: string;
1809
+ }
1810
+ /**
1811
+ * DescribeHunyuanToVideoJob返回参数结构体
1812
+ */
1813
+ export interface DescribeHunyuanToVideoJobResponse {
1814
+ /**
1815
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1816
+ */
1817
+ Status?: string;
1818
+ /**
1819
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1820
+ */
1821
+ ErrorCode?: string;
1822
+ /**
1823
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1824
+ */
1825
+ ErrorMessage?: string;
1826
+ /**
1827
+ * 结果视频 URL。有效期 24 小时。
1828
+ */
1829
+ ResultVideoUrl?: string;
1830
+ /**
1831
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1832
+ */
1833
+ RequestId?: string;
1834
+ }
1835
+ /**
1836
+ * DescribeTextToVideoViduJob请求参数结构体
1837
+ */
1838
+ export interface DescribeTextToVideoViduJobRequest {
1839
+ /**
1840
+ * <p>任务ID</p>
1841
+ */
1842
+ JobId: string;
1843
+ }
1844
+ /**
1845
+ * 运动轨迹坐标序列
1846
+ */
1847
+ export interface Trajectory {
1848
+ /**
1849
+ * 轨迹点横坐标(在像素二维坐标系下,以输入图片image左下为原点的像素坐标)
1850
+ */
1851
+ X?: number;
1852
+ /**
1853
+ * 轨迹点纵坐标(在像素二维坐标系下,以输入图片image左下为原点的像素坐标)
1854
+ */
1855
+ Y?: number;
1856
+ }
1857
+ /**
1858
+ * DescribeTextToVideoViduJob返回参数结构体
1859
+ */
1860
+ export interface DescribeTextToVideoViduJobResponse {
1861
+ /**
1862
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1863
+ */
1864
+ Status?: string;
1865
+ /**
1866
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1867
+ */
1868
+ ErrorCode?: string;
1869
+ /**
1870
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1871
+ */
1872
+ ErrorMessage?: string;
1873
+ /**
1874
+ * <p>结果视频 URL。有效期 24 小时。</p>
1875
+ */
1876
+ ResultVideoUrl?: string;
1877
+ /**
1878
+ * <p>该任务消耗的积分数量。</p>
1879
+ */
1880
+ Credits?: number;
1881
+ /**
1882
+ * <p>任务调用时传入的透传参数。</p>
1883
+ */
1884
+ Payload?: string;
1885
+ /**
1886
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1887
+ */
1888
+ RequestId?: string;
1889
+ }
1890
+ /**
1891
+ * DescribeVideoVoiceJob请求参数结构体
1892
+ */
1893
+ export interface DescribeVideoVoiceJobRequest {
1894
+ /**
1895
+ * 任务ID。
1896
+ */
1897
+ JobId?: string;
1898
+ }
1899
+ /**
1900
+ * 控制摄像机运动的协议
1901
+ */
1902
+ export interface CameraControl {
1903
+ /**
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参数无需填写
1910
+ */
1911
+ Type?: string;
1912
+ /**
1913
+ * 包含六个字段,用于指定摄像机在不同方向上的运动或变化。
1914
+ - 当运镜类型指定simple时必填,指定其他类型时不填
1915
+ - 参数6选1,即只能有一个参数不为0,其余参数为0
1916
+ */
1917
+ Config?: CameraControlConfig;
1918
+ }
1919
+ /**
1920
+ * DescribeVideoFaceFusionJob返回参数结构体
1921
+ */
1922
+ export interface DescribeVideoFaceFusionJobResponse {
1923
+ /**
1924
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1925
+ */
1926
+ Status?: string;
1927
+ /**
1928
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
1929
+ */
1930
+ ErrorCode?: string;
1931
+ /**
1932
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1933
+ */
1934
+ ErrorMessage?: string;
1935
+ /**
1936
+ * 结果视频 URL。有效期 24 小时。
1937
+ */
1938
+ ResultVideoUrl?: string;
1939
+ /**
1940
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1941
+ */
1942
+ RequestId?: string;
1943
+ }
1944
+ /**
1945
+ * SubmitImageToVideoGeneralJob返回参数结构体
1946
+ */
1947
+ export interface SubmitImageToVideoGeneralJobResponse {
1948
+ /**
1949
+ * 任务ID
1950
+ */
1951
+ JobId?: string;
1952
+ /**
1953
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1954
+ */
1955
+ RequestId?: string;
1956
+ }
1957
+ /**
1958
+ * 人脸图片和待被融合的素材模板图的人脸位置信息。
1959
+ */
1960
+ export interface FaceMergeInfo {
1961
+ /**
1962
+ * 融合图片
1963
+ */
1964
+ MergeFaceImage?: Image;
1965
+ /**
1966
+ * 上传的图片人脸位置信息(人脸框)
1967
+ Width、Height >= 30。
1968
+ */
1969
+ MergeFaceRect?: FaceRect;
1970
+ /**
1971
+ * 素材人脸ID,不填默认取上传图片中最大人脸。
1972
+ */
1973
+ TemplateFaceID?: string;
1974
+ }
1975
+ /**
1976
+ * CheckAnimateImageJob请求参数结构体
1977
+ */
1978
+ export interface CheckAnimateImageJobRequest {
1979
+ /**
1980
+ * 动作模板ID。
1981
+ */
1982
+ TemplateId: string;
1983
+ /**
1984
+ * 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1985
+ 图片分辨率:长边分辨率范围【192,4096】;
1986
+ 图片大小:不超过10M;
1987
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1988
+ */
1989
+ ImageUrl?: string;
1990
+ /**
1991
+ * 图片base64数据。
1992
+ 图片格式:支持PNG、JPG、JPEG、BMP、WEBP格式;
1993
+ 图片分辨率:长边分辨率范围【192,4096】;
1994
+ 图片大小:不超过10M;
1995
+ 图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
1996
+ */
1997
+ ImageBase64?: string;
1998
+ /**
1999
+ * 是否对输入图采用加强检测方案。
2000
+
2001
+ 默认不加强检测(false),仅对输入图做必要的基础检测。
2002
+
2003
+ 开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
2004
+ */
2005
+ EnableBodyJoins?: boolean;
2006
+ /**
2007
+ * 是否开启人脸检测。
2008
+
2009
+ 默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
2010
+ */
2011
+ EnableFace?: boolean;
2012
+ }
2013
+ /**
2014
+ * DescribeVideoExtendKlingJob返回参数结构体
2015
+ */
2016
+ export interface DescribeVideoExtendKlingJobResponse {
2017
+ /**
2018
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
2019
+ */
2020
+ Status?: string;
2021
+ /**
2022
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
2023
+ */
2024
+ ErrorCode?: string;
2025
+ /**
2026
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
2027
+ */
2028
+ ErrorMessage?: string;
2029
+ /**
2030
+ * <p>结果视频 URL。有效期 24 小时。</p>
2031
+ */
2032
+ ResultVideoUrl?: string;
2033
+ /**
2034
+ * <p>视频时长。</p>
2035
+ */
2036
+ Duration?: string;
2037
+ /**
2038
+ * <p>消耗积分数。</p>
2039
+ */
2040
+ FinalUnitDeduction?: string;
2041
+ /**
2042
+ * <p>视频id</p>
2043
+ */
2044
+ VideoId?: string;
2045
+ /**
2046
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2047
+ */
2048
+ RequestId?: string;
2049
+ }
2050
+ /**
2051
+ * SubmitPortraitSingJob请求参数结构体
2052
+ */
2053
+ export interface SubmitPortraitSingJobRequest {
2054
+ /**
2055
+ * 传入音频URL地址,音频要求:
2056
+ - 音频时长:2秒 - 60秒
2057
+ - 音频格式:mp3、wav、m4a
2058
+ */
2059
+ AudioUrl: string;
2060
+ /**
2061
+ * 传入图片URL地址,图片要求:
2062
+ - 图片格式:jpg、jpeg、png、bmp、webp
2063
+ - 图片分辨率:192~4096
2064
+ - 图片大小:不超过10M
2065
+ - 图片宽高比:图片【宽:高】在1:2到2:1范围内
2066
+ - 图片内容:避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
2067
+ */
2068
+ ImageUrl?: string;
2069
+ /**
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。
2086
+ */
2087
+ Resolution?: string;
2088
+ /**
2089
+ * 为生成视频添加标识的开关,默认为1。
2090
+ 1:添加标识;
2091
+ 0:不添加标识;
2092
+ 其他数值:默认按1处理。
2093
+ 建议您使用显著标识来提示,该视频是 AI 生成的视频。
2094
+ */
2095
+ LogoAdd?: number;
2096
+ /**
2097
+ * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
2098
+ */
2099
+ LogoParam?: LogoParam;
2100
+ }
2101
+ /**
2102
+ * Element
2103
+ */
2104
+ export interface Element {
2105
+ /**
2106
+ * <p>ID配置</p>
2107
+ */
2108
+ ElementId?: string;
2109
+ }
2110
+ /**
2111
+ * 动态笔刷
2112
+ */
2113
+ export interface DynamicMask {
2114
+ /**
2115
+ * <p>动态笔刷涂抹区域(用户通过运动笔刷涂抹的 mask 图片)</p><p>支持传入图片Base64编码或图片URL(确保可访问,格式要求同 Image 字段)<br>图片格式支持.jpg / .jpeg / .png<br>图片长宽比必须与输入图片相同(即Image字段),否则任务失败<br>StaticMask 和 DynamicMasks.Mask 这两张图片的分辨率必须一致,否则任务失败</p>
2116
+ */
2117
+ Mask?: string;
2118
+ /**
2119
+ * <p>运动轨迹坐标序列</p><p>生成5s的视频,轨迹长度不超过77,即坐标个数取值范围:[2, 77]<br>轨迹坐标系,以图片左下角为坐标原点<br>注1:坐标点个数越多轨迹刻画越准确,如只有2个轨迹点则为这两点连接的直线<br>注2:轨迹方向以传入顺序为指向,以最先传入的坐标为轨迹起点,依次连接后续坐标形成运动轨迹</p>
2120
+ */
2121
+ Trajectories?: Array<Trajectory>;
2122
+ }
2123
+ /**
2124
+ * SubmitHunyuanToVideoJob返回参数结构体
2125
+ */
2126
+ export interface SubmitHunyuanToVideoJobResponse {
2127
+ /**
2128
+ * 任务ID
2129
+ */
2130
+ JobId?: string;
2131
+ /**
2132
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2133
+ */
2134
+ RequestId?: string;
2135
+ }
2136
+ /**
2137
+ * SubmitTextToVideoJob请求参数结构体
2138
+ */
2139
+ export interface SubmitTextToVideoJobRequest {
2140
+ /**
2141
+ * <p>正向文本提示词。不能超过2500个字符</p>
2142
+ */
2143
+ Prompt?: string;
2144
+ /**
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>
2146
+ */
2147
+ Model?: string;
2148
+ /**
2149
+ * <p>负向文本提示词。不能超过2500个字符</p>
2150
+ */
2151
+ NegativePrompt?: string;
2152
+ /**
2153
+ * <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>
2154
+ */
2155
+ Duration?: string;
2156
+ /**
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>
2158
+ */
2159
+ Mode?: string;
2160
+ /**
2161
+ * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>取值范围:[0, 1]<br>v2.0、v2.5、v2.6 模型不支持当前参数<br>默认值:0.5。</p>
2162
+ */
2163
+ CfgScale?: number;
2164
+ /**
2165
+ * <p>生成视频的画面纵横比(宽:高)<br>枚举值:16:9, 9:16, 1:1<br>默认值:16:9</p>
2166
+ */
2167
+ AspectRatio?: string;
2168
+ /**
2169
+ * <p>生成视频时是否同时生成声音</p><ul><li>枚举值:on,off</li></ul><p>仅V2.6及后续版本模型支持当前参数,v2.6模型的std模式只能生成无声的视频</p>
2170
+ */
2171
+ Sound?: string;
2172
+ /**
2173
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
2174
+ */
2175
+ LogoAdd?: number;
2176
+ /**
2177
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
2178
+ */
2179
+ LogoParam?: LogoParam;
2180
+ /**
2181
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,prompt参数无效</li><li>当前参数为false时,shot_type参数及multi_prompt参数无效</li></ul>
2182
+ */
2183
+ MultiShot?: boolean;
2184
+ /**
2185
+ * <p>分镜方式</p><p>枚举值:customize,intelligence<br>当MultiShot参数为true时,当前参数必填</p>
2186
+ */
2187
+ ShotType?: string;
2188
+ /**
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>
2190
+ */
2191
+ MultiPrompt?: Array<MultiPrompt>;
2192
+ /**
2193
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
2194
+ */
2195
+ CameraControl?: CameraControl;
2196
+ /**
2197
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
2198
+ */
2199
+ CallbackUrl?: string;
2200
+ }
2201
+ /**
2202
+ * DescribeVideoStylizationJob返回参数结构体
2203
+ */
2204
+ export interface DescribeVideoStylizationJobResponse {
2205
+ /**
2206
+ * 任务ID。
2207
+ */
2208
+ JobId?: string;
2209
+ /**
2210
+ * 任务状态码。取值说明:
2211
+ JobInit: "初始化中";
2212
+ JobModerationFailed: "审核失败";
2213
+ JobRunning: "处理中";
2214
+ JobFailed: "处理失败";
2215
+ JobSuccess: "处理完成"。
2216
+ */
2217
+ StatusCode?: string;
2218
+ /**
2219
+ * 任务状态描述。取值说明:
2220
+ JobInit: "初始化中";
2221
+ JobModerationFailed: "审核失败";
2222
+ JobRunning: "处理中";
2223
+ JobFailed: "处理失败";
2224
+ JobSuccess: "处理完成"。
2225
+ */
2226
+ StatusMsg?: string;
2227
+ /**
2228
+ * 处理结果视频Url。URL有效期为24小时。
2229
+ */
2230
+ ResultVideoUrl?: string;
2231
+ /**
2232
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2233
+ */
2234
+ RequestId?: string;
2235
+ }
2236
+ /**
2237
+ * SubmitHunyuanToVideoJob请求参数结构体
2238
+ */
2239
+ export interface SubmitHunyuanToVideoJobRequest {
2240
+ /**
2241
+ * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。 示例值:一只猫在草原上奔跑,写实风格
2242
+ */
2243
+ Prompt: string;
2244
+ /**
2245
+ * 输入图片
2246
+ 上传图url大小不超过 10M,base64不超过8M。
2247
+ 支持jpg,png,jpeg,webp,bmp,tiff 格式
2248
+ 单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1
2249
+ */
2250
+ Image?: Image;
2251
+ /**
2252
+ * 目前仅支持720p视频分辨率,默认720p。
2253
+ */
2254
+ Resolution?: string;
2255
+ /**
2256
+ * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。
2257
+ 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
2258
+ */
2259
+ LogoAdd?: number;
2260
+ /**
2261
+ * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
2262
+ */
2263
+ LogoParam?: LogoParam;
2264
+ }
2265
+ /**
2266
+ * DescribeVideoEditJob请求参数结构体
2267
+ */
2268
+ export interface DescribeVideoEditJobRequest {
2269
+ /**
2270
+ * 任务ID。
2271
+ */
2272
+ JobId: string;
2273
+ }
2274
+ /**
2275
+ * DescribeVideoEditKlingJob返回参数结构体
2276
+ */
2277
+ export interface DescribeVideoEditKlingJobResponse {
2278
+ /**
2279
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
2280
+ */
2281
+ Status?: string;
2282
+ /**
2283
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
2284
+ */
2285
+ ErrorCode?: string;
2286
+ /**
2287
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
2288
+ */
2289
+ ErrorMessage?: string;
2290
+ /**
2291
+ * <p>结果视频 URL。有效期 24 小时。</p>
2292
+ */
2293
+ ResultVideoUrl?: string;
2294
+ /**
2295
+ * <p>视频id</p>
2296
+ */
2297
+ VideoId?: string;
2298
+ /**
2299
+ * <p>时长</p>
2300
+ */
2301
+ Duration?: string;
2302
+ /**
2303
+ * <p>消耗积分数</p>
2304
+ */
2305
+ FinalUnitDeduction?: string;
2306
+ /**
2307
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2308
+ */
2309
+ RequestId?: string;
2310
+ }
2311
+ /**
2312
+ * 人脸框信息。
2313
+ */
2314
+ export interface FaceRect {
2315
+ /**
2316
+ * <p>人脸框左上角横坐标。</p>
2317
+ */
2318
+ X?: number;
2319
+ /**
2320
+ * <p>人脸框左上角纵坐标。</p>
2321
+ */
2322
+ Y?: number;
2323
+ /**
2324
+ * <p>人脸框宽度。<br>单位:px</p>
2325
+ */
2326
+ Width?: number;
2327
+ /**
2328
+ * <p>人脸框高度。<br>单位:px</p>
2329
+ */
2330
+ Height?: number;
2331
+ }
2332
+ /**
2333
+ * SubmitImageToVideoJob返回参数结构体
2334
+ */
2335
+ export interface SubmitImageToVideoJobResponse {
2336
+ /**
2337
+ * <p>任务ID。</p>
2338
+ */
2339
+ JobId?: string;
2340
+ /**
2341
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2342
+ */
2343
+ RequestId?: string;
1163
2344
  }