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.
Files changed (60) hide show
  1. package/es/common/sdk_version.js +1 -1
  2. package/es/services/adp/v20260520/adp_client.js +63 -12
  3. package/es/services/cfw/v20190904/cfw_client.js +12 -0
  4. package/es/services/ess/v20201111/ess_client.js +6 -0
  5. package/es/services/essbasic/v20210526/essbasic_client.js +6 -0
  6. package/es/services/tke/v20180525/tke_client.js +5 -2
  7. package/es/services/vclm/v20240523/vclm_client.js +8 -41
  8. package/package.json +1 -1
  9. package/tencentcloud/common/sdk_version.d.ts +1 -1
  10. package/tencentcloud/common/sdk_version.js +1 -1
  11. package/tencentcloud/services/adp/v20260520/adp_client.d.ts +81 -13
  12. package/tencentcloud/services/adp/v20260520/adp_client.js +120 -18
  13. package/tencentcloud/services/adp/v20260520/adp_models.d.ts +781 -179
  14. package/tencentcloud/services/as/v20180419/as_models.d.ts +5 -7
  15. package/tencentcloud/services/cdc/v20201214/cdc_models.d.ts +2 -2
  16. package/tencentcloud/services/cfw/v20190904/cfw_client.d.ts +19 -3
  17. package/tencentcloud/services/cfw/v20190904/cfw_client.js +25 -1
  18. package/tencentcloud/services/cfw/v20190904/cfw_models.d.ts +597 -303
  19. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +41 -25
  20. package/tencentcloud/services/csip/v20221121/csip_models.d.ts +70 -54
  21. package/tencentcloud/services/cvm/v20170312/cvm_models.d.ts +27 -11
  22. package/tencentcloud/services/dts/v20211206/dts_client.d.ts +1 -1
  23. package/tencentcloud/services/dts/v20211206/dts_models.d.ts +136 -61
  24. package/tencentcloud/services/es/v20180416/es_models.d.ts +18 -1
  25. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +26 -1
  26. package/tencentcloud/services/ess/v20201111/ess_client.js +29 -0
  27. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +139 -82
  28. package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +26 -1
  29. package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +29 -0
  30. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +126 -162
  31. package/tencentcloud/services/faceid/v20180301/faceid_models.d.ts +14 -23
  32. package/tencentcloud/services/goosefs/v20220519/goosefs_models.d.ts +35 -17
  33. package/tencentcloud/services/iotexplorer/v20190423/iotexplorer_models.d.ts +4 -0
  34. package/tencentcloud/services/live/v20180801/live_models.d.ts +12 -26
  35. package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts +5 -11
  36. package/tencentcloud/services/monitor/v20180724/monitor_client.d.ts +3 -1
  37. package/tencentcloud/services/monitor/v20180724/monitor_client.js +3 -1
  38. package/tencentcloud/services/monitor/v20180724/monitor_models.d.ts +20 -21
  39. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +59 -33
  40. package/tencentcloud/services/mqtt/v20240516/mqtt_models.d.ts +4 -0
  41. package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +38 -22
  42. package/tencentcloud/services/ocr/v20181119/ocr_client.d.ts +6 -2
  43. package/tencentcloud/services/ocr/v20181119/ocr_client.js +6 -2
  44. package/tencentcloud/services/rce/v20250425/rce_models.d.ts +131 -13
  45. package/tencentcloud/services/ssm/v20190923/ssm_models.d.ts +14 -11
  46. package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts +8 -0
  47. package/tencentcloud/services/tcss/v20201101/tcss_models.d.ts +62 -67
  48. package/tencentcloud/services/tdai/v20250717/tdai_models.d.ts +20 -0
  49. package/tencentcloud/services/teo/v20220901/teo_models.d.ts +9 -23
  50. package/tencentcloud/services/tke/v20180525/tke_client.d.ts +7 -3
  51. package/tencentcloud/services/tke/v20180525/tke_client.js +9 -3
  52. package/tencentcloud/services/tke/v20180525/tke_models.d.ts +42 -13
  53. package/tencentcloud/services/tokenhub/v20260322/tokenhub_models.d.ts +354 -134
  54. package/tencentcloud/services/trtc/v20190722/trtc_models.d.ts +2 -2
  55. package/tencentcloud/services/vclm/v20240523/vclm_client.d.ts +9 -53
  56. package/tencentcloud/services/vclm/v20240523/vclm_client.js +12 -78
  57. package/tencentcloud/services/vclm/v20240523/vclm_models.d.ts +1169 -1666
  58. package/tencentcloud/services/vod/v20180717/vod_client.d.ts +1 -1
  59. package/tencentcloud/services/vod/v20180717/vod_models.d.ts +121 -18
  60. 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
- * SubmitVideoStylizationJob请求参数结构体
27
+ * DescribeTextToVideoViduJob请求参数结构体
28
28
  */
29
- export interface SubmitVideoStylizationJobRequest {
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
- StyleStrength?: string;
33
+ JobId: string;
55
34
  }
56
35
  /**
57
- * SubmitImageToVideoJob请求参数结构体
36
+ * SubmitImageToVideoViduJob请求参数结构体
58
37
  */
59
- export interface SubmitImageToVideoJobRequest {
38
+ export interface SubmitImageToVideoViduJobRequest {
60
39
  /**
61
- * <p>模型名称。<br>v1.6:Kling-V1-6<br>v2.0:Kling-V2-Master<br>v2.1:Kling-V2-1<br>v2.5:Kling-V2-5-Turbo<br>v2.6:Kling-V2-6<br>V3.0:kling-v3</p>
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>参考图像。</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>
48
+ * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:若使用is_rec推荐提示词参数,模型将不考虑此参数所输入的提示词</p>
66
49
  */
67
- Image?: Image;
50
+ Prompt?: string;
68
51
  /**
69
- * <p>参考尾帧图像。</p><ul><li>支持传入图片Base64编码或图片URL(确保可访问)</li><li>图片文件大小不能超过10MB,图片分辨率不小于300*300px,图片宽高比要在1:2.5 ~ 2.5:1之间</li><li>Image 参数与 ImageTail 参数至少二选一,二者不能同时为空</li><li>图片格式支持.jpg / .jpeg / .png</li><li>ImageTail参数、DynamicMasks/StaticMask参数、CameraControl参数三选一,不能同时使用</li></ul>
52
+ * <p>是否使用推荐提示词,默认关闭<br>-true:是,由系统自动推荐提示词,并使用提示词内容生成视频,推荐提示词数量=1<br>-false:否,根据输入的prompt生成视频<br>注意:启用推荐提示词后,每个任务多消耗1积分</p>
70
53
  */
71
- ImageTail?: Image;
54
+ IsRec?: boolean;
72
55
  /**
73
- * <p>正向文本提示词。不能超过2500个字符</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
- Prompt?: string;
58
+ Audio?: boolean;
76
59
  /**
77
- * <p>负向文本提示词。不能超过2500个字符</p>
60
+ * <p>音色id<br>用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:新音色列表<br>暂不支持声音复刻功能</p>
78
61
  */
79
- NegativePrompt?: string;
62
+ VoiceId?: string;
80
63
  /**
81
- * <p>生成视频时长,单位s。默认值为5。<br>枚举值:3,4,5,6,7,8,9,10,11,12,13,14,15</p><p>不同模型支持时长不同</p><ul><li>模型v1.6v2.0、v2.5、v2.6:支持5、10</li><li>模型v3.0:支持3~15s</li></ul>
64
+ * <p>视频时长参数:<br>【首帧生视频】:<br>viduq3-pro、viduq3-turboxa0默认为 5,可选:1 - 16<br>viduq2-pro、viduq2-turboxa0默认为 5,可选:1 - 10</p><p>【首尾帧生视频】:<br>viduq3-proxa0viduq3-turbo默认为 5,可选:1 - 16<br>viduq2-providuq2-turboxa0默认为 5,可选:1 - 8</p>
82
65
  */
83
- Duration?: string;
66
+ Duration?: number;
84
67
  /**
85
- * <p>生成视频的模式<br>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p><p>不同模型版本、视频模式支持范围不同</p><ul><li>v1.6:首尾帧与仅首帧情况下只支持pro</li><li>v2.0v3.0 :无需配置</li><li>v2.1、v2.5、v2.6:首尾帧情况下只支持pro</li></ul>
68
+ * <p>分辨率参数<br>【首帧生视频】:</p><ul><li>viduq3-pro 、viduq3-turbo 1-16秒:默认 720p,可选:540p、720p、1080p</li><li>viduq2-providuq2-turbo 1-10秒:默认 720p,可选:720p1080p<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
- Mode?: string;
70
+ Resolution?: string;
88
71
  /**
89
- * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>v2.0v2.5v2.6模型的不支持当前参数<br>取值范围:[0, 1]</p>
72
+ * <p>运动幅度<br>默认 auto,可选值:autosmallmedium、large<br>注:q2、q3系列模型改参数不生效</p>
90
73
  */
91
- CfgScale?: number;
74
+ MovementAmplitude?: string;
92
75
  /**
93
- * <p>生成视频时是否同时生成声音<br>枚举值:on,off<br>不同模型版本、视频模式支持范围不同</p><ul><li>v2.6:有首尾帧的pro模式只能生成无声的视频</li></ul>
76
+ * <p>bgm</p>
94
77
  */
95
- Sound?: string;
78
+ Bgm?: boolean;
96
79
  /**
97
- * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</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
- LogoAdd?: number;
82
+ AudioType?: string;
100
83
  /**
101
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
84
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
102
85
  */
103
- LogoParam?: LogoParam;
86
+ MetaData?: string;
104
87
  /**
105
- * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,Prompt参数无效,且不支持设定首尾帧生视频</li><li>当前参数为false时,ShotType参数及MultiPrompt参数无效</li></ul>
88
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
106
89
  */
107
- MultiShot?: boolean;
90
+ CallbackUrl?: string;
108
91
  /**
109
- * <p>分镜方式</p><ul><li>枚举值:customize,intelligence</li><li>当MultiShot参数为true时,当前参数必填</li></ul>
92
+ * <p>透传参数<br>不做任何处理,仅数据传输<br>注:最多 1048576个字符</p>
110
93
  */
111
- ShotType?: string;
94
+ Payload?: string;
112
95
  /**
113
- * <p>各分镜信息,如提示词、时长等<br>通过Index、Prompt、Duration参数定义分镜序号及相应提示词和时长,其中:</p><ul><li>最多支持6个分镜,最小支持1个分镜</li><li>每个分镜相关内容的最大长度不超过512</li><li>每个分镜的时长不大于当前任务的总时长,不小于1</li><li>所有分镜的时长之和等于当前任务的总时长</li></ul><p>用key:value承载,如下:<br>&quot;MultiPrompt&quot;:[<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> },<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> }<br>]</p><ul><li>当MultiShot参数为true且ShotType参数为customize时,当前参数不得为空</li></ul>
96
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
114
97
  */
115
- MultiPrompt?: Array<MultiPrompt>;
98
+ OffPeak?: boolean;
116
99
  /**
117
- * <p>参考主体列表</p><ul><li><p>基于主体库中主体的ID配置,用key:value承载,如下:</p><pre><code> &quot;ElementList&quot;:[ { &quot;ElementId&quot;:long }, { &quot;ElementId&quot;:long } ]</code></pre></li><li><p>最多支持3个参考主体</p></li><li><p>主体分为视频定制主体(简称:视频角色主体)和图片定制主体(简称:多图主体),适用范围不同,请注意区分</p></li><li><p>更多主体信息详见:可灵「主体库 3.0」使用指南</p></li></ul>
100
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
118
101
  */
119
- ElementList?: Array<Element>;
102
+ LogoAdd?: number;
120
103
  /**
121
- * <p>静态笔刷涂抹区域(用户通过运动笔刷涂抹的 mask 图片)<br>“运动笔刷”能力包含“动态笔刷 DynamicMasks”和“静态笔刷 StaticMask”两种<br>支持传入图片Base64编码或图片URL(确保可访问,格式要求同 Image 字段)<br>图片格式支持.jpg / .jpeg / .png<br>图片长宽比必须与输入图片相同(即Image字段),否则任务失败(failed)<br>StaticMask和 DynamicMasks.Mask这两张图片的分辨率必须一致,否则任务失败(failed)</p>
104
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
122
105
  */
123
- StaticMask?: string;
106
+ LogoParam?: LogoParam;
107
+ }
108
+ /**
109
+ * logo参数
110
+ */
111
+ export interface LogoParam {
124
112
  /**
125
- * <p>动态笔刷配置列表<br>可配置多组(最多6组),每组包含“涂抹区域 Mask”与“运动轨迹 Trajectories”序列</p>
113
+ * 水印 Url
126
114
  */
127
- DynamicMasks?: Array<DynamicMask>;
115
+ LogoUrl?: string;
128
116
  /**
129
- * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
117
+ * 水印 Base64,Url 和 Base64 二选一传入,如果都提供以 Url 为准
130
118
  */
131
- CameraControl?: CameraControl;
119
+ LogoImage?: string;
132
120
  /**
133
- * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
121
+ * 水印图片位于生成结果图中的坐标及宽高,将按照坐标对标识图片进行位置和大小的拉伸匹配。
134
122
  */
135
- CallbackUrl?: string;
123
+ LogoRect?: LogoRect;
124
+ }
125
+ /**
126
+ * SubmitVideoEditKlingJob请求参数结构体
127
+ */
128
+ export interface SubmitVideoEditKlingJobRequest {
136
129
  /**
137
- * <p>生成视频时所引用的音色的列表</p><p>一次视频生成任务至多引用2个音色<br>当VoiceList参数不为空且Prompt参数中引用音色ID时,视频生成任务按“有指定音色”计量计费<br>VoiceId参数值通过音色定制接口返回,也可使用系统预置音色,详见音色定制相关API;非对口型API的VoiceId<br>ElementList参数与VoiceList参数互斥,不能共存<br>v3模型不支持指定音色<br>用key:value承载,如下:<br>&quot;VoiceList&quot;:[<br> {&quot;VoiceId&quot;:&quot;VoiceId_1&quot;},<br> {&quot;VoiceId&quot;:&quot;VoiceId_2&quot;}<br>]</p>
130
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
138
131
  */
139
- VoiceList?: Array<Voice>;
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
- * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
142
+ * <p>参考图列表</p><p>包括主体、场景、风格等参考图片,也可作为首帧或尾帧生成视频;当作为首帧或尾帧生成视频时:</p><p>通过type参数来定义图片是否为首尾帧:first_frame为首帧,end_frame为尾帧</p><p>暂时不支持仅尾帧,即有尾帧图时必须有首帧图</p><p>首帧或首尾帧生视频时,不能使用视频编辑功能</p><p>用key:value承载,如下:</p><p>&quot;ImageInfo&quot;:[<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;first_frame&quot;<br> },<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;end_frame&quot;<br> }<br>]<br>支持传入图片URL(确保可访问)</p><p>图片格式支持.jpg / .jpeg / .png</p><p>图片文件大小不能超过10MB,图片宽高尺寸不小于300px,不大于8000px,图片宽高比要在1:2.5 ~ 2.5:1之间</p><p>有参考视频时,参考图片数量不得超过4;无参考视频时,参考图片数量不得超过7</p><p>数组中超过2张图片时,不支持设置尾帧</p>
151
143
  */
152
- Status?: string;
144
+ ImageList?: Array<ImageInfo>;
153
145
  /**
154
- * 结果视频URL。有效期 24 小时。
146
+ * <p>生成视频的画面纵横比(宽:高)</p><p>枚举值:16:9, 9:16, 1:1</p><p>未使用首帧参考或视频编辑功能时,当前参数必填</p>
155
147
  */
156
- ResultVideoUrl?: string;
148
+ AspectRatio?: string;
157
149
  /**
158
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
150
+ * <p>生成视频时长,单位s</p><p>枚举值:3,4,5,6,7,8,9,10,其中:使用文生视频、首帧图生视频时,仅支持5和10s<br>使用视频编辑功能(“refer_type”:“base”)时,输出结果与传入视频时长相同,此时当前参数无效;此时,按输入视频时长四舍五入取整计量计费</p>
159
151
  */
160
- ErrorCode?: string;
152
+ Duration?: number;
161
153
  /**
162
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
154
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
163
155
  */
164
- ErrorMessage?: string;
156
+ LogoAdd?: number;
165
157
  /**
166
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
158
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
167
159
  */
168
- RequestId?: string;
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承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
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
- * SubmitTextToVideoViduJob请求参数结构体
322
+ * SubmitImageToVideoViduJob返回参数结构体
260
323
  */
261
- export interface SubmitTextToVideoViduJobRequest {
324
+ export interface SubmitImageToVideoViduJobResponse {
262
325
  /**
263
- * <p>文本提示词<br>生成视频的文本描述。<br>注:字符长度不能超过 2000 个字符</p>
326
+ * <p>任务ID。</p>
264
327
  */
265
- Prompt: string;
328
+ JobId?: string;
266
329
  /**
267
- * <p>模型名称,可选值,默认viduq2</p><ul><li>viduq2:最新模型</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
330
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
268
331
  */
269
- Model?: string;
332
+ RequestId?: string;
333
+ }
334
+ /**
335
+ * DescribeTextToVideoViduJob返回参数结构体
336
+ */
337
+ export interface DescribeTextToVideoViduJobResponse {
270
338
  /**
271
- * <p>视频时长参数,默认值依据模型而定:</p><ul><li>viduq3-pro、viduq3-turbo: 默认5秒,可选:1-16</li><li>viduq2 : 默认5秒,可选:1-10</li></ul>
339
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
272
340
  */
273
- Duration?: number;
341
+ Status?: string;
274
342
  /**
275
- * <p>是否为生成的视频添加背景音乐。<br>默认:false,可选值 true 、false<br>传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p><ul><li>BGM不限制时长,系统根据视频时长自动适配</li><li>BGM参数在q2模型的duration为 9秒 或 10秒 时不生效;该参数在q3系列模型中不生效</li></ul>
343
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
276
344
  */
277
- Bgm?: boolean;
345
+ ErrorCode?: string;
278
346
  /**
279
- * <p>比例<br>默认 16:9,可选值如下:16:9、9:16、4:3、3:4、1:1</p>
347
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
280
348
  */
281
- AspectRatio?: string;
349
+ ErrorMessage?: string;
282
350
  /**
283
- * <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>
351
+ * <p>结果视频 URL。有效期 24 小时。</p>
284
352
  */
285
- Resolution?: string;
353
+ ResultVideoUrl?: string;
286
354
  /**
287
- * <p>风格<br>默认 general,可选值:general、anime<br>general:通用风格,可以通过提示词来控制风格<br>anime:动漫风格,仅在动漫风格表现突出,可以通过不同的动漫风格提示词来控制<br>注:使用q2、q3系列模型时该参数不生效</p>
355
+ * <p>该任务消耗的积分数量。</p>
288
356
  */
289
- Style?: string;
357
+ Credits?: number;
290
358
  /**
291
- * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:使用q2、q3系列模型时该参数不生效</p>
359
+ * <p>任务调用时传入的透传参数。</p>
292
360
  */
293
- MovementAmplitude?: string;
361
+ Payload?: string;
294
362
  /**
295
- * <p>是否使用音视频直出能力,默认为true,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
363
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
296
364
  */
297
- Audio?: boolean;
365
+ RequestId?: string;
366
+ }
367
+ /**
368
+ * DescribeVideoExtendKlingJob请求参数结构体
369
+ */
370
+ export interface DescribeVideoExtendKlingJobRequest {
298
371
  /**
299
- * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
372
+ * <p>任务ID。</p>
300
373
  */
301
- MetaData?: string;
374
+ JobId?: string;
302
375
  /**
303
- * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
376
+ *
304
377
  */
305
- CallbackUrl?: string;
378
+ ExternalTaskId?: string;
379
+ }
380
+ /**
381
+ * SubmitReferenceToVideoViduJob请求参数结构体
382
+ */
383
+ export interface SubmitReferenceToVideoViduJobRequest {
306
384
  /**
307
- * <p>透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符</p>
385
+ * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:使用Subjects主体参数时,可以通过@主体id 来表示主体内容,例如:&quot;@1 和 @2 在一起吃火锅,并且旁白音说火锅大家都爱吃。&quot;</p>
308
386
  */
309
- Payload?: string;
387
+ Prompt: string;
310
388
  /**
311
- * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
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
- OffPeak?: boolean;
391
+ Images?: Array<string>;
314
392
  /**
315
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
393
+ * <p>参考生图主体信息,支持1-7个主体,主体图片共1 7张<br>【主体调用时传入】</p>
316
394
  */
317
- LogoAdd?: number;
395
+ Subjects?: Array<ReferenceSubject>;
318
396
  /**
319
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</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
- LogoParam?: LogoParam;
322
- }
323
- /**
324
- * SubmitVideoEditJob请求参数结构体
325
- */
326
- export interface SubmitVideoEditJobRequest {
399
+ Videos?: Array<string>;
327
400
  /**
328
- * <p>参考视频URL。默认为待编辑视频。</p><ul><li>视频格式:支持MP4</li><li>视频时长:输入视频时长≤10秒</li><li>视频大小:不超过200M</li><li>视频文件:输入的视频帧率及分辨率不做限制(建议输入16:9或9:16的视频;分辨率建议在2160px内,帧率建议在60fps内);输出视频是帧率会≥16fps,分辨率为720p</li></ul>
401
+ * <p>模型名称,可选值,当前仅可并且默认viduq2</p><ul><li>viduq2:最新模型</li></ul>
329
402
  */
330
- VideoUrl: string;
403
+ Model?: string;
331
404
  /**
332
- * <p>视频内容的描述,中文正向提示词。支持视频内容增加、删除、修改等能力</p><ul><li>最多支持200个 utf-8 字符(首尾空格不计入字符数)</li><li>不传prompt的时候,Images.N参考图列表必须要传图,且传的图片是经过图片编辑之后的结果图</li></ul>
405
+ * <p>是否使用音视频直出能力,默认false,可选值 true、false</p><ul><li>true:使用音视频直出能力。</li><li>false:不使用音视频直出能力。<br>仅上传主体时支持此功能</li></ul>
333
406
  */
334
- Prompt?: string;
407
+ Audio?: boolean;
335
408
  /**
336
- * <p>参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。</p><ul><li>支持传入图片Base64编码或图片URL</li><li>图片格式:支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>图片文件:大小不能超过10MB(base64后)。单边分辨率不超过5000px,不小于50px,图片长宽限制1:4 ~ 4:1。<br>示例值:[{ &quot;Url&quot;: &quot;https://console.cloud.tencent.com/cos/image.png&quot;}]</li></ul>
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
- Images?: Array<Image>;
411
+ AudioType?: string;
339
412
  /**
340
- * <p>图片base64或者图片url</p><ul><li>Base64 Url 必须提供一个,如果都提供以Url为准。</li><li>上传图url大小不超过 8M</li><li>支持jpg,png,jpeg,webp,bmp,tiff 格式</li><li>单边分辨率不超过5000,不小于50,长宽限制1:4 ~ 4:1</li></ul>
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
- Image?: Image;
415
+ Bgm?: boolean;
344
416
  /**
345
- * <p>扩展字段。</p>
417
+ * <p>视频时长参数:<br>默认5秒,可选:1-10(整数)</p>
346
418
  */
347
- VideoEditParam?: VideoEditParam;
419
+ Duration?: number;
348
420
  /**
349
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</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
- LogoAdd?: number;
423
+ AspectRatio?: string;
352
424
  /**
353
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
425
+ * <p>分辨率参数<br>默认 720p, 可选:540p、720p、1080p</p>
354
426
  */
355
- LogoParam?: LogoParam;
356
- }
357
- /**
358
- * DescribeVideoExtendKlingJob请求参数结构体
359
- */
360
- export interface DescribeVideoExtendKlingJobRequest {
427
+ Resolution?: string;
361
428
  /**
362
- * <p>任务ID。</p>
429
+ * <p>运动幅度默认 auto,可选值:auto、small、medium、large<br>注:使用q2系列模型时该参数不生效</p>
363
430
  */
364
- JobId?: string;
431
+ MovementAmplitude?: string;
365
432
  /**
366
- *
433
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,&quot;ContentProducer&quot;: &quot;yourcontentproducer&quot;,&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,&quot;ProduceID&quot;: &quot;yourproductid&quot;, &quot;PropagateID&quot;: &quot;your_propagate_id&quot;,&quot;ReservedCode1&quot;: &quot;yourreservedcode1&quot;, &quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
367
434
  */
368
- ExternalTaskId?: string;
369
- }
370
- /**
371
- * SubmitVideoEditKlingJob请求参数结构体
372
- */
373
- export interface SubmitVideoEditKlingJobRequest {
435
+ MetaData?: string;
374
436
  /**
375
- * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
437
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
376
438
  */
377
- Prompt?: string;
439
+ CallbackUrl?: string;
378
440
  /**
379
- * <p>模型名称,支持kling-video-o1,kling-v3-omni。默认kling-video-o1。</p>
441
+ * <p>透传参数不做任何处理,仅数据传输注:最多 1048576个字符</p>
380
442
  */
381
- Model?: string;
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
- ExternalTaskId?: string;
447
+ OffPeak?: boolean;
386
448
  /**
387
- * <p>参考图列表</p><p>包括主体、场景、风格等参考图片,也可作为首帧或尾帧生成视频;当作为首帧或尾帧生成视频时:</p><p>通过type参数来定义图片是否为首尾帧:first_frame为首帧,end_frame为尾帧</p><p>暂时不支持仅尾帧,即有尾帧图时必须有首帧图</p><p>首帧或首尾帧生视频时,不能使用视频编辑功能</p><p>用key:value承载,如下:</p><p>&quot;ImageInfo&quot;:[<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;first_frame&quot;<br> },<br> {<br> &quot;ImageUrl&quot;:&quot;https://cos.ap-guangzhou.myqcloud.com/test.png&quot;,<br> &quot;Type&quot;:&quot;end_frame&quot;<br> }<br>]<br>支持传入图片URL(确保可访问)</p><p>图片格式支持.jpg / .jpeg / .png</p><p>图片文件大小不能超过10MB,图片宽高尺寸不小于300px,不大于8000px,图片宽高比要在1:2.5 ~ 2.5:1之间</p><p>有参考视频时,参考图片数量不得超过4;无参考视频时,参考图片数量不得超过7</p><p>数组中超过2张图片时,不支持设置尾帧</p>
449
+ * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
388
450
  */
389
- ImageList?: Array<ImageInfo>;
451
+ LogoAdd?: number;
390
452
  /**
391
- * <p>生成视频的画面纵横比(宽:高)</p><p>枚举值:16:9, 9:16, 1:1</p><p>未使用首帧参考或视频编辑功能时,当前参数必填</p>
453
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
392
454
  */
393
- AspectRatio?: string;
455
+ LogoParam?: LogoParam;
456
+ }
457
+ /**
458
+ * DescribeTemplateToVideoJob返回参数结构体
459
+ */
460
+ export interface DescribeTemplateToVideoJobResponse {
394
461
  /**
395
- * <p>生成视频时长,单位s</p><p>枚举值:3,4,5,6,7,8,9,10,其中:使用文生视频、首帧图生视频时,仅支持5和10s<br>使用视频编辑功能(“refer_type”:“base”)时,输出结果与传入视频时长相同,此时当前参数无效;此时,按输入视频时长四舍五入取整计量计费</p>
462
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
396
463
  */
397
- Duration?: number;
464
+ Status?: string;
398
465
  /**
399
- * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
466
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
400
467
  */
401
- LogoAdd?: number;
468
+ ErrorCode?: string;
402
469
  /**
403
- * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
470
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
404
471
  */
405
- LogoParam?: LogoParam;
472
+ ErrorMessage?: string;
406
473
  /**
407
- * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
474
+ * 结果视频 URL。有效期 24 小时。
408
475
  */
409
- Mode?: string;
476
+ ResultVideoUrl?: string;
410
477
  /**
411
- * <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>
478
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
412
479
  */
413
- VideoList?: Array<ReferVideoInfo>;
480
+ RequestId?: string;
481
+ }
482
+ /**
483
+ * 控制摄像机运动的协议
484
+ */
485
+ export interface CameraControl {
414
486
  /**
415
- * <p>是否生成多镜头视频 当前参数为true时,prompt参数无效,且不支持设定首尾帧生视频 当前参数为false时,shot_type参数及multi_prompt参数无效</p>
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
- MultiShot?: boolean;
494
+ Type?: string;
418
495
  /**
419
- * <p>分镜方式 枚举值:customize 当multi_shot参数为true时,当前参数必填</p>
496
+ * 包含六个字段,用于指定摄像机在不同方向上的运动或变化。
497
+ - 当运镜类型指定simple时必填,指定其他类型时不填
498
+ - 参数6选1,即只能有一个参数不为0,其余参数为0
420
499
  */
421
- ShotType?: string;
500
+ Config?: CameraControlConfig;
501
+ }
502
+ /**
503
+ * DescribeVideoFaceFusionJob返回参数结构体
504
+ */
505
+ export interface DescribeVideoFaceFusionJobResponse {
422
506
  /**
423
- * <p>各分镜信息,如提示词、时长等 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中: 最多支持6个分镜,最小支持1个分镜 每个分镜相关内容的最大长度不超过512 每个分镜的时长不大于当前任务的总时长,不小于1 所有分镜的时长之和等于当前任务的总时长</p>
507
+ * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
424
508
  */
425
- MultiPrompt?: Array<MultiPrompt>;
509
+ Status?: string;
426
510
  /**
427
- * <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
511
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
428
512
  */
429
- ElementList?: Array<Element>;
513
+ ErrorCode?: string;
430
514
  /**
431
- * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
515
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
432
516
  */
433
- CallbackUrl?: string;
517
+ ErrorMessage?: string;
434
518
  /**
435
- * <p>是否开启声音</p>
519
+ * 结果视频 URL。有效期 24 小时。
436
520
  */
437
- Sound?: string;
521
+ ResultVideoUrl?: string;
522
+ /**
523
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
524
+ */
525
+ RequestId?: string;
438
526
  }
439
527
  /**
440
- * DescribeAigcElement返回参数结构体
528
+ * CreateAigcElement返回参数结构体
441
529
  */
442
- export interface DescribeAigcElementResponse {
530
+ export interface CreateAigcElementResponse {
443
531
  /**
444
- * <p>主体名称</p>
532
+ * <p>任务ID。</p>
445
533
  */
446
- Name?: string;
534
+ JobId?: string;
447
535
  /**
448
- * <p>主体id</p>
536
+ * <p>主体Id</p>
449
537
  */
450
538
  ElementId?: string;
451
539
  /**
452
- * <p>主体描述</p>
540
+ * <p>任务状态</p><p>默认值:任务状态</p>
453
541
  */
454
- Description?: string;
542
+ Status?: string;
455
543
  /**
456
- * <p>主体参考方式</p><p>枚举值:</p><ul><li>video_refer: 视频角色主体</li><li>image_refer: 多图主体</li></ul>
544
+ * <p>厂商</p>
457
545
  */
458
- ReferenceType?: string;
546
+ Provider?: Array<string>;
459
547
  /**
460
- * <p>任务状态</p><p>枚举值:</p><ul><li>pending: 执行中</li><li>failed: 任务失败</li><li>succeed: 任务成功</li></ul>
548
+ * <p>任务创建时间</p>
461
549
  */
462
- Status?: string;
550
+ CreatedAt?: string;
463
551
  /**
464
- * <p>厂商列表</p>
552
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
465
553
  */
466
- Provider?: Array<string>;
554
+ RequestId?: string;
555
+ }
556
+ /**
557
+ * DescribeImageToVideoJob返回参数结构体
558
+ */
559
+ export interface DescribeImageToVideoJobResponse {
467
560
  /**
468
- * <p>主体参考图,可通过多张图片设定主体及其细节</p>
561
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
469
562
  */
470
- ElementImageList?: ElementImageList;
563
+ Status?: string;
471
564
  /**
472
- * <p>主体参考视频,可通过视频设定主体及其细节</p>
565
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
473
566
  */
474
- VideoList?: Array<string>;
567
+ ErrorCode?: string;
475
568
  /**
476
- * <p>为主体配置标签,一个主体可以配置多个标签</p>
569
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
477
570
  */
478
- TagList?: Array<TagList>;
571
+ ErrorMessage?: string;
479
572
  /**
480
- * <p>厂商聚合字段</p>
573
+ * <p>结果视频 URL。有效期 24 小时。</p>
481
574
  */
482
- ProviderDetails?: Array<ProviderDetail>;
575
+ ResultVideoUrl?: string;
483
576
  /**
484
- * <p>创建时间</p>
577
+ * <p>视频id</p>
485
578
  */
486
- CreatedAt?: string;
579
+ VideoId?: string;
487
580
  /**
488
- * <p>更新时间</p>
581
+ * <p>视频总时长,单位s</p>
489
582
  */
490
- UpdatedAt?: string;
583
+ Duration?: string;
491
584
  /**
492
- * <p>音色Id</p>
585
+ * <p>任务最终扣减积分数值</p>
493
586
  */
494
- ElementVoiceId?: string;
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 Voice {
600
+ export interface DescribeVideoFaceFusionJobRequest {
504
601
  /**
505
- * <p>音色id</p>
602
+ * 任务ID
506
603
  */
507
- VoiceId?: string;
604
+ JobId?: string;
508
605
  }
509
606
  /**
510
- * SubmitImageAnimateJob返回参数结构体
607
+ * 人脸框信息。
511
608
  */
512
- export interface SubmitImageAnimateJobResponse {
609
+ export interface FaceRect {
513
610
  /**
514
- * 图片跳舞任务ID。
611
+ * <p>人脸框左上角横坐标。</p>
515
612
  */
516
- JobId?: string;
613
+ X?: number;
517
614
  /**
518
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
615
+ * <p>人脸框左上角纵坐标。</p>
519
616
  */
520
- RequestId?: string;
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
- * SubmitVideoFaceFusionJob返回参数结构体
628
+ * SubmitReferenceToVideoViduJob返回参数结构体
524
629
  */
525
- export interface SubmitVideoFaceFusionJobResponse {
630
+ export interface SubmitReferenceToVideoViduJobResponse {
526
631
  /**
527
- * 视频人脸融合任务的job id(job有效期24小时)
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
- * DescribeTemplateToVideoJob返回参数结构体
641
+ * DescribePortraitSingJob请求参数结构体
537
642
  */
538
- export interface DescribeTemplateToVideoJobResponse {
643
+ export interface DescribePortraitSingJobRequest {
539
644
  /**
540
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
541
- */
542
- Status?: string;
543
- /**
544
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
645
+ * 任务ID
545
646
  */
546
- ErrorCode?: string;
647
+ JobId: string;
648
+ }
649
+ /**
650
+ * DescribeImageToVideoViduJob请求参数结构体
651
+ */
652
+ export interface DescribeImageToVideoViduJobRequest {
547
653
  /**
548
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
654
+ * <p>任务ID</p>
549
655
  */
550
- ErrorMessage?: string;
656
+ JobId: string;
657
+ }
658
+ /**
659
+ * SubmitImageToVideoGeneralJob返回参数结构体
660
+ */
661
+ export interface SubmitImageToVideoGeneralJobResponse {
551
662
  /**
552
- * 结果视频 URL。有效期 24 小时。
663
+ * 任务ID
553
664
  */
554
- ResultVideoUrl?: string;
665
+ JobId?: string;
555
666
  /**
556
667
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
557
668
  */
558
669
  RequestId?: string;
559
670
  }
560
671
  /**
561
- * DescribeReferenceToVideoViduJob返回参数结构体
672
+ * SubmitTextToVideoViduJob请求参数结构体
562
673
  */
563
- export interface DescribeReferenceToVideoViduJobResponse {
564
- /**
565
- * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
566
- */
567
- Status?: string;
568
- /**
569
- * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
570
- */
571
- ErrorCode?: string;
572
- /**
573
- * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
574
- */
575
- ErrorMessage?: string;
576
- /**
577
- * <p>结果视频 URL。有效期 24 小时。</p>
578
- */
579
- ResultVideoUrl?: string;
674
+ export interface SubmitTextToVideoViduJobRequest {
580
675
  /**
581
- * <p>该任务消耗的积分数量。</p>
676
+ * <p>文本提示词<br>生成视频的文本描述。<br>注:字符长度不能超过 2000 个字符</p>
582
677
  */
583
- Credits?: number;
678
+ Prompt: string;
584
679
  /**
585
- * <p>任务调用时传入的透传参数。</p>
680
+ * <p>模型名称,可选值,默认viduq2</p><ul><li>viduq2:最新模型</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
586
681
  */
587
- Payload?: string;
682
+ Model?: string;
588
683
  /**
589
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
684
+ * <p>视频时长参数,默认值依据模型而定:</p><ul><li>viduq3-pro、viduq3-turbo: 默认5秒,可选:1-16</li><li>viduq2 : 默认5秒,可选:1-10</li></ul>
590
685
  */
591
- RequestId?: string;
592
- }
593
- /**
594
- * SubmitMotionControlKlingJob请求参数结构体
595
- */
596
- export interface SubmitMotionControlKlingJobRequest {
686
+ Duration?: number;
597
687
  /**
598
- * <p>模型名称 枚举值:kling-v2-6, kling-v3。</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
- Model?: string;
690
+ Bgm?: boolean;
601
691
  /**
602
- * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
692
+ * <p>比例<br>默认 16:9,可选值如下:16:9、9:16、4:3、3:4、1:1</p>
603
693
  */
604
- Prompt?: string;
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
- ExternalTaskId?: string;
698
+ Resolution?: string;
609
699
  /**
610
- * <p>参考图像,生成视频中的人物、背景等元素均以参考图为准 视频内容需满足以下要求: 人物比例尽量与参考动作比例一致,尽量避免全身动作驱动半身人物进行生成 人物需要露出清晰的上半身或全身的肢体及头部,避免遮挡 画面中人物避免存在极端朝向,比如倒立、平卧等。人物占画面比例不得太低 支持真实/风格化的角色(包括人物/类人动物/部分纯动物/部分类人肢体比例的角色)通过 包含支持传入图片Base64编码或图片URL(确保可访问)。</p>
700
+ * <p>风格<br>默认 general,可选值:general、anime<br>general:通用风格,可以通过提示词来控制风格<br>anime:动漫风格,仅在动漫风格表现突出,可以通过不同的动漫风格提示词来控制<br>注:使用q2、q3系列模型时该参数不生效</p>
611
701
  */
612
- Image?: string;
702
+ Style?: string;
613
703
  /**
614
- * <p>参考视频的获取链接。生成视频中的人物动作与参考视频一致。 视频内容需满足以下要求: 人物需要漏出清晰的上半身或全身的全部肢体及头部,避免遮挡 建议上传1人动作视频,2人及以上会取画面占比最大的人物动作进行生成 推荐使用真人动作,部分风格化的人物/类人肢体比例可以通过 动作视频一镜到底,角色始终出现在画面中,避免切镜、运镜等。否则会被截取 动作避免过快,相对平稳的动作生成效果更佳 视频文件支持.mp4/.mov,文件大小不超过100MB,仅支持长宽的边长均位于340px~3850px之间,上述校验不通过会返回错误码等信息 视频时长下限不短于3秒,时长上限与人物朝向参考(character_orientation)有关: 当人物朝向与视频中人物一致时,视频时长最长可达30秒; 当人物朝向与图片中人物一致时,视频时长最长可达10秒; 如果您的动作难度比较高、速度比较快,有一定概率生成不足上传视频时长的结果,因为模型只能提取有效动作时长进行生成,最短提取出3s可用连续动作即可生成。请注意,因此消耗的积分将无法退还,建议适当调整动作难度与速度 系统会校验视频内容,如有问题会返回错误码等信息。</p>
704
+ * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:使用q2、q3系列模型时该参数不生效</p>
615
705
  */
616
- Video?: string;
706
+ MovementAmplitude?: string;
617
707
  /**
618
- * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
708
+ * <p>是否使用音视频直出能力,默认为true,枚举值为:</p><ul><li>false:不需要音视频直出,输出静音视频</li><li>true:需要音画同步,输出声音的视频(包括台词和音效)<br>注1:仅q3系列模型支持该参数</li></ul>
619
709
  */
620
- Mode?: string;
710
+ Audio?: boolean;
621
711
  /**
622
- * <p>可选择是否保留视频原声 枚举值:yes,no 其中yes:保留视频原声 其中no:不保留视频原声。</p>
712
+ * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
623
713
  */
624
- KeepOriginalSound?: string;
714
+ MetaData?: string;
625
715
  /**
626
- * <p>生成视频中人物的朝向,可选择与图片一致或与视频一致 枚举值:image,video,其中: 其中image:与图片中人物朝向一致;此时参考视频时长不得超过10秒; 其中video:与视频中人物朝向一致;此时参考视频时长不得超过30秒; 引用主体时,生成的视频暂时只能参考视频中的人物朝向。</p>
716
+ * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
627
717
  */
628
- CharacterOrientation?: string;
718
+ CallbackUrl?: string;
629
719
  /**
630
- * <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
720
+ * <p>透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符</p>
631
721
  */
632
- ElementList?: Array<Element>;
722
+ Payload?: string;
633
723
  /**
634
- * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
724
+ * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
635
725
  */
636
- CallbackUrl?: string;
726
+ OffPeak?: boolean;
637
727
  /**
638
- * <p>为生成视频添加标识的开关,默认为10 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</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>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
732
+ * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
643
733
  */
644
734
  LogoParam?: LogoParam;
645
735
  }
646
736
  /**
647
- * SubmitVideoExtendKlingJob请求参数结构体
737
+ * SubmitImageToVideoJob请求参数结构体
648
738
  */
649
- export interface SubmitVideoExtendKlingJobRequest {
739
+ export interface SubmitImageToVideoJobRequest {
650
740
  /**
651
- * <p>视频ID 支持通过文本、图片和视频延长生成的视频的ID(原视频不能超过3分钟) 请注意,基于目前的清理策略、视频生成30天之后会被清理,则无法进行延长</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
- VideoId: string;
743
+ Model?: string;
654
744
  /**
655
- * <p>正向文本提示词 不能超过2500个字符</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>负向文本提示词 不能超过2500个字符</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
- ExternalTaskId?: string;
763
+ Duration?: string;
666
764
  /**
667
- * <p>提示词参考强度 取值范围:[0,1],数值越大参考强度越大</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>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
773
+ * <p>生成视频时是否同时生成声音<br>枚举值:on,off<br>不同模型版本、视频模式支持范围不同</p><ul><li>v2.6:有首尾帧的pro模式只能生成无声的视频</li></ul>
672
774
  */
673
- CallbackUrl?: string;
775
+ Sound?: string;
674
776
  /**
675
- * <p>为生成视频添加标识的开关,默认为1。传0 需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成后方可生效。<br>1:添加标识;<br>0:不添加标识;<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
777
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
676
778
  */
677
779
  LogoAdd?: number;
678
780
  /**
679
- * <p>标识内容设置。<br>默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样,如需替换为其他的标识图片,需前往 <a href="https://console.cloud.tencent.com/vtc/setting">控制台</a> 申请开启显式标识自主完成。</p>
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
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
785
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,Prompt参数无效,且不支持设定首尾帧生视频</li><li>当前参数为false时,ShotType参数及MultiPrompt参数无效</li></ul>
693
786
  */
694
- RequestId?: string;
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
- ElementId?: string;
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>&quot;MultiPrompt&quot;:[<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> },<br> {<br> &quot;Index&quot;:int,<br> &quot;Prompt&quot;: &quot;string&quot;,<br> &quot;Duration&quot;: &quot;5&quot;<br> }<br>]</p><ul><li>当MultiShot参数为true且ShotType参数为customize时,当前参数不得为空</li></ul>
706
794
  */
707
- Deleted?: boolean;
795
+ MultiPrompt?: Array<MultiPrompt>;
708
796
  /**
709
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
797
+ * <p>参考主体列表</p><ul><li><p>基于主体库中主体的ID配置,用key:value承载,如下:</p><pre><code> &quot;ElementList&quot;:[ { &quot;ElementId&quot;:long }, { &quot;ElementId&quot;:long } ]</code></pre></li><li><p>最多支持3个参考主体</p></li><li><p>主体分为视频定制主体(简称:视频角色主体)和图片定制主体(简称:多图主体),适用范围不同,请注意区分</p></li><li><p>更多主体信息详见:可灵「主体库 3.0」使用指南</p></li></ul>
710
798
  */
711
- RequestId?: string;
712
- }
713
- /**
714
- * 水印图输入框
715
- */
716
- export interface LogoRect {
799
+ ElementList?: Array<Element>;
717
800
  /**
718
- * <p>水印图框X坐标值。当值大于0时,坐标轴原点位于原图左侧,方向指右;当值小于0时,坐标轴原点位于原图右侧,方向指左。</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
- X?: number;
803
+ StaticMask?: string;
721
804
  /**
722
- * <p>水印图框Y坐标值。当值大于0时,坐标轴原点位于原图上侧,方向指下;当值小于0时,坐标轴原点位于原图下侧,方向指上。</p>
805
+ * <p>动态笔刷配置列表<br>可配置多组(最多6组),每组包含“涂抹区域 Mask”与“运动轨迹 Trajectories”序列</p>
723
806
  */
724
- Y?: number;
807
+ DynamicMasks?: Array<DynamicMask>;
725
808
  /**
726
- * <p>水印图框宽度。<br>单位:px</p>
809
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
727
810
  */
728
- Width?: number;
811
+ CameraControl?: CameraControl;
729
812
  /**
730
- * <p>水印图框高度。<br>单位:px</p>
813
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
731
814
  */
732
- Height?: number;
733
- }
734
- /**
735
- * DescribeVideoEditKlingJob请求参数结构体
736
- */
737
- export interface DescribeVideoEditKlingJobRequest {
815
+ CallbackUrl?: string;
738
816
  /**
739
- * <p>任务ID</p>
817
+ * <p>生成视频时所引用的音色的列表</p><p>一次视频生成任务至多引用2个音色<br>当VoiceList参数不为空且Prompt参数中引用音色ID时,视频生成任务按“有指定音色”计量计费<br>VoiceId参数值通过音色定制接口返回,也可使用系统预置音色,详见音色定制相关API;非对口型API的VoiceId<br>ElementList参数与VoiceList参数互斥,不能共存<br>v3模型不支持指定音色<br>用key:value承载,如下:<br>&quot;VoiceList&quot;:[<br> {&quot;VoiceId&quot;:&quot;VoiceId_1&quot;},<br> {&quot;VoiceId&quot;:&quot;VoiceId_2&quot;}<br>]</p>
740
818
  */
741
- JobId?: string;
819
+ VoiceList?: Array<Voice>;
742
820
  /**
743
821
  *
744
822
  */
745
823
  ExternalTaskId?: string;
746
824
  }
747
825
  /**
748
- * SubmitVideoVoiceJob请求参数结构体
826
+ * DescribeHunyuanToVideoJob请求参数结构体
749
827
  */
750
- export interface SubmitVideoVoiceJobRequest {
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
- * 音效内容的原始负向提示词。输入上限50个字符。
830
+ * 任务ID
761
831
  */
762
- NegativePrompt?: string;
832
+ JobId: string;
833
+ }
834
+ /**
835
+ * SubmitVideoFaceFusionJob返回参数结构体
836
+ */
837
+ export interface SubmitVideoFaceFusionJobResponse {
763
838
  /**
764
- * 为生成视频添加标识的开关,默认为1。 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。 建议您使用显著标识来提示,该视频是 AI 生成的视频。
839
+ * 视频人脸融合任务的job id(job有效期24小时)
765
840
  */
766
- LogoAdd?: number;
841
+ JobId?: string;
767
842
  /**
768
- * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。
843
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
769
844
  */
770
- LogoParam?: LogoParam;
845
+ RequestId?: string;
771
846
  }
772
847
  /**
773
- * DescribeTextToVideoJob返回参数结构体
848
+ * DescribeAigcElement返回参数结构体
774
849
  */
775
- export interface DescribeTextToVideoJobResponse {
850
+ export interface DescribeAigcElementResponse {
776
851
  /**
777
- * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
852
+ * <p>主体名称</p>
778
853
  */
779
- Status?: string;
854
+ Name?: string;
780
855
  /**
781
- * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
856
+ * <p>主体id</p>
782
857
  */
783
- ErrorCode?: string;
858
+ ElementId?: string;
784
859
  /**
785
- * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
860
+ * <p>主体描述</p>
786
861
  */
787
- ErrorMessage?: string;
862
+ Description?: string;
788
863
  /**
789
- * <p>结果视频 URL。有效期 24 小时。</p>
864
+ * <p>主体参考方式</p><p>枚举值:</p><ul><li>video_refer: 视频角色主体</li><li>image_refer: 多图主体</li></ul>
790
865
  */
791
- ResultVideoUrl?: string;
866
+ ReferenceType?: string;
792
867
  /**
793
- * <p>视频id</p>
868
+ * <p>任务状态</p><p>枚举值:</p><ul><li>pending: 执行中</li><li>failed: 任务失败</li><li>succeed: 任务成功</li></ul>
794
869
  */
795
- VideoId?: string;
870
+ Status?: string;
796
871
  /**
797
- * <p>视频总时长,单位s</p>
872
+ * <p>厂商列表</p>
798
873
  */
799
- Duration?: string;
874
+ Provider?: Array<string>;
800
875
  /**
801
- * <p>任务最终扣减积分数值</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
- UserDesignatedUrl?: string;
878
+ ElementImageList?: ElementImageList;
821
879
  /**
822
- * <p>回调地址<br>需要您在创建任务时主动设置 CallbackUrl,请求方法为 POST,当视频生成结束时,我们将向此地址发送生成结果。<br>数据格式如下:<br>{<br> &quot;JobId&quot;: &quot;1397428070633955328&quot;,<br> &quot;Status&quot;: &quot;DONE&quot;,<br> &quot;ErrorCode&quot;: &quot;&quot;,<br> &quot;ErrorMessage&quot;: &quot;&quot;,<br> &quot;ResultVideoUrl&quot;: &quot;https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4&quot;<br>}</p>
880
+ * <p>主体参考视频,可通过视频设定主体及其细节</p>
823
881
  */
824
- CallbackUrl?: string;
882
+ VideoList?: Array<string>;
825
883
  /**
826
- * <p>BGM音频文本。</p>
884
+ * <p>为主体配置标签,一个主体可以配置多个标签</p>
827
885
  */
828
- BGMText?: string;
829
- }
830
- /**
831
- * DescribeVideoEditJob返回参数结构体
832
- */
833
- export interface DescribeVideoEditJobResponse {
886
+ TagList?: Array<TagList>;
834
887
  /**
835
- * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
888
+ * <p>厂商聚合字段</p>
836
889
  */
837
- Status?: string;
890
+ ProviderDetails?: Array<ProviderDetail>;
838
891
  /**
839
- * 结果视频URL。有效期 24 小时。
892
+ * <p>创建时间</p>
840
893
  */
841
- ResultVideoUrl?: string;
894
+ CreatedAt?: string;
842
895
  /**
843
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""。
896
+ * <p>更新时间</p>
844
897
  */
845
- ErrorCode?: string;
898
+ UpdatedAt?: string;
846
899
  /**
847
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
900
+ * <p>音色Id</p>
848
901
  */
849
- ErrorMessage?: string;
902
+ ElementVoiceId?: string;
850
903
  /**
851
904
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
852
905
  */
853
906
  RequestId?: string;
854
907
  }
855
908
  /**
856
- * SubmitVideoStylizationJob返回参数结构体
909
+ * SubmitTextToVideoViduJob返回参数结构体
857
910
  */
858
- export interface SubmitVideoStylizationJobResponse {
911
+ export interface SubmitTextToVideoViduJobResponse {
859
912
  /**
860
- * 任务ID。任务有效期为48小时。
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
- * SubmitVideoFaceFusionJob请求参数结构体
922
+ * 运动轨迹坐标序列
870
923
  */
871
- export interface SubmitVideoFaceFusionJobRequest {
924
+ export interface Trajectory {
872
925
  /**
873
- * 视频素材下载地址。用户自定义模板视频下载地址,使用前需要先调用视频审核接口进行内容审核。视频限制:分辨率≤4k,fps≤25,视频大小≤1G,时长≤20 秒,支持格式mp4。
874
-
875
- 输入视频建议:
876
- 姿态:人脸相对镜头水平方向角度转动不超过 90°,垂直方向角度转动不超过 20°。遮挡:脸部遮挡面积不超过 50%,不要完全遮挡五官,不要有半透明遮挡(强光,玻璃,透明眼镜等)、以及细碎离散的脸部遮挡(如飘落的花瓣)。妆容及光照:避免浓妆、复杂妆容,避免复杂光照、闪烁,这些属性无法完全恢复,并对稳定性有影响。针对特殊表情和微表情,针对局部肌肉控制下的微表情,以及过于夸张的特殊表情等不保证表情效果完全恢复。
926
+ * 轨迹点横坐标(在像素二维坐标系下,以输入图片image左下为原点的像素坐标)
877
927
  */
878
- VideoUrl?: string;
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
- TemplateInfos?: Array<FaceTemplateInfo>;
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
- MergeInfos?: Array<FaceMergeInfo>;
941
+ MergeFaceImage?: Image;
902
942
  /**
903
- * 为生成视频添加标识的开关,默认为1。
904
- 1:添加标识。 0:不添加标识。 其他数值:默认按1处理。
905
- 建议您使用显著标识来提示,该视频是 AI 生成的视频。
943
+ * 上传的图片人脸位置信息(人脸框)
944
+ Width、Height >= 30。
906
945
  */
907
- LogoAdd?: number;
946
+ MergeFaceRect?: FaceRect;
908
947
  /**
909
- * 视频水印Logo参数标识内容设置。
910
- 默认在融合结果图右下角添加“AI生成”类似字样,您可根据自身需要替换为其他的Logo图片。
911
- 输入建议:输入水印图片宽高需小于视频宽高
948
+ * 素材人脸ID,不填默认取上传图片中最大人脸。
912
949
  */
913
- LogoParam?: LogoParam;
950
+ TemplateFaceID?: string;
914
951
  }
915
952
  /**
916
- * SubmitReferenceToVideoViduJob请求参数结构体
953
+ * 指定摄像机在不同方向上的运动或变化
917
954
  */
918
- export interface SubmitReferenceToVideoViduJobRequest {
919
- /**
920
- * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:使用Subjects主体参数时,可以通过@主体id 来表示主体内容,例如:&quot;@1 和 @2 在一起吃火锅,并且旁白音说火锅大家都爱吃。&quot;</p>
921
- */
922
- Prompt: string;
955
+ export interface CameraControlConfig {
923
956
  /**
924
- * <p>图像参考<br>【非主体调用时传入】<br>支持上传1~7张图片,模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。<br>支持传入图片 Base64 编码或图片URL(确保可访问)<br>图片支持 png、jpeg、jpg、webp格式<br>图片像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过50M。</p>
957
+ * 水平运镜,控制摄像机在水平方向上的移动量(沿x轴平移)
958
+
959
+ 取值范围:[-10, 10],负值表示向左平移,正值表示向右平移
925
960
  */
926
- Images?: Array<string>;
961
+ Horizontal?: number;
927
962
  /**
928
- * <p>参考生图主体信息,支持1-7个主体,主体图片共1 ~ 7张<br>【主体调用时传入】</p>
963
+ * 垂直运镜,控制摄像机在垂直方向上的移动量(沿y轴平移)
964
+
965
+ 取值范围:[-10, 10],负值表示向下平移,正值表示向上平移
929
966
  */
930
- Subjects?: Array<ReferenceSubject>;
967
+ Vertical?: number;
931
968
  /**
932
- * <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>
969
+ * 水平摇镜,控制摄像机在水平面上的旋转量(绕y轴旋转)
970
+
971
+ 取值范围:[-10, 10],负值表示绕y轴向左旋转,正值表示绕y轴向右旋转
933
972
  */
934
- Videos?: Array<string>;
973
+ Pan?: number;
935
974
  /**
936
- * <p>模型名称,可选值,当前仅可并且默认viduq2</p><ul><li>viduq2:最新模型</li></ul>
975
+ * 垂直摇镜,控制摄像机在垂直面上的旋转量(沿x轴旋转)
976
+
977
+ 取值范围:[-10, 10],负值表示绕x轴向下旋转,正值表示绕x轴向上旋转
937
978
  */
938
- Model?: string;
979
+ Tilt?: number;
939
980
  /**
940
- * <p>是否使用音视频直出能力,默认false,可选值 true、false</p><ul><li>true:使用音视频直出能力。</li><li>false:不使用音视频直出能力。<br>仅上传主体时支持此功能</li></ul>
981
+ * 旋转运镜,控制摄像机的滚动量(绕z轴旋转)
982
+
983
+ 取值范围:[-10, 10],负值表示绕z轴逆时针旋转,正值表示绕z轴顺时针旋转
941
984
  */
942
- Audio?: boolean;
985
+ Roll?: number;
943
986
  /**
944
- * <p>音频类型,audio为true时必填,默认为all</p><p>枚举值:</p><ul><li>all: 音效+人声</li><li>speech_only: 仅人声</li><li>sound_effect_only: 仅音效</li></ul>
987
+ * 变焦,控制摄像机的焦距变化,影响视野的远近
988
+
989
+ 取值范围:[-10, 10],负值表示焦距变长、视野范围变小,正值表示焦距变短、视野范围变大
945
990
  */
946
- AudioType?: string;
991
+ Zoom?: number;
992
+ }
993
+ /**
994
+ * DescribeAigcElement请求参数结构体
995
+ */
996
+ export interface DescribeAigcElementRequest {
947
997
  /**
948
- * <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>
998
+ * <p>主体Id</p>
949
999
  */
950
- Bgm?: boolean;
1000
+ ElementId?: string;
1001
+ }
1002
+ /**
1003
+ * DescribeReferenceToVideoViduJob返回参数结构体
1004
+ */
1005
+ export interface DescribeReferenceToVideoViduJobResponse {
951
1006
  /**
952
- * <p>视频时长参数:<br>默认5秒,可选:1-10(整数)</p>
1007
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
953
1008
  */
954
- Duration?: number;
1009
+ Status?: string;
955
1010
  /**
956
- * <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>
1011
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
957
1012
  */
958
- AspectRatio?: string;
1013
+ ErrorCode?: string;
959
1014
  /**
960
- * <p>分辨率参数<br>默认 720p, 可选:540p、720p、1080p</p>
1015
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
961
1016
  */
962
- Resolution?: string;
1017
+ ErrorMessage?: string;
963
1018
  /**
964
- * <p>运动幅度默认 auto,可选值:auto、small、medium、large<br>注:使用q2系列模型时该参数不生效</p>
1019
+ * <p>结果视频 URL。有效期 24 小时。</p>
965
1020
  */
966
- MovementAmplitude?: string;
1021
+ ResultVideoUrl?: string;
967
1022
  /**
968
- * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,&quot;ContentProducer&quot;: &quot;yourcontentproducer&quot;,&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,&quot;ProduceID&quot;: &quot;yourproductid&quot;, &quot;PropagateID&quot;: &quot;your_propagate_id&quot;,&quot;ReservedCode1&quot;: &quot;yourreservedcode1&quot;, &quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
1023
+ * <p>该任务消耗的积分数量。</p>
969
1024
  */
970
- MetaData?: string;
1025
+ Credits?: number;
971
1026
  /**
972
- * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
1027
+ * <p>任务调用时传入的透传参数。</p>
973
1028
  */
974
- CallbackUrl?: string;
1029
+ Payload?: string;
975
1030
  /**
976
- * <p>透传参数不做任何处理,仅数据传输注:最多 1048576个字符</p>
1031
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
977
1032
  */
978
- Payload?: string;
1033
+ RequestId?: string;
1034
+ }
1035
+ /**
1036
+ * ProviderDetail
1037
+ */
1038
+ export interface ProviderDetail {
979
1039
  /**
980
- * <p>错峰模式,默认为:false,可选值:</p><ul><li>true:错峰生成视频;</li><li>false:即时生成视频;<br>注1:错峰模式消耗的积分更低<br>注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分</li></ul>
1040
+ * <p>供应商详情</p>
981
1041
  */
982
- OffPeak?: boolean;
1042
+ Provider?: string;
983
1043
  /**
984
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</p>
1044
+ * <p>状态</p>
985
1045
  */
986
- LogoAdd?: number;
1046
+ Status?: string;
987
1047
  /**
988
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1048
+ * <p>错误信息</p>
989
1049
  */
990
- LogoParam?: LogoParam;
1050
+ ErrorMessage?: string;
991
1051
  }
992
1052
  /**
993
- * SubmitImageToVideoGeneralJob请求参数结构体
1053
+ * SubmitMotionControlKlingJob请求参数结构体
994
1054
  */
995
- export interface SubmitImageToVideoGeneralJobRequest {
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
- Image: Image;
1059
+ Model?: string;
1004
1060
  /**
1005
- * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。
1061
+ * <p>文本提示词,可包含正向描述和负向描述</p><p>可将提示词模板化来满足不同的视频生成需求</p><p>不能超过2500个字</p>
1006
1062
  */
1007
1063
  Prompt?: string;
1008
1064
  /**
1009
- * 输出视频分辨率。可选择:480p、720p、1080p。
1065
+ *
1010
1066
  */
1011
- Resolution?: string;
1067
+ ExternalTaskId?: string;
1012
1068
  /**
1013
- * 生成视频的帧率,从16, 24, 30中选择。默认值:30
1069
+ * <p>参考图像,生成视频中的人物、背景等元素均以参考图为准 视频内容需满足以下要求: 人物比例尽量与参考动作比例一致,尽量避免全身动作驱动半身人物进行生成 人物需要露出清晰的上半身或全身的肢体及头部,避免遮挡 画面中人物避免存在极端朝向,比如倒立、平卧等。人物占画面比例不得太低 支持真实/风格化的角色(包括人物/类人动物/部分纯动物/部分类人肢体比例的角色)通过 包含支持传入图片Base64编码或图片URL(确保可访问)。</p>
1014
1070
  */
1015
- Fps?: number;
1071
+ Image?: string;
1016
1072
  /**
1017
- * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
1073
+ * <p>参考视频的获取链接。生成视频中的人物动作与参考视频一致。 视频内容需满足以下要求: 人物需要漏出清晰的上半身或全身的全部肢体及头部,避免遮挡 建议上传1人动作视频,2人及以上会取画面占比最大的人物动作进行生成 推荐使用真人动作,部分风格化的人物/类人肢体比例可以通过 动作视频一镜到底,角色始终出现在画面中,避免切镜、运镜等。否则会被截取 动作避免过快,相对平稳的动作生成效果更佳 视频文件支持.mp4/.mov,文件大小不超过100MB,仅支持长宽的边长均位于340px~3850px之间,上述校验不通过会返回错误码等信息 视频时长下限不短于3秒,时长上限与人物朝向参考(character_orientation)有关: 当人物朝向与视频中人物一致时,视频时长最长可达30秒; 当人物朝向与图片中人物一致时,视频时长最长可达10秒; 如果您的动作难度比较高、速度比较快,有一定概率生成不足上传视频时长的结果,因为模型只能提取有效动作时长进行生成,最短提取出3s可用连续动作即可生成。请注意,因此消耗的积分将无法退还,建议适当调整动作难度与速度 系统会校验视频内容,如有问题会返回错误码等信息。</p>
1018
1074
  */
1019
- LogoAdd?: number;
1075
+ Video?: string;
1020
1076
  /**
1021
- * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
1077
+ * <p>生成视频的模式</p><p>枚举值:std,pro<br>其中std:标准模式(标准),基础模式,性价比高<br>其中pro:专家模式(高品质),高表现模式,生成视频质量更佳</p>
1022
1078
  */
1023
- LogoParam?: LogoParam;
1024
- }
1025
- /**
1026
- * SubmitImageToVideoViduJob请求参数结构体
1027
- */
1028
- export interface SubmitImageToVideoViduJobRequest {
1079
+ Mode?: string;
1029
1080
  /**
1030
- * <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>
1081
+ * <p>可选择是否保留视频原声 枚举值:yes,no 其中yes:保留视频原声 其中no:不保留视频原声。</p>
1031
1082
  */
1032
- Images: Array<string>;
1083
+ KeepOriginalSound?: string;
1033
1084
  /**
1034
- * <p>模型名称,可选值,默认值viduq2-turbo</p><ul><li>viduq2-pro:新模型,效果好,细节丰富</li><li>viduq2-turbo:新模型,效果好,生成快</li><li>viduq3-turbo:对比viduq3-pro,生成速度更快</li><li>viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好</li></ul>
1085
+ * <p>生成视频中人物的朝向,可选择与图片一致或与视频一致 枚举值:image,video,其中: 其中image:与图片中人物朝向一致;此时参考视频时长不得超过10秒; 其中video:与视频中人物朝向一致;此时参考视频时长不得超过30秒; 引用主体时,生成的视频暂时只能参考视频中的人物朝向。</p>
1035
1086
  */
1036
- Model?: string;
1087
+ CharacterOrientation?: string;
1037
1088
  /**
1038
- * <p>文本提示词<br>生成视频的文本描述。<br>注1:字符长度不能超过 2000 个字符<br>注2:若使用is_rec推荐提示词参数,模型将不考虑此参数所输入的提示词</p>
1089
+ * <p>参考主体列表 基于主体库中主体的ID配置,用key:value承载,如下: &quot;element_list&quot;:[ { &quot;element_id&quot;:long }, { &quot;element_id&quot;:long } ] 参考主体数量与有无参考视频、参考图片数量有关,其中: 当使用首帧生成视频时,最多支持3个主体; 当使用首尾帧生成视频时,kling-v3-omni模型最多支持3个主体,kling-video-o1模不支持主体; 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; 无参考视频时,参考图片数量和参考主体数量之和不得超过7;</p>
1039
1090
  */
1040
- Prompt?: string;
1091
+ ElementList?: Array<Element>;
1041
1092
  /**
1042
- * <p>是否使用推荐提示词,默认关闭<br>-true:是,由系统自动推荐提示词,并使用提示词内容生成视频,推荐提示词数量=1<br>-false:否,根据输入的prompt生成视频<br>注意:启用推荐提示词后,每个任务多消耗1积分</p>
1093
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
1043
1094
  */
1044
- IsRec?: boolean;
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>音色id<br>用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:新音色列表<br>暂不支持声音复刻功能</p>
1097
+ * <p>为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。</p>
1051
1098
  */
1052
- VoiceId?: string;
1099
+ LogoAdd?: number;
1053
1100
  /**
1054
- * <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>
1101
+ * <p>默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。</p>
1055
1102
  */
1056
- Duration?: number;
1103
+ LogoParam?: LogoParam;
1104
+ }
1105
+ /**
1106
+ * SubmitVideoExtendKlingJob请求参数结构体
1107
+ */
1108
+ export interface SubmitVideoExtendKlingJobRequest {
1057
1109
  /**
1058
- * <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>
1110
+ * <p>视频ID 支持通过文本、图片和视频延长生成的视频的ID(原视频不能超过3分钟) 请注意,基于目前的清理策略、视频生成30天之后会被清理,则无法进行延长</p>
1059
1111
  */
1060
- Resolution?: string;
1112
+ VideoId: string;
1061
1113
  /**
1062
- * <p>运动幅度<br>默认 auto,可选值:auto、small、medium、large<br>注:q2、q3系列模型改参数不生效</p>
1114
+ * <p>正向文本提示词 不能超过2500个字符</p>
1063
1115
  */
1064
- MovementAmplitude?: string;
1116
+ Prompt?: string;
1065
1117
  /**
1066
- * <p>bgm</p>
1118
+ * <p>负向文本提示词 不能超过2500个字符</p>
1067
1119
  */
1068
- Bgm?: boolean;
1120
+ NegativePrompt?: string;
1069
1121
  /**
1070
- * <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>
1122
+ *
1071
1123
  */
1072
- AudioType?: string;
1124
+ ExternalTaskId?: string;
1073
1125
  /**
1074
- * <p>元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下:<br>{<br>&quot;Label&quot;: &quot;your_label&quot;,<br>&quot;ContentProducer&quot;: &quot;your_content_producer&quot;,<br>&quot;ContentPropagator&quot;: &quot;your_content_propagator&quot;,<br>&quot;ProduceID&quot;: &quot;your_product_id&quot;,<br>&quot;PropagateID&quot;: &quot;your_propagate_id&quot;,<br>&quot;ReservedCode1&quot;: &quot;your_reserved_code1&quot;,<br>&quot;ReservedCode2&quot;: &quot;your_reserved_code2&quot;<br>}<br>该参数为空时,默认使用vidu生成的元数据标识</p>
1126
+ * <p>提示词参考强度 取值范围:[0,1],数值越大参考强度越大</p>
1075
1127
  */
1076
- MetaData?: string;
1128
+ CfgScale?: number;
1077
1129
  /**
1078
- * <p>Callback 协议<br>需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成完成时,将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致<br>回调返回的&quot;status&quot;包括以下状态:</p><ul><li>success 任务完成(如发送失败,回调三次)</li><li>failed 任务失败(如发送失败,回调三次)</li></ul>
1130
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
1079
1131
  */
1080
1132
  CallbackUrl?: string;
1081
1133
  /**
1082
- * <p>透传参数<br>不做任何处理,仅数据传输<br>注:最多 1048576个字符</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>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
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
- * DescribeHumanActorJob请求参数结构体
1143
+ * SubmitTemplateToVideoJob返回参数结构体
1100
1144
  */
1101
- export interface DescribeHumanActorJobRequest {
1145
+ export interface SubmitTemplateToVideoJobResponse {
1102
1146
  /**
1103
- * 任务ID
1147
+ * <p>任务ID。</p>
1104
1148
  */
1105
- JobId: string;
1106
- }
1107
- /**
1108
- * DescribeImageToVideoGeneralJob请求参数结构体
1109
- */
1110
- export interface DescribeImageToVideoGeneralJobRequest {
1149
+ JobId?: string;
1111
1150
  /**
1112
- * 任务ID
1151
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1113
1152
  */
1114
- JobId: string;
1153
+ RequestId?: string;
1115
1154
  }
1116
1155
  /**
1117
- * SubmitAigcVideoJob返回参数结构体
1156
+ * SubmitHumanActorJob返回参数结构体
1118
1157
  */
1119
- export interface SubmitAigcVideoJobResponse {
1158
+ export interface SubmitHumanActorJobResponse {
1120
1159
  /**
1121
- * <p>任务ID。</p>
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
- * SubmitVideoVoiceJob返回参数结构体
1169
+ * DescribeVideoExtendKlingJob返回参数结构体
1131
1170
  */
1132
- export interface SubmitVideoVoiceJobResponse {
1171
+ export interface DescribeVideoExtendKlingJobResponse {
1133
1172
  /**
1134
- * 任务ID。
1173
+ * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1135
1174
  */
1136
- JobId?: string;
1175
+ Status?: string;
1176
+ /**
1177
+ * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1178
+ */
1179
+ ErrorCode?: string;
1180
+ /**
1181
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</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 DeleteAigcElementRequest {
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
- * SubmitImageToVideoViduJob返回参数结构体
1223
+ * SubmitPortraitSingJob请求参数结构体
1153
1224
  */
1154
- export interface SubmitImageToVideoViduJobResponse {
1225
+ export interface SubmitPortraitSingJobRequest {
1155
1226
  /**
1156
- * <p>任务ID。</p>
1227
+ * 传入音频URL地址,音频要求:
1228
+ - 音频时长:2秒 - 60秒
1229
+ - 音频格式:mp3、wav、m4a
1157
1230
  */
1158
- JobId?: string;
1231
+ AudioUrl: string;
1159
1232
  /**
1160
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1233
+ * 传入图片URL地址,图片要求:
1234
+ - 图片格式:jpg、jpeg、png、bmp、webp
1235
+ - 图片分辨率:192~4096
1236
+ - 图片大小:不超过10M
1237
+ - 图片宽高比:图片【宽:高】在1:2到2:1范围内
1238
+ - 图片内容:避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
1161
1239
  */
1162
- RequestId?: string;
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
- * SubmitPortraitSingJob返回参数结构体
1274
+ * 水印图输入框
1166
1275
  */
1167
- export interface SubmitPortraitSingJobResponse {
1276
+ export interface LogoRect {
1168
1277
  /**
1169
- * 任务ID。任务有效期为48小时。
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
- * CreateAigcElement返回参数结构体
1321
+ * DescribeVideoEditKlingJob请求参数结构体
1179
1322
  */
1180
- export interface CreateAigcElementResponse {
1323
+ export interface DescribeVideoEditKlingJobRequest {
1181
1324
  /**
1182
- * <p>任务ID。</p>
1325
+ * <p>任务ID</p>
1183
1326
  */
1184
1327
  JobId?: string;
1185
1328
  /**
1186
- * <p>主体Id</p>
1187
- */
1188
- ElementId?: string;
1189
- /**
1190
- * <p>任务状态</p><p>默认值:任务状态</p>
1329
+ *
1191
1330
  */
1192
- Status?: string;
1331
+ ExternalTaskId?: string;
1332
+ }
1333
+ /**
1334
+ * SubmitVideoEditKlingJob返回参数结构体
1335
+ */
1336
+ export interface SubmitVideoEditKlingJobResponse {
1193
1337
  /**
1194
- * <p>厂商</p>
1338
+ * <p>任务ID</p>
1195
1339
  */
1196
- Provider?: Array<string>;
1340
+ JobId?: string;
1197
1341
  /**
1198
- * <p>任务创建时间</p>
1342
+ *
1199
1343
  */
1200
- CreatedAt?: string;
1344
+ ExternalTaskId?: string;
1201
1345
  /**
1202
1346
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1203
1347
  */
1204
1348
  RequestId?: string;
1205
1349
  }
1206
1350
  /**
1207
- * DescribeImageToVideoJob返回参数结构体
1351
+ * DescribeTextToVideoJob返回参数结构体
1208
1352
  */
1209
- export interface DescribeImageToVideoJobResponse {
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
- * DescribePortraitSingJob请求参数结构体
1392
+ * SubmitHunyuanToVideoJob返回参数结构体
1249
1393
  */
1250
- export interface DescribePortraitSingJobRequest {
1394
+ export interface SubmitHunyuanToVideoJobResponse {
1251
1395
  /**
1252
1396
  * 任务ID
1253
1397
  */
1254
- JobId: string;
1255
- }
1256
- /**
1257
- * DescribeHunyuanToVideoJob请求参数结构体
1258
- */
1259
- export interface DescribeHunyuanToVideoJobRequest {
1398
+ JobId?: string;
1260
1399
  /**
1261
- * 任务ID
1400
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1262
1401
  */
1263
- JobId: string;
1402
+ RequestId?: string;
1264
1403
  }
1265
1404
  /**
1266
- * SubmitTextToVideoViduJob返回参数结构体
1405
+ * DescribeHumanActorJob返回参数结构体
1267
1406
  */
1268
- export interface SubmitTextToVideoViduJobResponse {
1407
+ export interface DescribeHumanActorJobResponse {
1269
1408
  /**
1270
- * <p>任务ID。</p>
1271
- */
1272
- JobId?: string;
1273
- /**
1274
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1409
+ * 任务状态。 WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1275
1410
  */
1276
- RequestId?: string;
1277
- }
1278
- /**
1279
- * CheckAnimateImageJob返回参数结构体
1280
- */
1281
- export interface CheckAnimateImageJobResponse {
1411
+ Status?: string;
1282
1412
  /**
1283
- * 输入图是否通过校验。
1413
+ * 结果视频URL。有效期 24 小时。
1284
1414
  */
1285
- CheckPass?: boolean;
1415
+ ResultVideoUrl?: string;
1286
1416
  /**
1287
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId
1417
+ * 任务执行错误码。当任务状态不为 FAIL 时,该值为""
1288
1418
  */
1289
- RequestId?: string;
1290
- }
1291
- /**
1292
- * SubmitVideoEditJob返回参数结构体
1293
- */
1294
- export interface SubmitVideoEditJobResponse {
1419
+ ErrorCode?: string;
1295
1420
  /**
1296
- * <p>任务ID。</p>
1421
+ * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1297
1422
  */
1298
- JobId?: string;
1423
+ ErrorMessage?: string;
1299
1424
  /**
1300
1425
  * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1301
1426
  */
1302
1427
  RequestId?: string;
1303
1428
  }
1304
1429
  /**
1305
- * DescribeVideoStylizationJob请求参数结构体
1430
+ * 扩展字段。
1306
1431
  */
1307
- export interface DescribeVideoStylizationJobRequest {
1432
+ export interface ExtraParam {
1308
1433
  /**
1309
- * 任务ID
1434
+ * <p>预签名的上传url,支持把视频直接传到客户指定的地址。</p>
1310
1435
  */
1311
- JobId: string;
1312
- }
1313
- /**
1314
- * SubmitHumanActorJob返回参数结构体
1315
- */
1316
- export interface SubmitHumanActorJobResponse {
1436
+ UserDesignatedUrl?: string;
1317
1437
  /**
1318
- * 任务ID。
1438
+ * <p>回调地址<br>需要您在创建任务时主动设置 CallbackUrl,请求方法为 POST,当视频生成结束时,我们将向此地址发送生成结果。<br>数据格式如下:<br>{<br> &quot;JobId&quot;: &quot;1397428070633955328&quot;,<br> &quot;Status&quot;: &quot;DONE&quot;,<br> &quot;ErrorCode&quot;: &quot;&quot;,<br> &quot;ErrorMessage&quot;: &quot;&quot;,<br> &quot;ResultVideoUrl&quot;: &quot;https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4&quot;<br>}</p>
1319
1439
  */
1320
- JobId?: string;
1440
+ CallbackUrl?: string;
1321
1441
  /**
1322
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1442
+ * <p>BGM音频文本。</p>
1323
1443
  */
1324
- RequestId?: string;
1444
+ BGMText?: string;
1325
1445
  }
1326
1446
  /**
1327
- * 视频编辑参数
1447
+ * SubmitTextToVideoJob请求参数结构体
1328
1448
  */
1329
- export interface VideoEditParam {
1449
+ export interface SubmitTextToVideoJobRequest {
1330
1450
  /**
1331
- * 魔法词,针对特定场景生效。不同场景传不同的值。默认不传。
1332
- - 换人场景:1
1451
+ * <p>正向文本提示词。不能超过2500个字符</p>
1333
1452
  */
1334
- Magic?: string;
1335
- }
1336
- /**
1337
- * 参考主体,主要用作参考图生视频。由主体id、主体图(三视图)以及声音组成。
1338
- */
1339
- export interface ReferenceSubject {
1453
+ Prompt?: string;
1340
1454
  /**
1341
- * <p>主体id,后续生成时在提示词中可以通过@主体id的方式使用。</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
- Id: string;
1457
+ Model?: string;
1344
1458
  /**
1345
- * <p>该主体对应的图片url,每个主体最多支持3张图片<br>注1:支持传入图片URL(确保可访问)<br>注2:图片支持 png、jpeg、jpg、webp格式<br>注3:图片像素不能小于 128*128,且比例需要小于1:4或者4:1,且大小不超过50M。</p>
1459
+ * <p>负向文本提示词。不能超过2500个字符</p>
1346
1460
  */
1347
- Images: Array<string>;
1461
+ NegativePrompt?: string;
1348
1462
  /**
1349
- * <p>主体id,后续生成时可以通过@主体id的方式使用</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
- Name?: string;
1465
+ Duration?: string;
1352
1466
  /**
1353
- * <p>主体视频,该主体对应的视频url,与videos必填一个<br>注1: 仅viduq2-pro模型支持使用视频主体<br>注2:每个主体中的图片和视频,共享3个槽位<br>注3:支持1个5秒视频<br>注4:支持传入视频 URL(确保可访问)<br>注5:视频支持 mp4avimov格式<br>注6:视频像素不能小于 128*128,且比例需要小于1:4或者4:1<br>注7:请注意,base64 decode之后的字节长度需要小于20M,且编码必须包含适当的内容类型字符串</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.0v2.1mv3.0:模型无需配置。<br>●v2.5:首尾帧情况下支持pro。<br>●v2.6:仅支持pro,选择v2.6模型时,默认自动生成高品质pro视频。</p>
1354
1468
  */
1355
- Videos?: Array<string>;
1469
+ Mode?: string;
1356
1470
  /**
1357
- * <p>音色ID用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:[音色列表](URL https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg)</p>
1471
+ * <p>生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强。<br>取值范围:[0, 1]<br>v2.0、v2.5、v2.6 模型不支持当前参数<br>默认值:0.5。</p>
1358
1472
  */
1359
- VoiceId?: string;
1360
- }
1361
- /**
1362
- * 生成视频时所引用的音色
1363
- */
1364
- export interface ReferImageItem {
1473
+ CfgScale?: number;
1365
1474
  /**
1366
- * <p>图片地址</p>
1475
+ * <p>生成视频的画面纵横比(宽:高)<br>枚举值:16:9, 9:16, 1:1<br>默认值:16:9</p>
1367
1476
  */
1368
- ImageUrl?: string;
1369
- }
1370
- /**
1371
- * 参考图列表
1372
- */
1373
- export interface ImageInfo {
1477
+ AspectRatio?: string;
1374
1478
  /**
1375
- * 图片URL
1479
+ * <p>生成视频时是否同时生成声音</p><ul><li>枚举值:on,off</li></ul><p>仅V2.6及后续版本模型支持当前参数,v2.6模型的std模式只能生成无声的视频</p>
1376
1480
  */
1377
- ImageUrl: string;
1481
+ Sound?: string;
1378
1482
  /**
1379
- * 首帧:first_frame
1380
- 尾帧:end_frame
1381
- 其他:空
1382
-
1483
+ * <p>为生成视频添加标识的开关,默认为1。<br>1:添加标识。<br>0:不添加标识。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示,该视频是 AI 生成的视频。</p>
1383
1484
  */
1384
- Type?: string;
1385
- }
1386
- /**
1387
- * 图片
1388
- */
1389
- export interface Image {
1485
+ LogoAdd?: number;
1390
1486
  /**
1391
- * 图片Base64
1487
+ * <p>标识内容设置。<br>默认在生成视频的右下角添加“视频由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1392
1488
  */
1393
- Base64?: string;
1489
+ LogoParam?: LogoParam;
1394
1490
  /**
1395
- * 图片Url
1491
+ * <p>是否生成多镜头视频</p><ul><li>当前参数为true时,prompt参数无效</li><li>当前参数为false时,shot_type参数及multi_prompt参数无效</li></ul>
1396
1492
  */
1397
- Url?: string;
1398
- }
1399
- /**
1400
- * DescribeMotionControlKlingJob返回参数结构体
1401
- */
1402
- export interface DescribeMotionControlKlingJobResponse {
1493
+ MultiShot?: boolean;
1403
1494
  /**
1404
- * <p>任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功</p>
1495
+ * <p>分镜方式</p><p>枚举值:customize,intelligence<br>当MultiShot参数为true时,当前参数必填</p>
1405
1496
  */
1406
- Status?: string;
1497
+ ShotType?: string;
1407
1498
  /**
1408
- * <p>任务执行错误码。当任务状态不为 FAIL 时,该值为&quot;&quot;。</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> &quot;MultiPrompt&quot;:[ { &quot;Index&quot;:int, &quot;Prompt&quot;: &quot;string&quot;, &quot;Duration&quot;: &quot;5&quot; } ]</code></pre></li></ul>
1409
1500
  */
1410
- ErrorCode?: string;
1501
+ MultiPrompt?: Array<MultiPrompt>;
1411
1502
  /**
1412
- * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1503
+ * <p>控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)</p>
1413
1504
  */
1414
- ErrorMessage?: string;
1505
+ CameraControl?: CameraControl;
1415
1506
  /**
1416
- * <p>结果视频 URL。有效期 24 小时。</p>
1507
+ * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
1417
1508
  */
1418
- ResultVideoUrl?: string;
1509
+ CallbackUrl?: string;
1419
1510
  /**
1420
- * <p>视频时长。</p>
1511
+ *
1421
1512
  */
1422
- Duration?: string;
1513
+ ExternalTaskId?: string;
1514
+ }
1515
+ /**
1516
+ * 生成视频时所引用的音色
1517
+ */
1518
+ export interface Voice {
1423
1519
  /**
1424
- * <p>消耗积分数。</p>
1520
+ * <p>音色id</p>
1425
1521
  */
1426
- FinalUnitDeduction?: string;
1522
+ VoiceId?: string;
1523
+ }
1524
+ /**
1525
+ * Element
1526
+ */
1527
+ export interface Element {
1427
1528
  /**
1428
- * <p>视频id</p>
1529
+ * <p>ID配置</p>
1429
1530
  */
1430
- VideoId?: string;
1531
+ ElementId?: string;
1532
+ }
1533
+ /**
1534
+ * DescribeReferenceToVideoViduJob请求参数结构体
1535
+ */
1536
+ export interface DescribeReferenceToVideoViduJobRequest {
1431
1537
  /**
1432
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1538
+ * <p>任务ID</p>
1433
1539
  */
1434
- RequestId?: string;
1540
+ JobId: string;
1435
1541
  }
1436
1542
  /**
1437
- * 参考视频信息
1543
+ * SubmitVideoFaceFusionJob请求参数结构体
1438
1544
  */
1439
- export interface ReferVideoInfo {
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
- feature为特征参考视频
1447
- base为待编辑视频
1554
+ * 视频素材模板的人脸位置信息。
1555
+ 目前最多支持融合视频素材中的 6 张人脸
1556
+ 输入图片要求:
1557
+ 1、用户图限制大小不超过 10MB
1558
+ 2、图片最大分辨率不超过 4k,建议最小为 128, 人脸框最小为 68
1559
+ 3、支持格式 jpg,png
1560
+ 4、如果用户图中未指定人脸且有多张人脸, 默认融合最大人脸
1561
+ 输入图片建议: 包含上述视频中出现的人物的单人照,并且正面、清晰、无遮挡
1448
1562
  */
1449
- ReferType?: string;
1563
+ TemplateInfos?: Array<FaceTemplateInfo>;
1450
1564
  /**
1451
- * 否保留视频原声,yes为保留,no为不保留;
1452
- 当前参数对特征参考视频(feature)也生效。
1565
+ * 用户人脸图片位置信息。
1566
+ 输入图片要求:
1567
+ 1、用户图限制大小不超过 10MB
1568
+ 2、图片最大分辨率不超过 4k,建议最小为 128,人脸框最小为 68
1569
+ 3、支持格式 jpg,png
1570
+ 4、如果未指定人脸且用户图中有多张人脸,
1571
+ 默认融合最大人脸
1572
+ 输入图建议:
1573
+ 正脸无遮挡
1453
1574
  */
1454
- KeepOriginalSound?: string;
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
- * SubmitAigcVideoJob请求参数结构体
1590
+ * CreateAigcElement请求参数结构体
1458
1591
  */
1459
- export interface SubmitAigcVideoJobRequest {
1592
+ export interface CreateAigcElementRequest {
1460
1593
  /**
1461
- * <p>模型名称。</p><p>枚举值:</p><p>● Vidu;</p><p>● Kling:可灵;</p><p>● HY:混元;</p><p>● YT:优图;</p><p>示例值:Vidu</p>
1594
+ * <p>主体名称<br>不能超过20个字符</p>
1462
1595
  */
1463
- Vendor: string;
1596
+ Name: string;
1464
1597
  /**
1465
- * <p>模型版本。</p><p>枚举值:</p><p>● 当Vendor为Vidu时,可选值[q2, q2-pro, q2-turbo, q3-pro, q3-turbo]</p><p>● 当Vendor为Kling时,可选值[v1.6, v2.0, v2.1, v2.5, v2.6]</p><p>● 当Vendor为HY时,默认值:[v1.5]</p><p>● 当Vendor为YT时,默认值:[v2.0]</p>
1598
+ * <p>主体描述</p><p>不能超过100个字符</p>
1466
1599
  */
1467
- Model: string;
1600
+ Description: string;
1468
1601
  /**
1469
- * <p>模型参数Json-Format字符串<br> <a href="https://cloud.tencent.com/document/product/1616/128996">模型参数列表</a></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
- ModelParam?: string;
1604
+ ReferenceType?: string;
1472
1605
  /**
1473
- * <p>正向文本提示词。不能超过2000个字符</p><p>示例值:一只小猫在草地奔跑</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
- Prompt?: string;
1608
+ ElementImageList?: ElementImageList;
1476
1609
  /**
1477
- * <p>为生成结果图添加显式水印标识的开关,默认为1。<br>1:添加。<br>0:不添加。<br>其他数值:默认按1处理。<br>建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。<br>示例值:1</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
- LogoAdd?: number;
1612
+ VideoList?: Array<string>;
1480
1613
  /**
1481
- * <p>标识内容设置。<br>默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。</p>
1614
+ * <p>厂商</p>
1482
1615
  */
1483
- LogoParam?: LogoParam;
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
- * SubmitReferenceToVideoViduJob返回参数结构体
1627
+ * SubmitPortraitSingJob返回参数结构体
1487
1628
  */
1488
- export interface SubmitReferenceToVideoViduJobResponse {
1629
+ export interface SubmitPortraitSingJobResponse {
1489
1630
  /**
1490
- * <p>任务ID。</p>
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
- * logo参数
1640
+ * SubmitTemplateToVideoJob请求参数结构体
1500
1641
  */
1501
- export interface LogoParam {
1642
+ export interface SubmitTemplateToVideoJobRequest {
1502
1643
  /**
1503
- * 水印 Url
1644
+ * <p>特效模板名称。请在 <a href="https://cloud.tencent.com/document/product/1616/119194">视频特效模板列表</a> 中选择想要生成的特效对应的 template 名称。</p>
1504
1645
  */
1505
- LogoUrl?: string;
1646
+ Template: string;
1506
1647
  /**
1507
- * 水印 Base64,Url Base64 二选一传入,如果都提供以 Url 为准
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
- LogoImage?: string;
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
- JobId?: string;
1662
+ Resolution?: string;
1648
1663
  /**
1649
- *
1664
+ * <p>是否为生成的视频添加背景音乐。默认:false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加;不传或为 false 则不添加 BGM。</p>
1650
1665
  */
1651
- ExternalTaskId?: string;
1666
+ BGM?: boolean;
1652
1667
  /**
1653
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1668
+ * <p>扩展字段。</p>
1654
1669
  */
1655
- RequestId?: string;
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 CameraControlConfig {
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
- * 旋转运镜,控制摄像机的滚动量(绕z轴旋转)
1687
-
1688
- 取值范围:[-10, 10],负值表示绕z轴逆时针旋转,正值表示绕z轴顺时针旋转
1703
+ * <p>分镜序号</p>
1689
1704
  */
1690
- Roll?: number;
1705
+ Index?: number;
1691
1706
  /**
1692
- * 变焦,控制摄像机的焦距变化,影响视野的远近
1693
-
1694
- 取值范围:[-10, 10],负值表示焦距变长、视野范围变小,正值表示焦距变短、视野范围变大
1707
+ * <p>分镜提示词</p>
1695
1708
  */
1696
- Zoom?: number;
1697
- }
1698
- /**
1699
- * DescribeReferenceToVideoViduJob请求参数结构体
1700
- */
1701
- export interface DescribeReferenceToVideoViduJobRequest {
1709
+ Prompt?: string;
1702
1710
  /**
1703
- * <p>任务ID</p>
1711
+ * <p>时长</p>
1704
1712
  */
1705
- JobId: string;
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
- * ProviderDetail
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 DescribeImageAnimateJobResponse {
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
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
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
- RequestId?: string;
1765
- }
1766
- /**
1767
- * DescribeAigcVideoJob返回参数结构体
1768
- */
1769
- export interface DescribeAigcVideoJobResponse {
1739
+ Image: Image;
1770
1740
  /**
1771
- * 任务状态。WAIT:等待中,RUN:执行中,FAIL:任务失败,DONE:任务成功
1772
- 示例值:RUN
1741
+ * 视频内容的描述,中文正向提示词。最多支持200个 utf-8 字符(首尾空格不计入字符数)。
1773
1742
  */
1774
- Status?: string;
1743
+ Prompt?: string;
1775
1744
  /**
1776
- * 任务执行错误码。当任务状态不为 FAIL 时,该值为""
1777
- 示例值:FailedOperation.DriverFailed
1745
+ * 输出视频分辨率。可选择:480p、720p、1080p
1778
1746
  */
1779
- ErrorCode?: string;
1747
+ Resolution?: string;
1780
1748
  /**
1781
- * 任务执行错误信息。当任务状态不为 FAIL 时,该值为""。
1782
- 示例值:驱动失败
1749
+ * 生成视频的帧率,从16, 24, 30中选择。默认值:30
1783
1750
  */
1784
- ErrorMessage?: string;
1751
+ Fps?: number;
1785
1752
  /**
1786
- * 结果视频 URL。有效期 24 小时。
1787
-
1788
- 示例值:https://console.cloud.tencent.com/result.mp4
1753
+ * 为生成视频添加标识的开关,默认为1,0 需前往 控制台 申请开启显示标识自主完成方可生效。 1:添加标识; 0:不添加标识; 其他数值:默认按1处理。
1789
1754
  */
1790
- ResultUrl?: string;
1755
+ LogoAdd?: number;
1791
1756
  /**
1792
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1757
+ * 默认在生成视频的右下角添加“ AI 生成”字样,如需替换为其他的标识图片,需前往 控制台 申请开启显示标识自主完成。
1793
1758
  */
1794
- RequestId?: string;
1759
+ LogoParam?: LogoParam;
1795
1760
  }
1796
1761
  /**
1797
- * SubmitVideoExtendKlingJob返回参数结构体
1798
- */
1799
- export interface SubmitVideoExtendKlingJobResponse {
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 时,该值为&quot;&quot;。</p>
2119
- */
2120
- ErrorCode?: string;
2121
- /**
2122
- * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</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 时,该值为&quot;&quot;。</p>
2284
- */
2285
- ErrorCode?: string;
2286
- /**
2287
- * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
2288
- */
2289
- ErrorMessage?: string;
2290
- /**
2291
- * <p>结果视频 URL。有效期 24 小时。</p>
2292
- */
2293
- ResultVideoUrl?: string;
2294
- /**
2295
- * <p>视频时长。</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> &quot;MultiPrompt&quot;:[ { &quot;Index&quot;:int, &quot;Prompt&quot;: &quot;string&quot;, &quot;Duration&quot;: &quot;5&quot; } ]</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
- * <p>本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知</p>
1766
+ * 图片URL
2459
1767
  */
2460
- CallbackUrl?: string;
1768
+ ImageUrl: string;
2461
1769
  /**
2462
- *
1770
+ * 首帧:first_frame
1771
+ 尾帧:end_frame
1772
+ 其他:空
1773
+
2463
1774
  */
2464
- ExternalTaskId?: string;
1775
+ Type?: string;
2465
1776
  }
2466
1777
  /**
2467
- * DescribeVideoStylizationJob返回参数结构体
1778
+ * 参考主体,主要用作参考图生视频。由主体id、主体图(三视图)以及声音组成。
2468
1779
  */
2469
- export interface DescribeVideoStylizationJobResponse {
1780
+ export interface ReferenceSubject {
2470
1781
  /**
2471
- * 任务ID。
1782
+ * <p>主体id,后续生成时在提示词中可以通过@主体id的方式使用。</p>
2472
1783
  */
2473
- JobId?: string;
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
- StatusCode?: string;
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
- StatusMsg?: string;
1792
+ Name?: string;
2492
1793
  /**
2493
- * 处理结果视频Url。URL有效期为24小时。
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
- ResultVideoUrl?: string;
1796
+ Videos?: Array<string>;
2496
1797
  /**
2497
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1798
+ * <p>音色ID用来决定视频中的声音音色,为空时系统会自动推荐,可选枚举值参考列表:[音色列表](URL https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg)</p>
2498
1799
  */
2499
- RequestId?: string;
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
- * DescribeVideoEditJob请求参数结构体
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 时,该值为&quot;&quot;。</p>
1867
+ */
1868
+ ErrorCode?: string;
1869
+ /**
1870
+ * <p>任务执行错误信息。当任务状态不为 FAIL 时,该值为&quot;&quot;。</p>
1871
+ */
1872
+ ErrorMessage?: string;
1873
+ /**
1874
+ * <p>结果视频 URL。有效期 24 小时。</p>
1875
+ */
1876
+ ResultVideoUrl?: string;
1877
+ /**
1878
+ * <p>视频时长。</p>
1879
+ */
1880
+ 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 DescribeVideoEditJobRequest {
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 FaceRect {
1952
+ export interface ReferVideoInfo {
2580
1953
  /**
2581
- * <p>人脸框左上角横坐标。</p>
1954
+ * 视频地址
2582
1955
  */
2583
- X?: number;
1956
+ VideoUrl?: string;
2584
1957
  /**
2585
- * <p>人脸框左上角纵坐标。</p>
1958
+ * 视频类型
1959
+ feature为特征参考视频
1960
+ base为待编辑视频
2586
1961
  */
2587
- Y?: number;
1962
+ ReferType?: string;
2588
1963
  /**
2589
- * <p>人脸框宽度。<br>单位:px</p>
1964
+ * 否保留视频原声,yes为保留,no为不保留;
1965
+ 当前参数对特征参考视频(feature)也生效。
2590
1966
  */
2591
- Width?: number;
1967
+ KeepOriginalSound?: string;
1968
+ }
1969
+ /**
1970
+ * DescribeTemplateToVideoJob请求参数结构体
1971
+ */
1972
+ export interface DescribeTemplateToVideoJobRequest {
2592
1973
  /**
2593
- * <p>人脸框高度。<br>单位:px</p>
1974
+ * 任务ID。
2594
1975
  */
2595
- Height?: number;
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
+ }