tencentcloud-sdk-python 3.1.13__py2.py3-none-any.whl → 3.1.33__py2.py3-none-any.whl

tencentcloud/vclm/v20240523/models.py

@@ -980,6 +980,130 @@ class DescribeTemplateToVideoJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeVideoEditJobRequest(AbstractModel):
+    r"""DescribeVideoEditJob请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _JobId: 任务ID。
+        :type JobId: str
+        """
+        self._JobId = None
+
+    @property
+    def JobId(self):
+        r"""任务ID。
+        :rtype: str
+        """
+        return self._JobId
+
+    @JobId.setter
+    def JobId(self, JobId):
+        self._JobId = JobId
+
+
+    def _deserialize(self, params):
+        self._JobId = params.get("JobId")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class DescribeVideoEditJobResponse(AbstractModel):
+    r"""DescribeVideoEditJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Status: 任务状态。  WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        :type Status: str
+        :param _ResultVideoUrl: 结果视频URL。有效期 24 小时。
+        :type ResultVideoUrl: str
+        :param _ErrorCode: 任务执行错误码。当任务状态不为 FAIL 时，该值为""。
+        :type ErrorCode: str
+        :param _ErrorMessage: 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。
+        :type ErrorMessage: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._Status = None
+        self._ResultVideoUrl = None
+        self._ErrorCode = None
+        self._ErrorMessage = None
+        self._RequestId = None
+
+    @property
+    def Status(self):
+        r"""任务状态。  WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        :rtype: str
+        """
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def ResultVideoUrl(self):
+        r"""结果视频URL。有效期 24 小时。
+        :rtype: str
+        """
+        return self._ResultVideoUrl
+
+    @ResultVideoUrl.setter
+    def ResultVideoUrl(self, ResultVideoUrl):
+        self._ResultVideoUrl = ResultVideoUrl
+
+    @property
+    def ErrorCode(self):
+        r"""任务执行错误码。当任务状态不为 FAIL 时，该值为""。
+        :rtype: str
+        """
+        return self._ErrorCode
+
+    @ErrorCode.setter
+    def ErrorCode(self, ErrorCode):
+        self._ErrorCode = ErrorCode
+
+    @property
+    def ErrorMessage(self):
+        r"""任务执行错误信息。当任务状态不为 FAIL 时，该值为""。
+        :rtype: str
+        """
+        return self._ErrorMessage
+
+    @ErrorMessage.setter
+    def ErrorMessage(self, ErrorMessage):
+        self._ErrorMessage = ErrorMessage
+
+    @property
+    def RequestId(self):
+        r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._Status = params.get("Status")
+        self._ResultVideoUrl = params.get("ResultVideoUrl")
+        self._ErrorCode = params.get("ErrorCode")
+        self._ErrorMessage = params.get("ErrorMessage")
+        self._RequestId = params.get("RequestId")
+
+
 class DescribeVideoFaceFusionJobRequest(AbstractModel):
     r"""DescribeVideoFaceFusionJob请求参数结构体
 
@@ -1381,8 +1505,20 @@ class ExtraParam(AbstractModel):
         r"""
         :param _UserDesignatedUrl: 预签名的上传url，支持把视频直接传到客户指定的地址。
         :type UserDesignatedUrl: str
+        :param _CallbackUrl: 回调地址
+需要您在创建任务时主动设置 CallbackUrl，请求方法为 POST，当视频生成结束时，我们将向此地址发送生成结果。
+数据格式如下：
+{
+    "JobId": "1397428070633955328",
+    "Status": "DONE",
+    "ErrorCode": "",
+    "ErrorMessage": "",
+    "ResultVideoUrl": "https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4"
+}
+        :type CallbackUrl: str
         """
         self._UserDesignatedUrl = None
+        self._CallbackUrl = None
 
     @property
     def UserDesignatedUrl(self):
@@ -1395,9 +1531,30 @@ class ExtraParam(AbstractModel):
     def UserDesignatedUrl(self, UserDesignatedUrl):
         self._UserDesignatedUrl = UserDesignatedUrl
 
+    @property
+    def CallbackUrl(self):
+        r"""回调地址
+需要您在创建任务时主动设置 CallbackUrl，请求方法为 POST，当视频生成结束时，我们将向此地址发送生成结果。
+数据格式如下：
+{
+    "JobId": "1397428070633955328",
+    "Status": "DONE",
+    "ErrorCode": "",
+    "ErrorMessage": "",
+    "ResultVideoUrl": "https://vcg.cos.tencentcos.cn/template_to_video/fa80b846-b933-4981-afad-8a39b46ef2ca.mp4"
+}
+        :rtype: str
+        """
+        return self._CallbackUrl
+
+    @CallbackUrl.setter
+    def CallbackUrl(self, CallbackUrl):
+        self._CallbackUrl = CallbackUrl
+
 
     def _deserialize(self, params):
         self._UserDesignatedUrl = params.get("UserDesignatedUrl")
+        self._CallbackUrl = params.get("CallbackUrl")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -2462,6 +2619,8 @@ Base64 和 Url 必须提供一个，如果都提供以ImageUrl为准。
         :type Image: :class:`tencentcloud.vclm.v20240523.models.Image`
         :param _Prompt: 视频内容的描述，中文正向提示词。最多支持200个 utf-8 字符（首尾空格不计入字符数）。
         :type Prompt: str
+        :param _Resolution: 输出视频分辨率。可选择：480p、720p、1080p。
+        :type Resolution: str
         :param _LogoAdd: 为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。  1：添加标识；  0：不添加标识；  其他数值：默认按1处理。
         :type LogoAdd: int
         :param _LogoParam: 默认在生成视频的右下角添加“ AI 生成”字样，如需替换为其他的标识图片，需前往 控制台 申请开启显示标识自主完成。
@@ -2469,6 +2628,7 @@ Base64 和 Url 必须提供一个，如果都提供以ImageUrl为准。
         """
         self._Image = None
         self._Prompt = None
+        self._Resolution = None
         self._LogoAdd = None
         self._LogoParam = None
 
@@ -2498,6 +2658,17 @@ Base64 和 Url 必须提供一个，如果都提供以ImageUrl为准。
     def Prompt(self, Prompt):
         self._Prompt = Prompt
 
+    @property
+    def Resolution(self):
+        r"""输出视频分辨率。可选择：480p、720p、1080p。
+        :rtype: str
+        """
+        return self._Resolution
+
+    @Resolution.setter
+    def Resolution(self, Resolution):
+        self._Resolution = Resolution
+
     @property
     def LogoAdd(self):
         r"""为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。  1：添加标识；  0：不添加标识；  其他数值：默认按1处理。
@@ -2526,6 +2697,7 @@ Base64 和 Url 必须提供一个，如果都提供以ImageUrl为准。
             self._Image = Image()
             self._Image._deserialize(params.get("Image"))
         self._Prompt = params.get("Prompt")
+        self._Resolution = params.get("Resolution")
         self._LogoAdd = params.get("LogoAdd")
         if params.get("LogoParam") is not None:
             self._LogoParam = LogoParam()
@@ -2986,6 +3158,217 @@ class SubmitTemplateToVideoJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class SubmitVideoEditJobRequest(AbstractModel):
+    r"""SubmitVideoEditJob请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _VideoUrl: 参考视频URL。默认为待编辑视频。
+- 视频格式：支持MP4
+- 视频时长：输入视频时长≤5秒
+- 视频大小：不超过200M
+- 视频文件：输入的视频帧率及分辨率不做限制（建议输入16：9或9：16的视频；分辨率建议在2160px内，帧率建议在60fps内）；输出视频是帧率会≥16fps，分辨率为720p
+        :type VideoUrl: str
+        :param _Prompt: 视频内容的描述，中文正向提示词。支持视频内容增加、删除、修改等能力
+- 最多支持200个 utf-8 字符（首尾空格不计入字符数）
+- 不传prompt的时候，Images.N参考图列表必须要传图，且传的图片是经过图片编辑之后的结果图
+        :type Prompt: str
+        :param _Images: 参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。
+- 支持传入图片Base64编码或图片URL
+- 图片格式：支持jpg，png，jpeg，webp，bmp，tiff 格式
+- 图片文件：大小不能超过10MB（base64后）。单边分辨率不超过5000px，不小于50px，图片长宽限制1:4 ~ 4:1。
+示例值：[{ "Url": "https://console.cloud.tencent.com/cos/image.png"}]
+        :type Images: list of Image
+        :param _Image: 图片base64或者图片url
+
+- Base64 和 Url 必须提供一个，如果都提供以Url为准。
+- 上传图url大小不超过 8M
+- 支持jpg，png，jpeg，webp，bmp，tiff 格式
+- 单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1
+        :type Image: :class:`tencentcloud.vclm.v20240523.models.Image`
+        :param _LogoAdd: 为生成视频添加标识的开关，默认为1。传0 需前往  [控制台](https://console.cloud.tencent.com/vtc/setting)  申请开启显式标识自主完成后方可生效。
+1：添加标识；
+0：不添加标识；
+其他数值：默认按1处理。
+建议您使用显著标识来提示，该视频是 AI 生成的视频。
+
+        :type LogoAdd: int
+        :param _LogoParam: 标识内容设置。
+默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往   [控制台](https://console.cloud.tencent.com/vtc/setting)  申请开启显式标识自主完成。
+
+        :type LogoParam: :class:`tencentcloud.vclm.v20240523.models.LogoParam`
+        """
+        self._VideoUrl = None
+        self._Prompt = None
+        self._Images = None
+        self._Image = None
+        self._LogoAdd = None
+        self._LogoParam = None
+
+    @property
+    def VideoUrl(self):
+        r"""参考视频URL。默认为待编辑视频。
+- 视频格式：支持MP4
+- 视频时长：输入视频时长≤5秒
+- 视频大小：不超过200M
+- 视频文件：输入的视频帧率及分辨率不做限制（建议输入16：9或9：16的视频；分辨率建议在2160px内，帧率建议在60fps内）；输出视频是帧率会≥16fps，分辨率为720p
+        :rtype: str
+        """
+        return self._VideoUrl
+
+    @VideoUrl.setter
+    def VideoUrl(self, VideoUrl):
+        self._VideoUrl = VideoUrl
+
+    @property
+    def Prompt(self):
+        r"""视频内容的描述，中文正向提示词。支持视频内容增加、删除、修改等能力
+- 最多支持200个 utf-8 字符（首尾空格不计入字符数）
+- 不传prompt的时候，Images.N参考图列表必须要传图，且传的图片是经过图片编辑之后的结果图
+        :rtype: str
+        """
+        return self._Prompt
+
+    @Prompt.setter
+    def Prompt(self, Prompt):
+        self._Prompt = Prompt
+
+    @property
+    def Images(self):
+        r"""参考图列表。用于对视频内容做风格迁移、内容替换、内容删减、内容增加做参考。
+- 支持传入图片Base64编码或图片URL
+- 图片格式：支持jpg，png，jpeg，webp，bmp，tiff 格式
+- 图片文件：大小不能超过10MB（base64后）。单边分辨率不超过5000px，不小于50px，图片长宽限制1:4 ~ 4:1。
+示例值：[{ "Url": "https://console.cloud.tencent.com/cos/image.png"}]
+        :rtype: list of Image
+        """
+        return self._Images
+
+    @Images.setter
+    def Images(self, Images):
+        self._Images = Images
+
+    @property
+    def Image(self):
+        warnings.warn("parameter `Image` is deprecated", DeprecationWarning) 
+
+        r"""图片base64或者图片url
+
+- Base64 和 Url 必须提供一个，如果都提供以Url为准。
+- 上传图url大小不超过 8M
+- 支持jpg，png，jpeg，webp，bmp，tiff 格式
+- 单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1
+        :rtype: :class:`tencentcloud.vclm.v20240523.models.Image`
+        """
+        return self._Image
+
+    @Image.setter
+    def Image(self, Image):
+        warnings.warn("parameter `Image` is deprecated", DeprecationWarning) 
+
+        self._Image = Image
+
+    @property
+    def LogoAdd(self):
+        r"""为生成视频添加标识的开关，默认为1。传0 需前往  [控制台](https://console.cloud.tencent.com/vtc/setting)  申请开启显式标识自主完成后方可生效。
+1：添加标识；
+0：不添加标识；
+其他数值：默认按1处理。
+建议您使用显著标识来提示，该视频是 AI 生成的视频。
+
+        :rtype: int
+        """
+        return self._LogoAdd
+
+    @LogoAdd.setter
+    def LogoAdd(self, LogoAdd):
+        self._LogoAdd = LogoAdd
+
+    @property
+    def LogoParam(self):
+        r"""标识内容设置。
+默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往   [控制台](https://console.cloud.tencent.com/vtc/setting)  申请开启显式标识自主完成。
+
+        :rtype: :class:`tencentcloud.vclm.v20240523.models.LogoParam`
+        """
+        return self._LogoParam
+
+    @LogoParam.setter
+    def LogoParam(self, LogoParam):
+        self._LogoParam = LogoParam
+
+
+    def _deserialize(self, params):
+        self._VideoUrl = params.get("VideoUrl")
+        self._Prompt = params.get("Prompt")
+        if params.get("Images") is not None:
+            self._Images = []
+            for item in params.get("Images"):
+                obj = Image()
+                obj._deserialize(item)
+                self._Images.append(obj)
+        if params.get("Image") is not None:
+            self._Image = Image()
+            self._Image._deserialize(params.get("Image"))
+        self._LogoAdd = params.get("LogoAdd")
+        if params.get("LogoParam") is not None:
+            self._LogoParam = LogoParam()
+            self._LogoParam._deserialize(params.get("LogoParam"))
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class SubmitVideoEditJobResponse(AbstractModel):
+    r"""SubmitVideoEditJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _JobId: 任务ID。
+        :type JobId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._JobId = None
+        self._RequestId = None
+
+    @property
+    def JobId(self):
+        r"""任务ID。
+        :rtype: str
+        """
+        return self._JobId
+
+    @JobId.setter
+    def JobId(self, JobId):
+        self._JobId = JobId
+
+    @property
+    def RequestId(self):
+        r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._JobId = params.get("JobId")
+        self._RequestId = params.get("RequestId")
+
+
 class SubmitVideoFaceFusionJobRequest(AbstractModel):
     r"""SubmitVideoFaceFusionJob请求参数结构体
 

tencentcloud/vclm/v20240523/vclm_client.py

@@ -188,6 +188,29 @@ class VclmClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeVideoEditJob(self, request):
+        r"""用于提交视频编辑任务，支持上传视频、文本及图片素材开展编辑操作，涵盖风格迁移、元素替换、内容增减等核心能力。
+
+        :param request: Request instance for DescribeVideoEditJob.
+        :type request: :class:`tencentcloud.vclm.v20240523.models.DescribeVideoEditJobRequest`
+        :rtype: :class:`tencentcloud.vclm.v20240523.models.DescribeVideoEditJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeVideoEditJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeVideoEditJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeVideoFaceFusionJob(self, request):
         r"""查询视频人脸融合任务
 
@@ -399,6 +422,29 @@ class VclmClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def SubmitVideoEditJob(self, request):
+        r"""用于提交视频编辑任务，支持上传视频、文本及图片素材开展编辑操作，涵盖风格迁移、元素替换、内容增减等核心能力。
+
+        :param request: Request instance for SubmitVideoEditJob.
+        :type request: :class:`tencentcloud.vclm.v20240523.models.SubmitVideoEditJobRequest`
+        :rtype: :class:`tencentcloud.vclm.v20240523.models.SubmitVideoEditJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("SubmitVideoEditJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.SubmitVideoEditJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def SubmitVideoFaceFusionJob(self, request):
         r"""提交视频人脸融合任务
 

tencentcloud/vclm/v20240523/vclm_client_async.py

@@ -152,6 +152,24 @@ class VclmClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeVideoEditJob(
+            self,
+            request: models.DescribeVideoEditJobRequest,
+            opts: Dict = None,
+    ) -> models.DescribeVideoEditJobResponse:
+        """
+        用于提交视频编辑任务，支持上传视频、文本及图片素材开展编辑操作，涵盖风格迁移、元素替换、内容增减等核心能力。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeVideoEditJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeVideoEditJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def DescribeVideoFaceFusionJob(
             self,
             request: models.DescribeVideoFaceFusionJobRequest,
@@ -318,6 +336,24 @@ class VclmClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def SubmitVideoEditJob(
+            self,
+            request: models.SubmitVideoEditJobRequest,
+            opts: Dict = None,
+    ) -> models.SubmitVideoEditJobResponse:
+        """
+        用于提交视频编辑任务，支持上传视频、文本及图片素材开展编辑操作，涵盖风格迁移、元素替换、内容增减等核心能力。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "SubmitVideoEditJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.SubmitVideoEditJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def SubmitVideoFaceFusionJob(
             self,
             request: models.SubmitVideoFaceFusionJobRequest,

tencentcloud/vcube/v20220410/models.py

@@ -1845,6 +1845,36 @@ class DeleteApplicationAndVideoLicenseRequest(AbstractModel):
 
     """
 
+    def __init__(self):
+        r"""
+        :param _LicenseId: license唯一标识
+        :type LicenseId: int
+        """
+        self._LicenseId = None
+
+    @property
+    def LicenseId(self):
+        r"""license唯一标识
+        :rtype: int
+        """
+        return self._LicenseId
+
+    @LicenseId.setter
+    def LicenseId(self, LicenseId):
+        self._LicenseId = LicenseId
+
+
+    def _deserialize(self, params):
+        self._LicenseId = params.get("LicenseId")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
 
 class DeleteApplicationAndVideoLicenseResponse(AbstractModel):
     r"""DeleteApplicationAndVideoLicense返回参数结构体