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.
- package/es/common/sdk_version.js +1 -1
- package/es/services/cfw/v20190904/cfw_client.js +5 -2
- package/es/services/emr/v20190103/emr_client.js +14 -8
- package/es/services/mps/v20190612/mps_client.js +18 -6
- package/es/services/organization/v20210331/organization_client.js +5 -2
- package/es/services/tcbr/v20220217/tcbr_client.js +8 -2
- package/es/services/tdmq/v20200217/tdmq_client.js +5 -2
- package/es/services/tdmysql/v20211122/tdmysql_client.js +5 -2
- package/es/services/vclm/v20240523/vclm_client.js +52 -4
- package/es/services/vpc/v20170312/vpc_client.js +3 -0
- package/package.json +1 -1
- package/tencentcloud/common/sdk_version.d.ts +1 -1
- package/tencentcloud/common/sdk_version.js +1 -1
- package/tencentcloud/services/ags/v20250920/ags_models.d.ts +12 -0
- package/tencentcloud/services/cdwdoris/v20211228/cdwdoris_models.d.ts +39 -4
- package/tencentcloud/services/cfw/v20190904/cfw_client.d.ts +7 -3
- package/tencentcloud/services/cfw/v20190904/cfw_client.js +9 -3
- package/tencentcloud/services/cfw/v20190904/cfw_models.d.ts +235 -5
- package/tencentcloud/services/cls/v20201016/cls_client.d.ts +1 -1
- package/tencentcloud/services/cls/v20201016/cls_client.js +1 -1
- package/tencentcloud/services/cls/v20201016/cls_models.d.ts +6 -6
- package/tencentcloud/services/config/v20220802/config_models.d.ts +20 -12
- package/tencentcloud/services/csip/v20221121/csip_models.d.ts +4 -0
- package/tencentcloud/services/dts/v20211206/dts_models.d.ts +30 -44
- package/tencentcloud/services/emr/v20190103/emr_client.d.ts +19 -11
- package/tencentcloud/services/emr/v20190103/emr_client.js +26 -14
- package/tencentcloud/services/emr/v20190103/emr_models.d.ts +145 -10
- package/tencentcloud/services/ess/v20201111/ess_client.d.ts +2 -2
- package/tencentcloud/services/ess/v20201111/ess_client.js +2 -2
- package/tencentcloud/services/ess/v20201111/ess_models.d.ts +84 -311
- package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +2 -2
- package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +2 -2
- package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +69 -236
- package/tencentcloud/services/hai/v20230812/hai_models.d.ts +6 -2
- package/tencentcloud/services/hcm/v20181106/hcm_models.d.ts +4 -4
- package/tencentcloud/services/iss/v20230517/iss_models.d.ts +53 -33
- package/tencentcloud/services/live/v20180801/live_models.d.ts +4 -0
- package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts +28 -60
- package/tencentcloud/services/mps/v20190612/mps_client.d.ts +24 -8
- package/tencentcloud/services/mps/v20190612/mps_client.js +34 -10
- package/tencentcloud/services/mps/v20190612/mps_models.d.ts +298 -476
- package/tencentcloud/services/mrs/v20200910/mrs_models.d.ts +53 -31
- package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +78 -65
- package/tencentcloud/services/organization/v20210331/organization_client.d.ts +7 -3
- package/tencentcloud/services/organization/v20210331/organization_client.js +9 -3
- package/tencentcloud/services/organization/v20210331/organization_models.d.ts +26 -0
- package/tencentcloud/services/redis/v20180412/redis_models.d.ts +1 -1
- package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts +46 -41
- package/tencentcloud/services/tcbr/v20220217/tcbr_client.d.ts +11 -3
- package/tencentcloud/services/tcbr/v20220217/tcbr_client.js +15 -3
- package/tencentcloud/services/tcbr/v20220217/tcbr_models.d.ts +83 -27
- package/tencentcloud/services/tdmq/v20200217/tdmq_client.d.ts +7 -3
- package/tencentcloud/services/tdmq/v20200217/tdmq_client.js +9 -3
- package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +106 -25
- package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.d.ts +7 -3
- package/tencentcloud/services/tdmysql/v20211122/tdmysql_client.js +9 -3
- package/tencentcloud/services/tdmysql/v20211122/tdmysql_models.d.ts +142 -28
- package/tencentcloud/services/teo/v20220901/teo_models.d.ts +2 -56
- package/tencentcloud/services/tke/v20180525/tke_client.d.ts +10 -10
- package/tencentcloud/services/tke/v20180525/tke_client.js +10 -10
- package/tencentcloud/services/tke/v20180525/tke_models.d.ts +182 -136
- package/tencentcloud/services/tke/v20220501/tke_models.d.ts +26 -0
- package/tencentcloud/services/vclm/v20240523/vclm_client.d.ts +69 -5
- package/tencentcloud/services/vclm/v20240523/vclm_client.js +102 -6
- package/tencentcloud/services/vclm/v20240523/vclm_models.d.ts +1673 -492
- package/tencentcloud/services/vod/v20180717/vod_models.d.ts +8 -0
- package/tencentcloud/services/vpc/v20170312/vpc_client.d.ts +5 -1
- package/tencentcloud/services/vpc/v20170312/vpc_client.js +6 -0
- 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
|
-
*
|
|
57
|
+
* SubmitImageToVideoJob请求参数结构体
|
|
58
58
|
*/
|
|
59
|
-
export interface
|
|
59
|
+
export interface SubmitImageToVideoJobRequest {
|
|
60
60
|
/**
|
|
61
|
-
*
|
|
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
|
-
|
|
63
|
+
Model?: string;
|
|
64
64
|
/**
|
|
65
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
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>"MultiPrompt":[<br> {<br> "Index":int,<br> "Prompt": "string",<br> "Duration": "5"<br> },<br> {<br> "Index":int,<br> "Prompt": "string",<br> "Duration": "5"<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> "ElementList":[ { "ElementId":long }, { "ElementId":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>"VoiceList":[<br> {"VoiceId":"VoiceId_1"},<br> {"VoiceId":"VoiceId_2"}<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
|
-
*
|
|
222
|
+
* DescribeImageToVideoViduJob返回参数结构体
|
|
155
223
|
*/
|
|
156
|
-
export interface
|
|
224
|
+
export interface DescribeImageToVideoViduJobResponse {
|
|
157
225
|
/**
|
|
158
|
-
*
|
|
226
|
+
* <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
|
|
159
227
|
*/
|
|
160
|
-
|
|
228
|
+
Status?: string;
|
|
229
|
+
/**
|
|
230
|
+
* <p>任务执行错误码。当任务状态不为 FAIL 时,该值为""。</p>
|
|
231
|
+
*/
|
|
232
|
+
ErrorCode?: string;
|
|
233
|
+
/**
|
|
234
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</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
|
|
257
|
+
export interface SubmitTextToVideoViduJobRequest {
|
|
170
258
|
/**
|
|
171
|
-
*
|
|
259
|
+
* <p>文本提示词<br>生成视频的文本描述。<br>注:字符长度不能超过 2000 个字符</p>
|
|
172
260
|
*/
|
|
173
|
-
|
|
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
|
-
|
|
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
|
-
|
|
182
|
-
}
|
|
183
|
-
/**
|
|
184
|
-
* DescribeAigcVideoJob请求参数结构体
|
|
185
|
-
*/
|
|
186
|
-
export interface DescribeAigcVideoJobRequest {
|
|
269
|
+
Duration?: number;
|
|
187
270
|
/**
|
|
188
|
-
*
|
|
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
|
-
|
|
193
|
-
}
|
|
194
|
-
/**
|
|
195
|
-
* SubmitImageAnimateJob请求参数结构体
|
|
196
|
-
*/
|
|
197
|
-
export interface SubmitImageAnimateJobRequest {
|
|
273
|
+
Bgm?: boolean;
|
|
198
274
|
/**
|
|
199
|
-
*
|
|
200
|
-
图片分辨率:长边分辨率范围【192,4096】;
|
|
201
|
-
图片大小:不超过10M;
|
|
202
|
-
图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
|
|
275
|
+
* <p>比例<br>默认 16:9,可选值如下:16:9、9:16、4:3、3:4、1:1</p>
|
|
203
276
|
*/
|
|
204
|
-
|
|
277
|
+
AspectRatio?: string;
|
|
205
278
|
/**
|
|
206
|
-
*
|
|
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
|
-
|
|
281
|
+
Resolution?: string;
|
|
213
282
|
/**
|
|
214
|
-
*
|
|
215
|
-
|
|
283
|
+
* <p>风格<br>默认 general,可选值:general、anime<br>general:通用风格,可以通过提示词来控制风格<br>anime:动漫风格,仅在动漫风格表现突出,可以通过不同的动漫风格提示词来控制<br>注:使用q2、q3系列模型时该参数不生效</p>
|
|
216
284
|
*/
|
|
217
|
-
|
|
285
|
+
Style?: string;
|
|
218
286
|
/**
|
|
219
|
-
*
|
|
287
|
+
* <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:使用q2、q3系列模型时该参数不生效</p>
|
|
220
288
|
*/
|
|
221
|
-
|
|
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
|
-
|
|
293
|
+
Audio?: boolean;
|
|
230
294
|
/**
|
|
231
|
-
*
|
|
232
|
-
true:分割结果视频,结果视频(ResultVideoUrl)将为去除背景的绿幕视频,并返回掩码视频(MaskVideoUrl);
|
|
233
|
-
false:不分割结果视频,结果视频(ResultVideoUrl)为带背景的视频,掩码视频(MaskVideoUrl)为空字符串。
|
|
295
|
+
* <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>"Label": "your_label",<br>"ContentProducer": "your_content_producer",<br>"ContentPropagator": "your_content_propagator",<br>"ProduceID": "your_product_id",<br>"PropagateID": "your_propagate_id",<br>"ReservedCode1": "your_reserved_code1",<br>"ReservedCode2": "your_reserved_code2"<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
|
|
234
296
|
*/
|
|
235
|
-
|
|
297
|
+
MetaData?: string;
|
|
236
298
|
/**
|
|
237
|
-
*
|
|
238
|
-
1:添加标识。
|
|
239
|
-
0:不添加标识。
|
|
240
|
-
其他数值:默认按1处理。
|
|
241
|
-
建议您使用显著标识来提示,该视频是 AI 生成的视频。
|
|
299
|
+
* <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的"status"包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
|
|
242
300
|
*/
|
|
243
|
-
|
|
301
|
+
CallbackUrl?: string;
|
|
244
302
|
/**
|
|
245
|
-
*
|
|
246
|
-
默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
|
|
303
|
+
* <p>透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符</p>
|
|
247
304
|
*/
|
|
248
|
-
|
|
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
|
-
|
|
255
|
-
}
|
|
256
|
-
/**
|
|
257
|
-
* DescribeVideoVoiceJob请求参数结构体
|
|
258
|
-
*/
|
|
259
|
-
export interface DescribeVideoVoiceJobRequest {
|
|
309
|
+
OffPeak?: boolean;
|
|
260
310
|
/**
|
|
261
|
-
*
|
|
311
|
+
* <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
|
|
262
312
|
*/
|
|
263
|
-
|
|
313
|
+
LogoAdd?: number;
|
|
314
|
+
/**
|
|
315
|
+
* <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
|
|
316
|
+
*/
|
|
317
|
+
LogoParam?: LogoParam;
|
|
264
318
|
}
|
|
265
319
|
/**
|
|
266
|
-
*
|
|
320
|
+
* SubmitVideoEditJob请求参数结构体
|
|
267
321
|
*/
|
|
268
|
-
export interface
|
|
322
|
+
export interface SubmitVideoEditJobRequest {
|
|
269
323
|
/**
|
|
270
|
-
*
|
|
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
|
-
|
|
326
|
+
VideoUrl: string;
|
|
273
327
|
/**
|
|
274
|
-
*
|
|
328
|
+
* <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
|
|
275
329
|
*/
|
|
276
|
-
|
|
277
|
-
}
|
|
278
|
-
/**
|
|
279
|
-
* DescribeVideoFaceFusionJob返回参数结构体
|
|
280
|
-
*/
|
|
281
|
-
export interface DescribeVideoFaceFusionJobResponse {
|
|
330
|
+
Prompt?: string;
|
|
282
331
|
/**
|
|
283
|
-
*
|
|
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>示例值:[{ "Url": "https://console.cloud.tencent.com/cos/image.png"}]</li></ul>
|
|
284
333
|
*/
|
|
285
|
-
|
|
334
|
+
Images?: Array<Image>;
|
|
286
335
|
/**
|
|
287
|
-
*
|
|
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
|
-
|
|
339
|
+
Image?: Image;
|
|
290
340
|
/**
|
|
291
|
-
*
|
|
341
|
+
* <p>扩展字段。</p>
|
|
292
342
|
*/
|
|
293
|
-
|
|
343
|
+
VideoEditParam?: VideoEditParam;
|
|
294
344
|
/**
|
|
295
|
-
*
|
|
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
|
-
|
|
347
|
+
LogoAdd?: number;
|
|
298
348
|
/**
|
|
299
|
-
*
|
|
349
|
+
* <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
|
|
300
350
|
*/
|
|
301
|
-
|
|
351
|
+
LogoParam?: LogoParam;
|
|
302
352
|
}
|
|
303
353
|
/**
|
|
304
|
-
*
|
|
354
|
+
* DescribeVideoExtendKlingJob请求参数结构体
|
|
305
355
|
*/
|
|
306
|
-
export interface
|
|
356
|
+
export interface DescribeVideoExtendKlingJobRequest {
|
|
307
357
|
/**
|
|
308
|
-
*
|
|
358
|
+
* <p>任务ID。</p>
|
|
309
359
|
*/
|
|
310
360
|
JobId?: string;
|
|
311
361
|
}
|
|
312
362
|
/**
|
|
313
|
-
*
|
|
363
|
+
* SubmitVideoEditKlingJob请求参数结构体
|
|
314
364
|
*/
|
|
315
|
-
export interface
|
|
365
|
+
export interface SubmitVideoEditKlingJobRequest {
|
|
316
366
|
/**
|
|
317
|
-
* <p
|
|
367
|
+
* <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
|
|
318
368
|
*/
|
|
319
|
-
|
|
369
|
+
Prompt?: string;
|
|
320
370
|
/**
|
|
321
|
-
* <p
|
|
371
|
+
* <p>模型名称,支持kling-video-o1,kling-v3-omni。默认kling-video-o1。</p>
|
|
322
372
|
*/
|
|
323
|
-
|
|
373
|
+
Model?: string;
|
|
324
374
|
/**
|
|
325
|
-
* <p
|
|
375
|
+
* <p>参考图列表</p><p>包括主体、场景、风格等参考图片,也可作为首帧或尾帧生成视频;当作为首帧或尾帧生成视频时:</p><p>通过type参数来定义图片是否为首尾帧:first_frame为首帧,end_frame为尾帧</p><p>暂时不支持仅尾帧,即有尾帧图时必须有首帧图</p><p>首帧或首尾帧生视频时,不能使用视频编辑功能</p><p>用key:value承载,如下:</p><p>"ImageInfo":[<br> {<br> "ImageUrl":"https://cos.ap-guangzhou.myqcloud.com/test.png",<br> "Type":"first_frame"<br> },<br> {<br> "ImageUrl":"https://cos.ap-guangzhou.myqcloud.com/test.png",<br> "Type":"end_frame"<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
|
-
|
|
377
|
+
ImageList?: Array<ImageInfo>;
|
|
328
378
|
/**
|
|
329
|
-
* <p
|
|
379
|
+
* <p>生成视频的画面纵横比(宽:高)</p><p>枚举值:16:9, 9:16, 1:1</p><p>未使用首帧参考或视频编辑功能时,当前参数必填</p>
|
|
330
380
|
*/
|
|
331
|
-
|
|
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承载,如下: "element_list":[ { "element_id":long }, { "element_id":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
|
-
*
|
|
428
|
+
* 生成视频时所引用的音色
|
|
335
429
|
*/
|
|
336
|
-
export interface
|
|
430
|
+
export interface Voice {
|
|
337
431
|
/**
|
|
338
|
-
*
|
|
432
|
+
* <p>音色id</p>
|
|
339
433
|
*/
|
|
340
|
-
|
|
434
|
+
VoiceId?: string;
|
|
341
435
|
}
|
|
342
436
|
/**
|
|
343
|
-
*
|
|
437
|
+
* SubmitImageAnimateJob返回参数结构体
|
|
344
438
|
*/
|
|
345
|
-
export interface
|
|
439
|
+
export interface SubmitImageAnimateJobResponse {
|
|
346
440
|
/**
|
|
347
|
-
*
|
|
441
|
+
* 图片跳舞任务ID。
|
|
348
442
|
*/
|
|
349
|
-
JobId
|
|
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
|
-
*
|
|
488
|
+
* DescribeReferenceToVideoViduJob返回参数结构体
|
|
391
489
|
*/
|
|
392
|
-
export interface
|
|
490
|
+
export interface DescribeReferenceToVideoViduJobResponse {
|
|
393
491
|
/**
|
|
394
|
-
*
|
|
492
|
+
* <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
|
|
395
493
|
*/
|
|
396
|
-
|
|
494
|
+
Status?: string;
|
|
397
495
|
/**
|
|
398
|
-
*
|
|
496
|
+
* <p>任务执行错误码。当任务状态不为 FAIL 时,该值为""。</p>
|
|
399
497
|
*/
|
|
400
|
-
|
|
401
|
-
}
|
|
402
|
-
/**
|
|
403
|
-
* 人脸图片和待被融合的素材模板图的人脸位置信息。
|
|
404
|
-
*/
|
|
405
|
-
export interface FaceMergeInfo {
|
|
498
|
+
ErrorCode?: string;
|
|
406
499
|
/**
|
|
407
|
-
*
|
|
500
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</p>
|
|
408
501
|
*/
|
|
409
|
-
|
|
502
|
+
ErrorMessage?: string;
|
|
410
503
|
/**
|
|
411
|
-
*
|
|
412
|
-
Width、Height >= 30。
|
|
504
|
+
* <p>结果视频 URL。有效期 24 小时。</p>
|
|
413
505
|
*/
|
|
414
|
-
|
|
506
|
+
ResultVideoUrl?: string;
|
|
415
507
|
/**
|
|
416
|
-
*
|
|
508
|
+
* <p>该任务消耗的积分数量。</p>
|
|
417
509
|
*/
|
|
418
|
-
|
|
419
|
-
}
|
|
420
|
-
/**
|
|
421
|
-
* CheckAnimateImageJob返回参数结构体
|
|
422
|
-
*/
|
|
423
|
-
export interface CheckAnimateImageJobResponse {
|
|
510
|
+
Credits?: number;
|
|
424
511
|
/**
|
|
425
|
-
*
|
|
512
|
+
* <p>任务调用时传入的透传参数。</p>
|
|
426
513
|
*/
|
|
427
|
-
|
|
514
|
+
Payload?: string;
|
|
428
515
|
/**
|
|
429
516
|
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
430
517
|
*/
|
|
431
518
|
RequestId?: string;
|
|
432
519
|
}
|
|
433
520
|
/**
|
|
434
|
-
*
|
|
521
|
+
* SubmitMotionControlKlingJob请求参数结构体
|
|
435
522
|
*/
|
|
436
|
-
export interface
|
|
523
|
+
export interface SubmitMotionControlKlingJobRequest {
|
|
437
524
|
/**
|
|
438
|
-
* <p
|
|
525
|
+
* <p>模型名称 枚举值:kling-v2-6, kling-v3。</p>
|
|
439
526
|
*/
|
|
440
|
-
|
|
527
|
+
Model?: string;
|
|
441
528
|
/**
|
|
442
|
-
*
|
|
529
|
+
* <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
|
|
443
530
|
*/
|
|
444
|
-
|
|
445
|
-
}
|
|
446
|
-
/**
|
|
447
|
-
* SubmitTemplateToVideoJob返回参数结构体
|
|
448
|
-
*/
|
|
449
|
-
export interface SubmitTemplateToVideoJobResponse {
|
|
531
|
+
Prompt?: string;
|
|
450
532
|
/**
|
|
451
|
-
* <p
|
|
533
|
+
* <p>参考图像,生成视频中的人物、背景等元素均以参考图为准 视频内容需满足以下要求: 人物比例尽量与参考动作比例一致,尽量避免全身动作驱动半身人物进行生成 人物需要露出清晰的上半身或全身的肢体及头部,避免遮挡 画面中人物避免存在极端朝向,比如倒立、平卧等。人物占画面比例不得太低 支持真实/风格化的角色(包括人物/类人动物/部分纯动物/部分类人肢体比例的角色)通过 包含支持传入图片Base64编码或图片URL(确保可访问)。</p>
|
|
452
534
|
*/
|
|
453
|
-
|
|
535
|
+
Image?: string;
|
|
454
536
|
/**
|
|
455
|
-
*
|
|
537
|
+
* <p>参考视频的获取链接。生成视频中的人物动作与参考视频一致。 视频内容需满足以下要求: 人物需要漏出清晰的上半身或全身的全部肢体及头部,避免遮挡 建议上传1人动作视频,2人及以上会取画面占比最大的人物动作进行生成 推荐使用真人动作,部分风格化的人物/类人肢体比例可以通过 动作视频一镜到底,角色始终出现在画面中,避免切镜、运镜等。否则会被截取 动作避免过快,相对平稳的动作生成效果更佳 视频文件支持.mp4/.mov,文件大小不超过100MB,仅支持长宽的边长均位于340px~3850px之间,上述校验不通过会返回错误码等信息 视频时长下限不短于3秒,时长上限与人物朝向参考(character_orientation)有关: 当人物朝向与视频中人物一致时,视频时长最长可达30秒; 当人物朝向与图片中人物一致时,视频时长最长可达10秒; 如果您的动作难度比较高、速度比较快,有一定概率生成不足上传视频时长的结果,因为模型只能提取有效动作时长进行生成,最短提取出3s可用连续动作即可生成。请注意,因此消耗的积分将无法退还,建议适当调整动作难度与速度 系统会校验视频内容,如有问题会返回错误码等信息。</p>
|
|
456
538
|
*/
|
|
457
|
-
|
|
458
|
-
}
|
|
459
|
-
/**
|
|
460
|
-
* CheckAnimateImageJob请求参数结构体
|
|
461
|
-
*/
|
|
462
|
-
export interface CheckAnimateImageJobRequest {
|
|
539
|
+
Video?: string;
|
|
463
540
|
/**
|
|
464
|
-
*
|
|
541
|
+
* <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
|
|
465
542
|
*/
|
|
466
|
-
|
|
543
|
+
Mode?: string;
|
|
467
544
|
/**
|
|
468
|
-
*
|
|
469
|
-
图片分辨率:长边分辨率范围【192,4096】;
|
|
470
|
-
图片大小:不超过10M;
|
|
471
|
-
图片宽高比:【宽:高】数值在 1:2 到 1:1.2 范围内
|
|
545
|
+
* <p>可选择是否保留视频原声 枚举值:yes,no 其中yes:保留视频原声 其中no:不保留视频原声。</p>
|
|
472
546
|
*/
|
|
473
|
-
|
|
547
|
+
KeepOriginalSound?: string;
|
|
474
548
|
/**
|
|
475
|
-
*
|
|
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
|
-
|
|
551
|
+
CharacterOrientation?: string;
|
|
482
552
|
/**
|
|
483
|
-
*
|
|
484
|
-
|
|
485
|
-
默认不加强检测(false),仅对输入图做必要的基础检测。
|
|
486
|
-
|
|
487
|
-
开启加强检测(true)有助于提升效果稳定性,将根据选择的动作模板提取建议的人体关键点,并判断输入图中是否包含这些人体关键点。加强检测仅对人像输入图生效,对非人输入图不生效。
|
|
553
|
+
* <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: "element_list":[ { "element_id":long }, { "element_id":long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
|
|
488
554
|
*/
|
|
489
|
-
|
|
555
|
+
ElementList?: Array<Element>;
|
|
490
556
|
/**
|
|
491
|
-
*
|
|
492
|
-
|
|
493
|
-
默认开启人脸检测(true),拦截主体为人像但无人脸、人脸不完整或被遮挡的输入图。可选关闭人脸检测(false)。
|
|
557
|
+
* <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
|
|
494
558
|
*/
|
|
495
|
-
|
|
496
|
-
}
|
|
497
|
-
/**
|
|
498
|
-
* DescribeVideoStylizationJob请求参数结构体
|
|
499
|
-
*/
|
|
500
|
-
export interface DescribeVideoStylizationJobRequest {
|
|
559
|
+
CallbackUrl?: string;
|
|
501
560
|
/**
|
|
502
|
-
*
|
|
561
|
+
* <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
|
|
503
562
|
*/
|
|
504
|
-
|
|
563
|
+
LogoAdd?: number;
|
|
564
|
+
/**
|
|
565
|
+
* <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
|
|
566
|
+
*/
|
|
567
|
+
LogoParam?: LogoParam;
|
|
505
568
|
}
|
|
506
569
|
/**
|
|
507
|
-
*
|
|
570
|
+
* SubmitVideoExtendKlingJob请求参数结构体
|
|
508
571
|
*/
|
|
509
|
-
export interface
|
|
572
|
+
export interface SubmitVideoExtendKlingJobRequest {
|
|
510
573
|
/**
|
|
511
|
-
*
|
|
574
|
+
* <p>视频ID 支持通过文本、图片和视频延长生成的视频的ID(原视频不能超过3分钟) 请注意,基于目前的清理策略、视频生成30天之后会被清理,则无法进行延长</p>
|
|
512
575
|
*/
|
|
513
|
-
|
|
576
|
+
VideoId: string;
|
|
514
577
|
/**
|
|
515
|
-
*
|
|
578
|
+
* <p>正向文本提示词 不能超过2500个字符</p>
|
|
516
579
|
*/
|
|
517
|
-
|
|
518
|
-
}
|
|
519
|
-
/**
|
|
520
|
-
* DescribeImageAnimateJob返回参数结构体
|
|
521
|
-
*/
|
|
522
|
-
export interface DescribeImageAnimateJobResponse {
|
|
580
|
+
Prompt?: string;
|
|
523
581
|
/**
|
|
524
|
-
*
|
|
582
|
+
* <p>负向文本提示词 不能超过2500个字符</p>
|
|
525
583
|
*/
|
|
526
|
-
|
|
584
|
+
NegativePrompt?: string;
|
|
527
585
|
/**
|
|
528
|
-
*
|
|
586
|
+
* <p>提示词参考强度 取值范围:[0,1],数值越大参考强度越大</p>
|
|
529
587
|
*/
|
|
530
|
-
|
|
588
|
+
CfgScale?: number;
|
|
531
589
|
/**
|
|
532
|
-
*
|
|
590
|
+
* <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
|
|
533
591
|
*/
|
|
534
|
-
|
|
592
|
+
CallbackUrl?: string;
|
|
535
593
|
/**
|
|
536
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
616
|
+
* SubmitTemplateToVideoJob请求参数结构体
|
|
550
617
|
*/
|
|
551
|
-
export interface
|
|
618
|
+
export interface SubmitTemplateToVideoJobRequest {
|
|
552
619
|
/**
|
|
553
|
-
*
|
|
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
|
-
|
|
622
|
+
Template: string;
|
|
558
623
|
/**
|
|
559
|
-
*
|
|
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
|
-
|
|
626
|
+
Images: Array<Image>;
|
|
567
627
|
/**
|
|
568
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
634
|
+
LogoParam?: LogoParam;
|
|
578
635
|
/**
|
|
579
|
-
*
|
|
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
|
-
*
|
|
588
|
-
1:添加标识;
|
|
589
|
-
0:不添加标识;
|
|
590
|
-
其他数值:默认按1处理。
|
|
591
|
-
建议您使用显著标识来提示,该视频是 AI 生成的视频。
|
|
640
|
+
* <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
|
|
592
641
|
*/
|
|
593
|
-
|
|
642
|
+
BGM?: boolean;
|
|
594
643
|
/**
|
|
595
|
-
*
|
|
644
|
+
* <p>扩展字段。</p>
|
|
596
645
|
*/
|
|
597
|
-
|
|
646
|
+
ExtraParam?: ExtraParam;
|
|
598
647
|
}
|
|
599
648
|
/**
|
|
600
649
|
* 水印图输入框
|
|
601
650
|
*/
|
|
602
651
|
export interface LogoRect {
|
|
603
652
|
/**
|
|
604
|
-
*
|
|
653
|
+
* <p>水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。</p>
|
|
605
654
|
*/
|
|
606
655
|
X?: number;
|
|
607
656
|
/**
|
|
608
|
-
*
|
|
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
|
-
*
|
|
670
|
+
* DescribeVideoEditKlingJob请求参数结构体
|
|
622
671
|
*/
|
|
623
|
-
export interface
|
|
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
|
-
*
|
|
674
|
+
* <p>任务ID</p>
|
|
647
675
|
*/
|
|
648
|
-
|
|
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
|
-
*
|
|
704
|
+
* DescribeTextToVideoJob返回参数结构体
|
|
677
705
|
*/
|
|
678
|
-
export interface
|
|
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
|
|
708
|
+
* <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
|
|
701
709
|
*/
|
|
702
|
-
|
|
703
|
-
}
|
|
704
|
-
/**
|
|
705
|
-
* SubmitHunyuanToVideoJob返回参数结构体
|
|
706
|
-
*/
|
|
707
|
-
export interface SubmitHunyuanToVideoJobResponse {
|
|
710
|
+
Status?: string;
|
|
708
711
|
/**
|
|
709
|
-
*
|
|
712
|
+
* <p>任务执行错误码。当任务状态不为 FAIL 时,该值为""。</p>
|
|
710
713
|
*/
|
|
711
|
-
|
|
714
|
+
ErrorCode?: string;
|
|
712
715
|
/**
|
|
713
|
-
*
|
|
716
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</p>
|
|
714
717
|
*/
|
|
715
|
-
|
|
716
|
-
}
|
|
717
|
-
/**
|
|
718
|
-
* DescribeHumanActorJob返回参数结构体
|
|
719
|
-
*/
|
|
720
|
-
export interface DescribeHumanActorJobResponse {
|
|
718
|
+
ErrorMessage?: string;
|
|
721
719
|
/**
|
|
722
|
-
*
|
|
720
|
+
* <p>结果视频 URL。有效期 24 小时。</p>
|
|
723
721
|
*/
|
|
724
|
-
|
|
722
|
+
ResultVideoUrl?: string;
|
|
725
723
|
/**
|
|
726
|
-
*
|
|
724
|
+
* <p>视频id</p>
|
|
727
725
|
*/
|
|
728
|
-
|
|
726
|
+
VideoId?: string;
|
|
729
727
|
/**
|
|
730
|
-
*
|
|
728
|
+
* <p>视频总时长,单位s</p>
|
|
731
729
|
*/
|
|
732
|
-
|
|
730
|
+
Duration?: string;
|
|
733
731
|
/**
|
|
734
|
-
*
|
|
732
|
+
* <p>任务最终扣减积分数值</p>
|
|
735
733
|
*/
|
|
736
|
-
|
|
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
|
-
*
|
|
783
|
+
* SubmitVideoStylizationJob返回参数结构体
|
|
786
784
|
*/
|
|
787
|
-
export interface
|
|
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
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
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
|
-
*
|
|
843
|
+
* SubmitReferenceToVideoViduJob请求参数结构体
|
|
881
844
|
*/
|
|
882
|
-
export interface
|
|
845
|
+
export interface SubmitReferenceToVideoViduJobRequest {
|
|
883
846
|
/**
|
|
884
|
-
*
|
|
847
|
+
* <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:使用Subjects主体参数时,可以通过@主体id 来表示主体内容,例如:"@1 和 @2 在一起吃火锅,并且旁白音说火锅大家都爱吃。"</p>
|
|
885
848
|
*/
|
|
886
|
-
|
|
849
|
+
Prompt: string;
|
|
887
850
|
/**
|
|
888
|
-
*
|
|
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
|
-
|
|
891
|
-
}
|
|
892
|
-
/**
|
|
893
|
-
* SubmitTemplateToVideoJob请求参数结构体
|
|
894
|
-
*/
|
|
895
|
-
export interface SubmitTemplateToVideoJobRequest {
|
|
853
|
+
Images?: Array<string>;
|
|
896
854
|
/**
|
|
897
|
-
* <p
|
|
855
|
+
* <p>参考生图主体信息,支持1-7个主体,主体图片共1 ~ 7张<br>【主体调用时传入】</p>
|
|
898
856
|
*/
|
|
899
|
-
|
|
857
|
+
Subjects?: Array<ReferenceSubject>;
|
|
900
858
|
/**
|
|
901
|
-
* <p
|
|
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>
|
|
902
860
|
*/
|
|
903
|
-
|
|
861
|
+
Videos?: Array<string>;
|
|
904
862
|
/**
|
|
905
|
-
* <p
|
|
863
|
+
* <p>模型名称,可选值,当前仅可并且默认viduq2</p><ul><li>viduq2:最新模型</li></ul>
|
|
906
864
|
*/
|
|
907
|
-
|
|
865
|
+
Model?: string;
|
|
908
866
|
/**
|
|
909
|
-
* <p
|
|
867
|
+
* <p>是否使用音视频直出能力,默认false,可选值 true、false</p><ul><li>true:使用音视频直出能力。</li><li>false:不使用音视频直出能力。<br>仅上传主体时支持此功能</li></ul>
|
|
910
868
|
*/
|
|
911
|
-
|
|
869
|
+
Audio?: boolean;
|
|
912
870
|
/**
|
|
913
|
-
* <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
|
|
891
|
+
* <p>运动幅度默认 auto,可选值:auto、small、medium、large<br>注:使用q2系列模型时该参数不生效</p>
|
|
918
892
|
*/
|
|
919
|
-
|
|
893
|
+
MovementAmplitude?: string;
|
|
920
894
|
/**
|
|
921
|
-
* <p
|
|
895
|
+
* <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
|
|
922
896
|
*/
|
|
923
|
-
|
|
897
|
+
MetaData?: string;
|
|
898
|
+
/**
|
|
899
|
+
* <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的"status"包括以下状态:</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
|
-
*
|
|
953
|
+
* SubmitImageToVideoViduJob请求参数结构体
|
|
960
954
|
*/
|
|
961
|
-
export interface
|
|
955
|
+
export interface SubmitImageToVideoViduJobRequest {
|
|
962
956
|
/**
|
|
963
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
963
|
+
Model?: string;
|
|
973
964
|
/**
|
|
974
|
-
*
|
|
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
|
-
*
|
|
979
|
-
1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
|
|
989
|
+
* <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:q2、q3系列模型改参数不生效</p>
|
|
980
990
|
*/
|
|
981
|
-
|
|
991
|
+
MovementAmplitude?: string;
|
|
982
992
|
/**
|
|
983
|
-
*
|
|
993
|
+
* <p>bgm</p>
|
|
984
994
|
*/
|
|
985
|
-
|
|
986
|
-
}
|
|
987
|
-
/**
|
|
988
|
-
* 图片
|
|
989
|
-
*/
|
|
990
|
-
export interface Image {
|
|
995
|
+
Bgm?: boolean;
|
|
991
996
|
/**
|
|
992
|
-
*
|
|
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
|
-
|
|
999
|
+
AudioType?: string;
|
|
995
1000
|
/**
|
|
996
|
-
*
|
|
1001
|
+
* <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>"Label": "your_label",<br>"ContentProducer": "your_content_producer",<br>"ContentPropagator": "your_content_propagator",<br>"ProduceID": "your_product_id",<br>"PropagateID": "your_propagate_id",<br>"ReservedCode1": "your_reserved_code1",<br>"ReservedCode2": "your_reserved_code2"<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
|
|
997
1002
|
*/
|
|
998
|
-
|
|
999
|
-
}
|
|
1000
|
-
/**
|
|
1001
|
-
* DescribeVideoEditJob请求参数结构体
|
|
1002
|
-
*/
|
|
1003
|
-
export interface DescribeVideoEditJobRequest {
|
|
1003
|
+
MetaData?: string;
|
|
1004
1004
|
/**
|
|
1005
|
-
*
|
|
1005
|
+
* <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的"status"包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
|
|
1006
1006
|
*/
|
|
1007
|
-
|
|
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
|
-
*
|
|
1057
|
+
* SubmitVideoVoiceJob返回参数结构体
|
|
1042
1058
|
*/
|
|
1043
|
-
export interface
|
|
1059
|
+
export interface SubmitVideoVoiceJobResponse {
|
|
1044
1060
|
/**
|
|
1045
1061
|
* 任务ID。
|
|
1046
1062
|
*/
|
|
1047
|
-
JobId
|
|
1063
|
+
JobId?: string;
|
|
1064
|
+
/**
|
|
1065
|
+
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
1066
|
+
*/
|
|
1067
|
+
RequestId?: string;
|
|
1048
1068
|
}
|
|
1049
1069
|
/**
|
|
1050
|
-
*
|
|
1070
|
+
* SubmitImageToVideoViduJob返回参数结构体
|
|
1051
1071
|
*/
|
|
1052
|
-
export interface
|
|
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>示例值:[{ "Url": "https://console.cloud.tencent.com/cos/image.png"}]</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
|
|
1074
|
+
* <p>任务ID。</p>
|
|
1076
1075
|
*/
|
|
1077
|
-
|
|
1076
|
+
JobId?: string;
|
|
1078
1077
|
/**
|
|
1079
|
-
*
|
|
1078
|
+
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
1080
1079
|
*/
|
|
1081
|
-
|
|
1080
|
+
RequestId?: string;
|
|
1082
1081
|
}
|
|
1083
1082
|
/**
|
|
1084
|
-
*
|
|
1083
|
+
* SubmitPortraitSingJob返回参数结构体
|
|
1085
1084
|
*/
|
|
1086
|
-
export interface
|
|
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
|
-
*
|
|
1096
|
+
* DescribeImageToVideoJob返回参数结构体
|
|
1094
1097
|
*/
|
|
1095
|
-
export interface
|
|
1098
|
+
export interface DescribeImageToVideoJobResponse {
|
|
1096
1099
|
/**
|
|
1097
|
-
*
|
|
1100
|
+
* <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
|
|
1098
1101
|
*/
|
|
1099
|
-
|
|
1102
|
+
Status?: string;
|
|
1100
1103
|
/**
|
|
1101
|
-
*
|
|
1102
|
-
—RUN:处理中
|
|
1103
|
-
—FAIL:处理失败
|
|
1104
|
-
—STOP:处理终止
|
|
1105
|
-
—DONE:处理完成
|
|
1104
|
+
* <p>任务执行错误码。当任务状态不为 FAIL 时,该值为""。</p>
|
|
1106
1105
|
*/
|
|
1107
|
-
|
|
1106
|
+
ErrorCode?: string;
|
|
1108
1107
|
/**
|
|
1109
|
-
*
|
|
1108
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</p>
|
|
1110
1109
|
*/
|
|
1111
|
-
|
|
1110
|
+
ErrorMessage?: string;
|
|
1112
1111
|
/**
|
|
1113
|
-
*
|
|
1112
|
+
* <p>结果视频 URL。有效期 24 小时。</p>
|
|
1114
1113
|
*/
|
|
1115
|
-
|
|
1114
|
+
ResultVideoUrl?: string;
|
|
1116
1115
|
/**
|
|
1117
|
-
*
|
|
1116
|
+
* <p>视频id</p>
|
|
1118
1117
|
*/
|
|
1119
|
-
|
|
1118
|
+
VideoId?: string;
|
|
1120
1119
|
/**
|
|
1121
|
-
*
|
|
1120
|
+
* <p>视频总时长,单位s</p>
|
|
1122
1121
|
*/
|
|
1123
|
-
|
|
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
|
-
*
|
|
1133
|
+
* DescribePortraitSingJob请求参数结构体
|
|
1131
1134
|
*/
|
|
1132
|
-
export interface
|
|
1135
|
+
export interface DescribePortraitSingJobRequest {
|
|
1133
1136
|
/**
|
|
1134
|
-
*
|
|
1137
|
+
* 任务ID
|
|
1135
1138
|
*/
|
|
1136
|
-
|
|
1139
|
+
JobId: string;
|
|
1140
|
+
}
|
|
1141
|
+
/**
|
|
1142
|
+
* DescribeHunyuanToVideoJob请求参数结构体
|
|
1143
|
+
*/
|
|
1144
|
+
export interface DescribeHunyuanToVideoJobRequest {
|
|
1137
1145
|
/**
|
|
1138
|
-
*
|
|
1146
|
+
* 任务ID
|
|
1139
1147
|
*/
|
|
1140
|
-
|
|
1148
|
+
JobId: string;
|
|
1149
|
+
}
|
|
1150
|
+
/**
|
|
1151
|
+
* DescribeMotionControlKlingJob请求参数结构体
|
|
1152
|
+
*/
|
|
1153
|
+
export interface DescribeMotionControlKlingJobRequest {
|
|
1141
1154
|
/**
|
|
1142
|
-
*
|
|
1155
|
+
* <p>任务ID</p>
|
|
1143
1156
|
*/
|
|
1144
|
-
|
|
1157
|
+
JobId: string;
|
|
1158
|
+
}
|
|
1159
|
+
/**
|
|
1160
|
+
* CheckAnimateImageJob返回参数结构体
|
|
1161
|
+
*/
|
|
1162
|
+
export interface CheckAnimateImageJobResponse {
|
|
1145
1163
|
/**
|
|
1146
|
-
*
|
|
1164
|
+
* 输入图是否通过校验。
|
|
1147
1165
|
*/
|
|
1148
|
-
|
|
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
|
|
1175
|
+
export interface SubmitVideoEditJobResponse {
|
|
1158
1176
|
/**
|
|
1159
|
-
*
|
|
1160
|
-
- 换人场景:1
|
|
1177
|
+
* <p>任务ID。</p>
|
|
1161
1178
|
*/
|
|
1162
|
-
|
|
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 时,该值为""。</p>
|
|
1281
|
+
*/
|
|
1282
|
+
ErrorCode?: string;
|
|
1283
|
+
/**
|
|
1284
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</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 时,该值为""。</p>
|
|
1867
|
+
*/
|
|
1868
|
+
ErrorCode?: string;
|
|
1869
|
+
/**
|
|
1870
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</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 时,该值为""。</p>
|
|
2023
|
+
*/
|
|
2024
|
+
ErrorCode?: string;
|
|
2025
|
+
/**
|
|
2026
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</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> "MultiPrompt":[ { "Index":int, "Prompt": "string", "Duration": "5" } ]</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 时,该值为""。</p>
|
|
2284
|
+
*/
|
|
2285
|
+
ErrorCode?: string;
|
|
2286
|
+
/**
|
|
2287
|
+
* <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为""。</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
|
}
|