tencentcloud-sdk-nodejs-vclm 4.1.135 → 4.1.147

package/es/services/vclm/v20240523/vclm_client.js

@@ -15,6 +15,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async DescribePortraitSingJob(req, cb) {
         return this.request("DescribePortraitSingJob", req, cb);
     }
+    async SubmitHumanActorJob(req, cb) {
+        return this.request("SubmitHumanActorJob", req, cb);
+    }
     async DescribeImageAnimateJob(req, cb) {
         return this.request("DescribeImageAnimateJob", req, cb);
     }
@@ -36,4 +39,7 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async DescribeImageToVideoGeneralJob(req, cb) {
         return this.request("DescribeImageToVideoGeneralJob", req, cb);
     }
+    async DescribeHumanActorJob(req, cb) {
+        return this.request("DescribeHumanActorJob", req, cb);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-vclm",
-  "version": "4.1.135",
+  "version": "4.1.147",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/services/vclm/v20240523/vclm_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { DescribeImageToVideoGeneralJobResponse, SubmitVideoStylizationJobRequest, SubmitImageAnimateJobRequest, SubmitPortraitSingJobResponse, DescribePortraitSingJobRequest, SubmitImageToVideoGeneralJobResponse, SubmitImageAnimateJobResponse, DescribeTemplateToVideoJobResponse, CheckAnimateImageJobResponse, SubmitTemplateToVideoJobResponse, CheckAnimateImageJobRequest, DescribeVideoStylizationJobRequest, DescribeImageAnimateJobResponse, SubmitPortraitSingJobRequest, DescribeVideoStylizationJobResponse, SubmitVideoStylizationJobResponse, SubmitTemplateToVideoJobRequest, SubmitImageToVideoGeneralJobRequest, DescribeImageToVideoGeneralJobRequest, DescribeTemplateToVideoJobRequest, DescribeImageAnimateJobRequest, DescribePortraitSingJobResponse } from "./vclm_models";
+import { DescribeImageToVideoGeneralJobResponse, SubmitVideoStylizationJobRequest, SubmitHumanActorJobRequest, SubmitImageAnimateJobRequest, SubmitImageToVideoGeneralJobResponse, DescribePortraitSingJobRequest, SubmitImageAnimateJobResponse, DescribeTemplateToVideoJobResponse, CheckAnimateImageJobResponse, SubmitTemplateToVideoJobResponse, CheckAnimateImageJobRequest, DescribeVideoStylizationJobRequest, SubmitHumanActorJobResponse, DescribeImageAnimateJobResponse, SubmitPortraitSingJobRequest, DescribeHumanActorJobResponse, DescribeVideoStylizationJobResponse, SubmitVideoStylizationJobResponse, SubmitPortraitSingJobResponse, SubmitTemplateToVideoJobRequest, SubmitImageToVideoGeneralJobRequest, DescribeHumanActorJobRequest, DescribeImageToVideoGeneralJobRequest, DescribeTemplateToVideoJobRequest, DescribeImageAnimateJobRequest, DescribePortraitSingJobResponse } from "./vclm_models";
 /**
  * vclm client
  * @class
@@ -24,6 +24,11 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   支持提交音频和图片生成唱演视频，满足社交娱乐、互动营销等场景的需求。
        */
     DescribePortraitSingJob(req: DescribePortraitSingJobRequest, cb?: (error: string, rep: DescribePortraitSingJobResponse) => void): Promise<DescribePortraitSingJobResponse>;
+    /**
+       * 用于提交人像驱动任务
+  支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。
+       */
+    SubmitHumanActorJob(req: SubmitHumanActorJobRequest, cb?: (error: string, rep: SubmitHumanActorJobResponse) => void): Promise<SubmitHumanActorJobResponse>;
     /**
      * 用于查询图片跳舞任务。图片跳舞能力支持舞蹈动作结合图片生成跳舞视频，满足社交娱乐、互动营销等场景的需求。
      */
@@ -52,4 +57,8 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      * 查询图生视频通用能力任务接口
      */
     DescribeImageToVideoGeneralJob(req: DescribeImageToVideoGeneralJobRequest, cb?: (error: string, rep: DescribeImageToVideoGeneralJobResponse) => void): Promise<DescribeImageToVideoGeneralJobResponse>;
+    /**
+     * 通过JobId提交请求，获取人像驱动任务的结果信息。
+     */
+    DescribeHumanActorJob(req: DescribeHumanActorJobRequest, cb?: (error: string, rep: DescribeHumanActorJobResponse) => void): Promise<DescribeHumanActorJobResponse>;
 }

package/tencentcloud/services/vclm/v20240523/vclm_client.js

@@ -54,6 +54,13 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribePortraitSingJob(req, cb) {
         return this.request("DescribePortraitSingJob", req, cb);
     }
+    /**
+       * 用于提交人像驱动任务
+  支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。
+       */
+    async SubmitHumanActorJob(req, cb) {
+        return this.request("SubmitHumanActorJob", req, cb);
+    }
     /**
      * 用于查询图片跳舞任务。图片跳舞能力支持舞蹈动作结合图片生成跳舞视频，满足社交娱乐、互动营销等场景的需求。
      */
@@ -96,5 +103,11 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeImageToVideoGeneralJob(req, cb) {
         return this.request("DescribeImageToVideoGeneralJob", req, cb);
     }
+    /**
+     * 通过JobId提交请求，获取人像驱动任务的结果信息。
+     */
+    async DescribeHumanActorJob(req, cb) {
+        return this.request("DescribeHumanActorJob", req, cb);
+    }
 }
 exports.Client = Client;

package/tencentcloud/services/vclm/v20240523/vclm_models.d.ts

@@ -70,6 +70,61 @@ export interface LogoParam {
      */
     LogoRect?: LogoRect;
 }
+/**
+ * SubmitHumanActorJob请求参数结构体
+ */
+export interface SubmitHumanActorJobRequest {
+    /**
+     * 文本提示词，不能超过5000字符。
+  提示词支持全局和局部控制：
+  
+  - 全局控制：正常输入提示词即可
+  - 局部控制：可用双井号进行特定时间的提示词约束，例如： "画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容。镜头保持固定。#3#画面中的人物正在对着镜头讲话，同时做出单手做向左方引导的手势。镜头保持固定。"（意思是第三秒的时候让人物做出左方引导手势）
+   -- 局部控制时间建议整数，最大可读小数点后两位。
+     */
+    Prompt: string;
+    /**
+     * 传入音频URL地址，音频要求：
+  - 音频时长：2秒 - 60秒
+  - 音频格式：mp3、wav
+  - 音频大小：10M以内
+     */
+    AudioUrl: string;
+    /**
+     * 传入图片URL地址，图片要求：
+  - 图片格式：jpg、jpeg、png、bmp、webp
+  - 图片分辨率：192～4096
+  - 图片大小：不超过10M
+  - 图片宽高比：图片【宽：高】在1:4到4:1范围内
+  - 图片内容：避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
+     */
+    ImageUrl?: string;
+    /**
+     * 传入图片Base64编码，编码后请求体大小不超过10M。
+  图片Base64编码与URL地址必传其一，如果都传以ImageUrl为准。
+     */
+    ImageBase64?: string;
+    /**
+     * 生成视频分辨率
+  枚举值：720p，1080p
+  默认1080p
+     */
+    Resolution?: string;
+    /**
+     * 生成视频帧数，单位fps。
+  枚举值：25，50
+  默认50帧
+     */
+    FrameRate?: number;
+    /**
+     * 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。
+     */
+    LogoAdd?: number;
+    /**
+     * 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+     */
+    LogoParam?: LogoParam;
+}
 /**
  * SubmitImageAnimateJob请求参数结构体
  */
@@ -133,11 +188,11 @@ export interface SubmitImageAnimateJobRequest {
     EnableFace?: boolean;
 }
 /**
- * SubmitPortraitSingJob返回参数结构体
+ * SubmitImageToVideoGeneralJob返回参数结构体
  */
-export interface SubmitPortraitSingJobResponse {
+export interface SubmitImageToVideoGeneralJobResponse {
     /**
-     * 任务ID。任务有效期为48小时。
+     * 任务ID
      */
     JobId?: string;
     /**
@@ -154,19 +209,6 @@ export interface DescribePortraitSingJobRequest {
      */
     JobId: string;
 }
-/**
- * SubmitImageToVideoGeneralJob返回参数结构体
- */
-export interface SubmitImageToVideoGeneralJobResponse {
-    /**
-     * 任务ID
-     */
-    JobId?: string;
-    /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
-     */
-    RequestId?: string;
-}
 /**
  * SubmitImageAnimateJob返回参数结构体
  */
@@ -278,6 +320,19 @@ export interface DescribeVideoStylizationJobRequest {
      */
     JobId: string;
 }
+/**
+ * SubmitHumanActorJob返回参数结构体
+ */
+export interface SubmitHumanActorJobResponse {
+    /**
+     * 任务ID。
+     */
+    JobId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * DescribeImageAnimateJob返回参数结构体
  */
@@ -379,6 +434,40 @@ export interface LogoRect {
      */
     Height?: number;
 }
+/**
+ * DescribeHumanActorJob返回参数结构体
+ */
+export interface DescribeHumanActorJobResponse {
+    /**
+     * 任务状态。  WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+     */
+    Status?: string;
+    /**
+     * 结果视频URL。有效期 24 小时。
+     */
+    ResultVideoUrl?: string;
+    /**
+     * 任务执行错误码。当任务状态不为 FAIL 时，该值为""。
+     */
+    ErrorCode?: string;
+    /**
+     * 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。
+     */
+    ErrorMessage?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * 扩展字段。
+ */
+export interface ExtraParam {
+    /**
+     * 预签名的上传url，支持把视频直接传到客户指定的地址。
+     */
+    UserDesignatedUrl?: string;
+}
 /**
  * DescribeVideoStylizationJob返回参数结构体
  */
@@ -427,6 +516,19 @@ export interface SubmitVideoStylizationJobResponse {
      */
     RequestId?: string;
 }
+/**
+ * SubmitPortraitSingJob返回参数结构体
+ */
+export interface SubmitPortraitSingJobResponse {
+    /**
+     * 任务ID。任务有效期为48小时。
+     */
+    JobId?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * SubmitTemplateToVideoJob请求参数结构体
  */
@@ -436,34 +538,38 @@ export interface SubmitTemplateToVideoJobRequest {
      */
     Template: string;
     /**
-     * 参考图像，最多输入2张图。
+     * 参考图像，不同特效输入图片的数量详见： [视频特效模板-图片要求说明](https://cloud.tencent.com/document/product/1616/119194)
   - 支持传入图片Base64编码或图片URL（确保可访问）
   - 图片格式：支持png、jpg、jpeg、webp、bmp、tiff
-  - 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300\*300px，不大于4096\*4096，图片宽高比应在1:4 ~ 4:1之间
-  
+  - 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300*300px，不大于4096*4096，图片宽高比应在1:4 ~ 4:1之间
      */
     Images: Array<Image>;
     /**
-     * 为生成视频添加标识的开关，默认为1。
-  1：添加标识。
-  0：不添加标识。
+     * 为生成视频添加标识的开关，默认为1。传0 需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成后方可生效。
+  1：添加标识；
+  0：不添加标识；
   其他数值：默认按1处理。
   建议您使用显著标识来提示，该视频是 AI 生成的视频。
      */
     LogoAdd?: number;
     /**
      * 标识内容设置。
-  默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+  默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成。
+  
      */
     LogoParam?: LogoParam;
     /**
-     * 视频输出分辨率，默认值：360p  - 枚举值：  720p  360p。
+     * 视频输出分辨率，默认值：360p 。不同特效支持的清晰度及消耗积分数详见：[视频特效模板-单次调用消耗积分数列](https://cloud.tencent.com/document/product/1616/119194 )
      */
     Resolution?: string;
     /**
      * 是否为生成的视频添加背景音乐。默认：false，  传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。
      */
     BGM?: boolean;
+    /**
+     * 扩展字段。
+     */
+    ExtraParam?: ExtraParam;
 }
 /**
  * SubmitImageToVideoGeneralJob请求参数结构体
@@ -503,6 +609,15 @@ export interface Image {
      */
     Url?: string;
 }
+/**
+ * DescribeHumanActorJob请求参数结构体
+ */
+export interface DescribeHumanActorJobRequest {
+    /**
+     * 任务ID。
+     */
+    JobId: string;
+}
 /**
  * DescribeImageToVideoGeneralJob请求参数结构体
  */