tccli 3.0.1407.1__py2.py3-none-any.whl → 3.1.6.1__py2.py3-none-any.whl

tccli/services/vclm/v20240523/api.json

@@ -7,6 +7,13 @@
       "output": "CheckAnimateImageJobResponse",
       "status": "online"
     },
+    "DescribeHumanActorJob": {
+      "document": "通过JobId提交请求，获取人像驱动任务的结果信息。",
+      "input": "DescribeHumanActorJobRequest",
+      "name": "查询人像驱动任务",
+      "output": "DescribeHumanActorJobResponse",
+      "status": "online"
+    },
     "DescribeImageAnimateJob": {
       "document": "用于查询图片跳舞任务。图片跳舞能力支持舞蹈动作结合图片生成跳舞视频，满足社交娱乐、互动营销等场景的需求。",
       "input": "DescribeImageAnimateJobRequest",
@@ -14,6 +21,13 @@
       "output": "DescribeImageAnimateJobResponse",
       "status": "online"
     },
+    "DescribeImageToVideoGeneralJob": {
+      "document": "查询图生视频通用能力任务接口",
+      "input": "DescribeImageToVideoGeneralJobRequest",
+      "name": "查询图生视频通用能力任务",
+      "output": "DescribeImageToVideoGeneralJobResponse",
+      "status": "online"
+    },
     "DescribePortraitSingJob": {
       "document": "用于查询图片唱演任务。\n支持提交音频和图片生成唱演视频，满足社交娱乐、互动营销等场景的需求。",
       "input": "DescribePortraitSingJobRequest",
@@ -35,6 +49,13 @@
       "output": "DescribeVideoStylizationJobResponse",
       "status": "online"
     },
+    "SubmitHumanActorJob": {
+      "document": "用于提交人像驱动任务\n支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。",
+      "input": "SubmitHumanActorJobRequest",
+      "name": "提交人像驱动任务",
+      "output": "SubmitHumanActorJobResponse",
+      "status": "online"
+    },
     "SubmitImageAnimateJob": {
       "document": "用于提交图片跳舞任务。图片跳舞能力支持舞蹈动作结合图片生成跳舞视频，满足社交娱乐、互动营销等场景的需求。",
       "input": "SubmitImageAnimateJobRequest",
@@ -42,6 +63,13 @@
       "output": "SubmitImageAnimateJobResponse",
       "status": "online"
     },
+    "SubmitImageToVideoGeneralJob": {
+      "document": "图生视频通用能力接口",
+      "input": "SubmitImageToVideoGeneralJobRequest",
+      "name": "提交图生视频通用能力任务",
+      "output": "SubmitImageToVideoGeneralJobResponse",
+      "status": "online"
+    },
     "SubmitPortraitSingJob": {
       "document": "用于提交图片唱演任务。\n支持提交音频和图片生成唱演视频，满足社交娱乐、互动营销等场景的需求。",
       "input": "SubmitPortraitSingJobRequest",
@@ -144,6 +172,73 @@
       ],
       "type": "object"
     },
+    "DescribeHumanActorJobRequest": {
+      "document": "DescribeHumanActorJob请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务ID。",
+          "example": "1380069281965932544",
+          "member": "string",
+          "name": "JobId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "DescribeHumanActorJobResponse": {
+      "document": "DescribeHumanActorJob返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务状态。  WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功",
+          "example": "DONE",
+          "member": "string",
+          "name": "Status",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "结果视频URL。有效期 24 小时。",
+          "example": "https://vcg-prod-xxx.cos.ap-guangzhou.tencentcos.cn/xxx.mp4",
+          "member": "string",
+          "name": "ResultVideoUrl",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "任务执行错误码。当任务状态不为 FAIL 时，该值为\"\"。",
+          "example": "FailedOperation.ModerationFailed",
+          "member": "string",
+          "name": "ErrorCode",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "任务执行错误信息。当任务状态不为 FAIL 时，该值为\"\"。",
+          "example": "审核未通过",
+          "member": "string",
+          "name": "ErrorMessage",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "DescribeImageAnimateJobRequest": {
       "document": "DescribeImageAnimateJob请求参数结构体",
       "members": [
@@ -221,6 +316,73 @@
       ],
       "type": "object"
     },
+    "DescribeImageToVideoGeneralJobRequest": {
+      "document": "DescribeImageToVideoGeneralJob请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务ID",
+          "example": "1350360280588853248",
+          "member": "string",
+          "name": "JobId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "DescribeImageToVideoGeneralJobResponse": {
+      "document": "DescribeImageToVideoGeneralJob返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功",
+          "example": "RUN",
+          "member": "string",
+          "name": "Status",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "任务执行错误码。当任务状态不为 FAIL 时，该值为\"\"。",
+          "example": "FailedOperation.DriverFailed",
+          "member": "string",
+          "name": "ErrorCode",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "任务执行错误信息。当任务状态不为 FAIL 时，该值为\"\"。",
+          "example": "驱动失败",
+          "member": "string",
+          "name": "ErrorMessage",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "结果视频 URL。有效期 24 小时。",
+          "example": "https://console.cloud.tencent.com/result.mp4",
+          "member": "string",
+          "name": "ResultVideoUrl",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "DescribePortraitSingJobRequest": {
       "document": "DescribePortraitSingJob请求参数结构体",
       "members": [
@@ -442,6 +604,21 @@
       ],
       "type": "object"
     },
+    "ExtraParam": {
+      "document": "扩展字段。",
+      "members": [
+        {
+          "disabled": false,
+          "document": "预签名的上传url，支持把视频直接传到客户指定的地址。",
+          "example": "http://tencent.com/result/video.mp4\t",
+          "member": "string",
+          "name": "UserDesignatedUrl",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "usage": "in"
+    },
     "Image": {
       "document": "图片",
       "members": [
@@ -559,6 +736,106 @@
       ],
       "usage": "both"
     },
+    "SubmitHumanActorJobRequest": {
+      "document": "SubmitHumanActorJob请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "文本提示词，不能超过5000字符。\n提示词支持全局和局部控制：\n\n- 全局控制：正常输入提示词即可\n- 局部控制：可用双井号进行特定时间的提示词约束，例如： \"画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容。镜头保持固定。#3#画面中的人物正在对着镜头讲话，同时做出单手做向左方引导的手势。镜头保持固定。\"（意思是第三秒的时候让人物做出左方引导手势）\n -- 局部控制时间建议整数，最大可读小数点后两位。",
+          "example": "\"画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容\"",
+          "member": "string",
+          "name": "Prompt",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "传入音频URL地址，音频要求：\n- 音频时长：2秒 - 60秒\n- 音频格式：mp3、wav\n- 音频大小：10M以内",
+          "example": "https://cos.ap-guangzhou.myqcloud.com/audio.mp3",
+          "member": "string",
+          "name": "AudioUrl",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "传入图片URL地址，图片要求：\n- 图片格式：jpg、jpeg、png、bmp、webp\n- 图片分辨率：192～4096\n- 图片大小：不超过10M\n- 图片宽高比：图片【宽：高】在1:4到4:1范围内\n- 图片内容：避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。",
+          "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg",
+          "member": "string",
+          "name": "ImageUrl",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "传入图片Base64编码，编码后请求体大小不超过10M。\n图片Base64编码与URL地址必传其一，如果都传以ImageUrl为准。",
+          "example": "/9j/4QlQaHR0c...N6a2M5ZCI",
+          "member": "string",
+          "name": "ImageBase64",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "生成视频分辨率\n枚举值：720p，1080p\n默认1080p",
+          "example": "1080p",
+          "member": "string",
+          "name": "Resolution",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "生成视频帧数，单位fps。\n枚举值：25，50\n默认50帧",
+          "example": "50",
+          "member": "int64",
+          "name": "FrameRate",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。",
+          "example": "1",
+          "member": "int64",
+          "name": "LogoAdd",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
+          "example": "无",
+          "member": "LogoParam",
+          "name": "LogoParam",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "SubmitHumanActorJobResponse": {
+      "document": "SubmitHumanActorJob返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务ID。",
+          "example": "1380069281965932544",
+          "member": "string",
+          "name": "JobId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "SubmitImageAnimateJobRequest": {
       "document": "SubmitImageAnimateJob请求参数结构体",
       "members": [
@@ -668,6 +945,70 @@
       ],
       "type": "object"
     },
+    "SubmitImageToVideoGeneralJobRequest": {
+      "document": "SubmitImageToVideoGeneralJob请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "输入图片\nBase64 和 Url 必须提供一个，如果都提供以ImageUrl为准。\n上传图url大小不超过 8M\n支持jpg，png，jpeg，webp，bmp，tiff 格式\n单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1",
+          "example": "无",
+          "member": "Image",
+          "name": "Image",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "视频内容的描述，中文正向提示词。最多支持200个 utf-8 字符（首尾空格不计入字符数）。",
+          "example": "一只猫在草原上奔跑，写实风格",
+          "member": "string",
+          "name": "Prompt",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。  1：添加标识；  0：不添加标识；  其他数值：默认按1处理。",
+          "example": "1",
+          "member": "int64",
+          "name": "LogoAdd",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "默认在生成视频的右下角添加“ AI 生成”字样，如需替换为其他的标识图片，需前往 控制台 申请开启显示标识自主完成。",
+          "example": "无",
+          "member": "LogoParam",
+          "name": "LogoParam",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "SubmitImageToVideoGeneralJobResponse": {
+      "document": "SubmitImageToVideoGeneralJob返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "任务ID",
+          "example": "1350360280588853248",
+          "member": "string",
+          "name": "JobId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "SubmitPortraitSingJobRequest": {
       "document": "SubmitPortraitSingJob请求参数结构体",
       "members": [
@@ -773,7 +1114,7 @@
         },
         {
           "disabled": false,
-          "document": "参考图像，最多输入2张图。\n- 支持传入图片Base64编码或图片URL（确保可访问）\n- 图片格式：支持png、jpg、jpeg、webp、bmp、tiff\n- 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300\\*300px，不大于4096\\*4096，图片宽高比应在1:4 ~ 4:1之间\n",
+          "document": "参考图像，不同特效输入图片的数量详见： [视频特效模板-图片要求说明](https://cloud.tencent.com/document/product/1616/119194)\n- 支持传入图片Base64编码或图片URL（确保可访问）\n- 图片格式：支持png、jpg、jpeg、webp、bmp、tiff\n- 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300*300px，不大于4096*4096，图片宽高比应在1:4 ~ 4:1之间",
           "example": "无",
           "member": "Image",
           "name": "Images",
@@ -782,7 +1123,7 @@
         },
         {
           "disabled": false,
-          "document": "为生成视频添加标识的开关，默认为1。\n1：添加标识。\n0：不添加标识。\n其他数值：默认按1处理。\n建议您使用显著标识来提示，该视频是 AI 生成的视频。",
+          "document": "为生成视频添加标识的开关，默认为1。传0 需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成后方可生效。\n1：添加标识；\n0：不添加标识；\n其他数值：默认按1处理。\n建议您使用显著标识来提示，该视频是 AI 生成的视频。",
           "example": "1",
           "member": "int64",
           "name": "LogoAdd",
@@ -791,7 +1132,7 @@
         },
         {
           "disabled": false,
-          "document": "标识内容设置。\n默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
+          "document": "标识内容设置。\n默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成。\n",
           "example": "无",
           "member": "LogoParam",
           "name": "LogoParam",
@@ -800,7 +1141,7 @@
         },
         {
           "disabled": false,
-          "document": "视频输出分辨率，默认值：360p  - 枚举值：  720p  360p。",
+          "document": "视频输出分辨率，默认值：360p 。不同特效支持的清晰度及消耗积分数详见：[视频特效模板-单次调用消耗积分数列](https://cloud.tencent.com/document/product/1616/119194 )",
           "example": "360p",
           "member": "string",
           "name": "Resolution",
@@ -815,6 +1156,15 @@
           "name": "BGM",
           "required": false,
           "type": "bool"
+        },
+        {
+          "disabled": false,
+          "document": "扩展字段。",
+          "example": "无",
+          "member": "ExtraParam",
+          "name": "ExtraParam",
+          "required": false,
+          "type": "object"
         }
       ],
       "type": "object"

tccli/services/vclm/v20240523/examples.json

@@ -8,6 +8,14 @@
         "title": "检测输入图成功案例"
       }
     ],
+    "DescribeHumanActorJob": [
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: vclm.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeHumanActorJob\n<公共请求参数>\n\n{\n    \"JobId\": \"1382369743251030016\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ErrorCode\": \"\",\n        \"ErrorMessage\": \"\",\n        \"RequestId\": \"49d3235d-0f60-4add-9fdf-662030c340f1\",\n        \"ResultVideoUrl\": \"https://cos.ap-guangzhou.tencentcos.cn/xxx.mp4\",\n        \"Status\": \"DONE\"\n    }\n}",
+        "title": "调用示例"
+      }
+    ],
     "DescribeImageAnimateJob": [
       {
         "document": "调用成功示例",
@@ -16,6 +24,14 @@
         "title": "调用成功示例"
       }
     ],
+    "DescribeImageToVideoGeneralJob": [
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: vclm.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeImageToVideoGeneralJob\n<公共请求参数>\n\n{\n    \"JobId\": \"1355169569101660160\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ErrorCode\": \"\",\n        \"ErrorMessage\": \"\",\n        \"RequestId\": \"6757832e-7ae1-4174-ab0f-278aca3edd75\",\n        \"ResultVideoUrl\": \"\",\n        \"Status\": \"RUN\"\n    }\n}",
+        "title": "查询图生视频通用任务"
+      }
+    ],
     "DescribePortraitSingJob": [
       {
         "document": "任务完成",
@@ -40,6 +56,14 @@
         "title": "成功调用-任务完成"
       }
     ],
+    "SubmitHumanActorJob": [
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: vclm.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: SubmitHumanActorJob\n<公共请求参数>\n\n{\n    \"Prompt\": \"画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容\",\n    \"AudioUrl\": \"https://cos.ap-guangzhou.myqcloud.com/xxx.mp3\",\n    \"ImageUrl\": \"https://cos.ap-guangzhou.myqcloud.com/xxx.jpg\"\n}",
+        "output": "{\n    \"Response\": {\n        \"JobId\": \"1382369743251030016\",\n        \"RequestId\": \"6f70a522-09c8-46c9-9e22-e6c2ab23ac3c\"\n    }\n}",
+        "title": "调用示例"
+      }
+    ],
     "SubmitImageAnimateJob": [
       {
         "document": "调用成功示例",
@@ -48,6 +72,14 @@
         "title": "调用成功示例"
       }
     ],
+    "SubmitImageToVideoGeneralJob": [
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: vclm.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: SubmitImageToVideoGeneralJob\n<公共请求参数>\n\n{\n    \"Image\": {\n        \"Url\": \"https://test.cos.ap-guangzhou.myqcloud.com/1-fps15.png\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"JobId\": \"1355169569101660160\",\n        \"RequestId\": \"90eaa0a4-fde3-4df0-a764-8dccaff6bd1c\"\n    }\n}",
+        "title": "提交图生视频通用任务"
+      }
+    ],
     "SubmitPortraitSingJob": [
       {
         "document": "调用成功",