tencentcloud-sdk-python-ai3d 3.1.57__tar.gz → 3.1.91__tar.gz

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ai3d
-Version: 3.1.57
+Version: 3.1.91
 Summary: Tencent Cloud Ai3d SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.57
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.91
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-ai3d',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.57,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.91,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Ai3d SDK for Python',

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.57'
+__version__ = '3.1.91'

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/tencentcloud/ai3d/v20250513/ai3d_client.py

@@ -49,6 +49,29 @@ class Ai3dClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeHunyuanTo3DMotionJob(self, request):
+        r"""查询组件生成任务。
+
+        :param request: Request instance for DescribeHunyuanTo3DMotionJob.
+        :type request: :class:`tencentcloud.ai3d.v20250513.models.DescribeHunyuanTo3DMotionJobRequest`
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.DescribeHunyuanTo3DMotionJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeHunyuanTo3DMotionJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeHunyuanTo3DMotionJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeHunyuanTo3DUVJob(self, request):
         r"""查询组件拆分任务。
 
@@ -238,6 +261,30 @@ class Ai3dClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def SubmitHunyuanTo3DMotionJob(self, request):
+        r"""输入文本后，可根据文本描述生成对应的 3D人物 动作数据，输出带动画数据的FBX文件。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        :param request: Request instance for SubmitHunyuanTo3DMotionJob.
+        :type request: :class:`tencentcloud.ai3d.v20250513.models.SubmitHunyuanTo3DMotionJobRequest`
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.SubmitHunyuanTo3DMotionJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("SubmitHunyuanTo3DMotionJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.SubmitHunyuanTo3DMotionJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def SubmitHunyuanTo3DProJob(self, request):
         r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
         默认提供3个并发，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/tencentcloud/ai3d/v20250513/ai3d_client_async.py

@@ -43,6 +43,24 @@ class Ai3dClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeHunyuanTo3DMotionJob(
+            self,
+            request: models.DescribeHunyuanTo3DMotionJobRequest,
+            opts: Dict = None,
+    ) -> models.DescribeHunyuanTo3DMotionJobResponse:
+        """
+        查询组件生成任务。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeHunyuanTo3DMotionJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeHunyuanTo3DMotionJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def DescribeHunyuanTo3DUVJob(
             self,
             request: models.DescribeHunyuanTo3DUVJobRequest,
@@ -192,6 +210,25 @@ class Ai3dClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def SubmitHunyuanTo3DMotionJob(
+            self,
+            request: models.SubmitHunyuanTo3DMotionJobRequest,
+            opts: Dict = None,
+    ) -> models.SubmitHunyuanTo3DMotionJobResponse:
+        """
+        输入文本后，可根据文本描述生成对应的 3D人物 动作数据，输出带动画数据的FBX文件。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "SubmitHunyuanTo3DMotionJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.SubmitHunyuanTo3DMotionJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def SubmitHunyuanTo3DProJob(
             self,
             request: models.SubmitHunyuanTo3DProJobRequest,

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/tencentcloud/ai3d/v20250513/models.py

@@ -112,6 +112,135 @@ class Convert3DFormatResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeHunyuanTo3DMotionJobRequest(AbstractModel):
+    r"""DescribeHunyuanTo3DMotionJob请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _JobId: <p>任务ID。</p>
+        :type JobId: str
+        """
+        self._JobId = None
+
+    @property
+    def JobId(self):
+        r"""<p>任务ID。</p>
+        :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 DescribeHunyuanTo3DMotionJobResponse(AbstractModel):
+    r"""DescribeHunyuanTo3DMotionJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Status: <p>任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 示例值：RUN。</p>
+        :type Status: str
+        :param _ErrorCode: <p>错误码。</p>
+        :type ErrorCode: str
+        :param _ErrorMessage: <p>错误信息。</p>
+        :type ErrorMessage: str
+        :param _ResultFile3Ds: <p>生成文件的URL地址，有效期1天。</p>
+        :type ResultFile3Ds: list of File3D
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._Status = None
+        self._ErrorCode = None
+        self._ErrorMessage = None
+        self._ResultFile3Ds = None
+        self._RequestId = None
+
+    @property
+    def Status(self):
+        r"""<p>任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 示例值：RUN。</p>
+        :rtype: str
+        """
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def ErrorCode(self):
+        r"""<p>错误码。</p>
+        :rtype: str
+        """
+        return self._ErrorCode
+
+    @ErrorCode.setter
+    def ErrorCode(self, ErrorCode):
+        self._ErrorCode = ErrorCode
+
+    @property
+    def ErrorMessage(self):
+        r"""<p>错误信息。</p>
+        :rtype: str
+        """
+        return self._ErrorMessage
+
+    @ErrorMessage.setter
+    def ErrorMessage(self, ErrorMessage):
+        self._ErrorMessage = ErrorMessage
+
+    @property
+    def ResultFile3Ds(self):
+        r"""<p>生成文件的URL地址，有效期1天。</p>
+        :rtype: list of File3D
+        """
+        return self._ResultFile3Ds
+
+    @ResultFile3Ds.setter
+    def ResultFile3Ds(self, ResultFile3Ds):
+        self._ResultFile3Ds = ResultFile3Ds
+
+    @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._ErrorCode = params.get("ErrorCode")
+        self._ErrorMessage = params.get("ErrorMessage")
+        if params.get("ResultFile3Ds") is not None:
+            self._ResultFile3Ds = []
+            for item in params.get("ResultFile3Ds"):
+                obj = File3D()
+                obj._deserialize(item)
+                self._ResultFile3Ds.append(obj)
+        self._RequestId = params.get("RequestId")
+
+
 class DescribeHunyuanTo3DUVJobRequest(AbstractModel):
     r"""DescribeHunyuanTo3DUVJob请求参数结构体
 
@@ -1309,6 +1438,177 @@ class SubmitHunyuan3DPartJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class SubmitHunyuanTo3DMotionJobRequest(AbstractModel):
+    r"""SubmitHunyuanTo3DMotionJob请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Prompt: <p>输入文本prompt，限定最大字符为128。</p>
+        :type Prompt: str
+        :param _Model: <p>模型名称：HY-Motion-1.0，默认HY-Motion-1.0。</p>
+        :type Model: str
+        :param _RetargetFile: <p>需重定向的模型地址，只能支持混元生3D动画生成的模型（动画模板的接口）</p>
+        :type RetargetFile: :class:`tencentcloud.ai3d.v20250513.models.InputFile3D`
+        :param _Duration: <p>生成动画的时长，默认5，范围：1-12（单位s）</p>
+        :type Duration: int
+        :param _EnableMesh: <p>默认true，返回的fbx是否带蒙皮mesh</p>
+        :type EnableMesh: bool
+        :param _EnableRewrite: <p>是否开启prompt扩写，开启后将补充完善输入的prompt。<br>默认false。</p>
+        :type EnableRewrite: bool
+        :param _EnableDurationEst: <p>是否开启时长自动匹配，开启后将自动根据prompt匹配适合时长的动作数据<br>默认false。</p>
+        :type EnableDurationEst: bool
+        """
+        self._Prompt = None
+        self._Model = None
+        self._RetargetFile = None
+        self._Duration = None
+        self._EnableMesh = None
+        self._EnableRewrite = None
+        self._EnableDurationEst = None
+
+    @property
+    def Prompt(self):
+        r"""<p>输入文本prompt，限定最大字符为128。</p>
+        :rtype: str
+        """
+        return self._Prompt
+
+    @Prompt.setter
+    def Prompt(self, Prompt):
+        self._Prompt = Prompt
+
+    @property
+    def Model(self):
+        r"""<p>模型名称：HY-Motion-1.0，默认HY-Motion-1.0。</p>
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
+    @property
+    def RetargetFile(self):
+        r"""<p>需重定向的模型地址，只能支持混元生3D动画生成的模型（动画模板的接口）</p>
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.InputFile3D`
+        """
+        return self._RetargetFile
+
+    @RetargetFile.setter
+    def RetargetFile(self, RetargetFile):
+        self._RetargetFile = RetargetFile
+
+    @property
+    def Duration(self):
+        r"""<p>生成动画的时长，默认5，范围：1-12（单位s）</p>
+        :rtype: int
+        """
+        return self._Duration
+
+    @Duration.setter
+    def Duration(self, Duration):
+        self._Duration = Duration
+
+    @property
+    def EnableMesh(self):
+        r"""<p>默认true，返回的fbx是否带蒙皮mesh</p>
+        :rtype: bool
+        """
+        return self._EnableMesh
+
+    @EnableMesh.setter
+    def EnableMesh(self, EnableMesh):
+        self._EnableMesh = EnableMesh
+
+    @property
+    def EnableRewrite(self):
+        r"""<p>是否开启prompt扩写，开启后将补充完善输入的prompt。<br>默认false。</p>
+        :rtype: bool
+        """
+        return self._EnableRewrite
+
+    @EnableRewrite.setter
+    def EnableRewrite(self, EnableRewrite):
+        self._EnableRewrite = EnableRewrite
+
+    @property
+    def EnableDurationEst(self):
+        r"""<p>是否开启时长自动匹配，开启后将自动根据prompt匹配适合时长的动作数据<br>默认false。</p>
+        :rtype: bool
+        """
+        return self._EnableDurationEst
+
+    @EnableDurationEst.setter
+    def EnableDurationEst(self, EnableDurationEst):
+        self._EnableDurationEst = EnableDurationEst
+
+
+    def _deserialize(self, params):
+        self._Prompt = params.get("Prompt")
+        self._Model = params.get("Model")
+        if params.get("RetargetFile") is not None:
+            self._RetargetFile = InputFile3D()
+            self._RetargetFile._deserialize(params.get("RetargetFile"))
+        self._Duration = params.get("Duration")
+        self._EnableMesh = params.get("EnableMesh")
+        self._EnableRewrite = params.get("EnableRewrite")
+        self._EnableDurationEst = params.get("EnableDurationEst")
+        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 SubmitHunyuanTo3DMotionJobResponse(AbstractModel):
+    r"""SubmitHunyuanTo3DMotionJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _JobId: <p>任务ID（有效期24小时）</p>
+        :type JobId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._JobId = None
+        self._RequestId = None
+
+    @property
+    def JobId(self):
+        r"""<p>任务ID（有效期24小时）</p>
+        :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 SubmitHunyuanTo3DProJobRequest(AbstractModel):
     r"""SubmitHunyuanTo3DProJob请求参数结构体
 
@@ -2091,6 +2391,10 @@ class SubmitTextureTo3DJobRequest(AbstractModel):
         r"""
         :param _File3D: <p>源3D模型文件。<br>Type可选值：OBJ，GLB</p>
         :type File3D: :class:`tencentcloud.ai3d.v20250513.models.File3D`
+        :param _Model: <p>混元生3D生成模型版本，默认为3.0，可选项：3.0，3.1<br>仅选择3.1版本时，多视图功能可用。</p>
+        :type Model: str
+        :param _MultiViewImages: <p>多视角的模型图片（仅3.1版本支持），视角参考值：<br>left：左视图；<br>right：右视图；<br>back：后视图；<br>top：顶视图；<br>bottom：底视图；<br>left_front：左前45°视图；<br>right_front：右前45°视图；</p><p>每个视角仅限制一张图片。<br>●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）<br>●图片分辨率限制：单边分辨率小于5000且大于128。<br>●支持图片格式：支持jpg或png</p>
+        :type MultiViewImages: list of ViewImage
         :param _Prompt: <p>文生3D，3D内容的描述，中文正向提示词。<br>最多支持200个 utf-8 字符。<br>文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。</p>
         :type Prompt: str
         :param _Image: <p>3D模型纹理参考图 Base64 数据和参考图 Url。</p><ul><li>Base64 和 Url 必须提供一个，如果都提供以 Url 为准。</li><li>图片限制：单边分辨率小于4096且大于128，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。</li></ul>
@@ -2099,6 +2403,8 @@ class SubmitTextureTo3DJobRequest(AbstractModel):
         :type EnablePBR: bool
         """
         self._File3D = None
+        self._Model = None
+        self._MultiViewImages = None
         self._Prompt = None
         self._Image = None
         self._EnablePBR = None
@@ -2114,6 +2420,28 @@ class SubmitTextureTo3DJobRequest(AbstractModel):
     def File3D(self, File3D):
         self._File3D = File3D
 
+    @property
+    def Model(self):
+        r"""<p>混元生3D生成模型版本，默认为3.0，可选项：3.0，3.1<br>仅选择3.1版本时，多视图功能可用。</p>
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
+    @property
+    def MultiViewImages(self):
+        r"""<p>多视角的模型图片（仅3.1版本支持），视角参考值：<br>left：左视图；<br>right：右视图；<br>back：后视图；<br>top：顶视图；<br>bottom：底视图；<br>left_front：左前45°视图；<br>right_front：右前45°视图；</p><p>每个视角仅限制一张图片。<br>●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）<br>●图片分辨率限制：单边分辨率小于5000且大于128。<br>●支持图片格式：支持jpg或png</p>
+        :rtype: list of ViewImage
+        """
+        return self._MultiViewImages
+
+    @MultiViewImages.setter
+    def MultiViewImages(self, MultiViewImages):
+        self._MultiViewImages = MultiViewImages
+
     @property
     def Prompt(self):
         r"""<p>文生3D，3D内容的描述，中文正向提示词。<br>最多支持200个 utf-8 字符。<br>文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。</p>
@@ -2152,6 +2480,13 @@ class SubmitTextureTo3DJobRequest(AbstractModel):
         if params.get("File3D") is not None:
             self._File3D = File3D()
             self._File3D._deserialize(params.get("File3D"))
+        self._Model = params.get("Model")
+        if params.get("MultiViewImages") is not None:
+            self._MultiViewImages = []
+            for item in params.get("MultiViewImages"):
+                obj = ViewImage()
+                obj._deserialize(item)
+                self._MultiViewImages.append(obj)
         self._Prompt = params.get("Prompt")
         if params.get("Image") is not None:
             self._Image = Image()

{tencentcloud_sdk_python_ai3d-3.1.57 → tencentcloud_sdk_python_ai3d-3.1.91}/tencentcloud_sdk_python_ai3d.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ai3d
-Version: 3.1.57
+Version: 3.1.91
 Summary: Tencent Cloud Ai3d SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.57
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.91
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_ai3d-3.1.91/tencentcloud_sdk_python_ai3d.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common<4.0.0,>=3.1.91

tencentcloud_sdk_python_ai3d-3.1.57/tencentcloud_sdk_python_ai3d.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common<4.0.0,>=3.1.57