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