tencentcloud-sdk-python-ai3d 3.1.27__tar.gz → 3.1.35__tar.gz

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ai3d
-Version: 3.1.27
+Version: 3.1.35
 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.27
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.35
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/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.27,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.35,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Ai3d SDK for Python',

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.27'
+__version__ = '3.1.35'

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/tencentcloud/ai3d/v20250513/ai3d_client.py

@@ -72,6 +72,30 @@ class Ai3dClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeProfileTo3DJob(self, request):
+        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        :param request: Request instance for DescribeProfileTo3DJob.
+        :type request: :class:`tencentcloud.ai3d.v20250513.models.DescribeProfileTo3DJobRequest`
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.DescribeProfileTo3DJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeProfileTo3DJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeProfileTo3DJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeReduceFaceJob(self, request):
         r"""混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
@@ -285,6 +309,30 @@ class Ai3dClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def SubmitProfileTo3DJob(self, request):
+        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        :param request: Request instance for SubmitProfileTo3DJob.
+        :type request: :class:`tencentcloud.ai3d.v20250513.models.SubmitProfileTo3DJobRequest`
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.SubmitProfileTo3DJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("SubmitProfileTo3DJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.SubmitProfileTo3DJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def SubmitReduceFaceJob(self, request):
         r"""混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/tencentcloud/ai3d/v20250513/ai3d_client_async.py

@@ -61,6 +61,25 @@ class Ai3dClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeProfileTo3DJob(
+            self,
+            request: models.DescribeProfileTo3DJobRequest,
+            opts: Dict = None,
+    ) -> models.DescribeProfileTo3DJobResponse:
+        """
+        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeProfileTo3DJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeProfileTo3DJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def DescribeReduceFaceJob(
             self,
             request: models.DescribeReduceFaceJobRequest,
@@ -229,6 +248,25 @@ class Ai3dClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def SubmitProfileTo3DJob(
+            self,
+            request: models.SubmitProfileTo3DJobRequest,
+            opts: Dict = None,
+    ) -> models.SubmitProfileTo3DJobResponse:
+        """
+        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "SubmitProfileTo3DJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.SubmitProfileTo3DJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def SubmitReduceFaceJob(
             self,
             request: models.SubmitReduceFaceJobRequest,

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/tencentcloud/ai3d/v20250513/models.py

@@ -241,6 +241,135 @@ class DescribeHunyuanTo3DUVJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeProfileTo3DJobRequest(AbstractModel):
+    r"""DescribeProfileTo3DJob请求参数结构体
+
+    """
+
+    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 DescribeProfileTo3DJobResponse(AbstractModel):
+    r"""DescribeProfileTo3DJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Status: 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        :type Status: str
+        :param _ErrorCode: 错误码
+        :type ErrorCode: str
+        :param _ErrorMessage: 错误信息
+        :type ErrorMessage: str
+        :param _ResultFile3Ds: 生成的3D文件数组。
+        :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"""任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        :rtype: str
+        """
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def ErrorCode(self):
+        r"""错误码
+        :rtype: str
+        """
+        return self._ErrorCode
+
+    @ErrorCode.setter
+    def ErrorCode(self, ErrorCode):
+        self._ErrorCode = ErrorCode
+
+    @property
+    def ErrorMessage(self):
+        r"""错误信息
+        :rtype: str
+        """
+        return self._ErrorMessage
+
+    @ErrorMessage.setter
+    def ErrorMessage(self, ErrorMessage):
+        self._ErrorMessage = ErrorMessage
+
+    @property
+    def ResultFile3Ds(self):
+        r"""生成的3D文件数组。
+        :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 DescribeReduceFaceJobRequest(AbstractModel):
     r"""DescribeReduceFaceJob请求参数结构体
 
@@ -1142,6 +1271,9 @@ class SubmitHunyuanTo3DProJobRequest(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _Model: 混元生3D生成模型版本，默认为3.0，可选项：3.0，3.1
+选择3.1版本时，LowPoly参数不可用。
+        :type Model: str
         :param _Prompt: 文生3D，3D内容的描述，中文正向提示词。
 最多支持1024个 utf-8 字符。
 ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
@@ -1160,6 +1292,10 @@ lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不
 left：左视图；
 right：右视图；
 back：后视图；
+top：顶视图（仅3.1版本支持）；
+bottom：底视图（仅3.1版本支持）；
+left_front：左前45°视图（仅3.1版本支持）；
+right_front：右前45°视图（仅3.1版本支持）；
 
 每个视角仅限制一张图片。
 ●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）
@@ -1187,6 +1323,7 @@ quadrilateral: 四边形面与三角形面混合生成。
         :param _ResultFormat: 生成模型的格式，仅限制生成一种格式； 生成模型文件组默认返回obj、glb格式（开启时Geometry参数时，默认为glb格式）； 可选值：STL，USDZ，FBX；
         :type ResultFormat: str
         """
+        self._Model = None
         self._Prompt = None
         self._ImageBase64 = None
         self._ImageUrl = None
@@ -1197,6 +1334,18 @@ quadrilateral: 四边形面与三角形面混合生成。
         self._PolygonType = None
         self._ResultFormat = None
 
+    @property
+    def Model(self):
+        r"""混元生3D生成模型版本，默认为3.0，可选项：3.0，3.1
+选择3.1版本时，LowPoly参数不可用。
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
     @property
     def Prompt(self):
         r"""文生3D，3D内容的描述，中文正向提示词。
@@ -1244,6 +1393,10 @@ lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不
 left：左视图；
 right：右视图；
 back：后视图；
+top：顶视图（仅3.1版本支持）；
+bottom：底视图（仅3.1版本支持）；
+left_front：左前45°视图（仅3.1版本支持）；
+right_front：右前45°视图（仅3.1版本支持）；
 
 每个视角仅限制一张图片。
 ●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）
@@ -1324,6 +1477,7 @@ quadrilateral: 四边形面与三角形面混合生成。
 
 
     def _deserialize(self, params):
+        self._Model = params.get("Model")
         self._Prompt = params.get("Prompt")
         self._ImageBase64 = params.get("ImageBase64")
         self._ImageUrl = params.get("ImageUrl")
@@ -1646,6 +1800,186 @@ class SubmitHunyuanTo3DUVJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class SubmitProfileTo3DJobRequest(AbstractModel):
+    r"""SubmitProfileTo3DJob请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Profile: 真人头像参考图 Base64 数据和参考图 Url。
+- Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
+- 图片限制：单边分辨率小于4096且大于500，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。
+        :type Profile: :class:`tencentcloud.ai3d.v20250513.models.Image`
+        :param _Template: 生成人物模板，参考值：
+
+basketball: 动感球手；
+
+badminton: 羽扬中华；
+
+pingpong: 国球荣耀；
+
+gymnastics:勇攀巅峰；
+
+pilidance: 舞动青春；
+
+tennis: 网球甜心；
+
+athletics: 东方疾风；
+
+footballboykicking1:激情逐风；
+
+footballboykicking2: 绿茵之星；
+
+guitar:甜酷弦音；
+
+footballboy: 足球小将；
+
+skateboard: 滑跃青春；
+
+futuresoilder: 未来战士；
+
+explorer: 逐梦旷野；
+
+beardollgirl:可爱女孩；
+
+bibpantsboy:都市白领；
+
+womansitpose: 职业丽影；
+
+womanstandpose2: 悠闲时光；
+
+mysteriousprincess: 海洋公主；
+
+manstandpose2: 演讲之星；
+        :type Template: str
+        """
+        self._Profile = None
+        self._Template = None
+
+    @property
+    def Profile(self):
+        r"""真人头像参考图 Base64 数据和参考图 Url。
+- Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
+- 图片限制：单边分辨率小于4096且大于500，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。
+        :rtype: :class:`tencentcloud.ai3d.v20250513.models.Image`
+        """
+        return self._Profile
+
+    @Profile.setter
+    def Profile(self, Profile):
+        self._Profile = Profile
+
+    @property
+    def Template(self):
+        r"""生成人物模板，参考值：
+
+basketball: 动感球手；
+
+badminton: 羽扬中华；
+
+pingpong: 国球荣耀；
+
+gymnastics:勇攀巅峰；
+
+pilidance: 舞动青春；
+
+tennis: 网球甜心；
+
+athletics: 东方疾风；
+
+footballboykicking1:激情逐风；
+
+footballboykicking2: 绿茵之星；
+
+guitar:甜酷弦音；
+
+footballboy: 足球小将；
+
+skateboard: 滑跃青春；
+
+futuresoilder: 未来战士；
+
+explorer: 逐梦旷野；
+
+beardollgirl:可爱女孩；
+
+bibpantsboy:都市白领；
+
+womansitpose: 职业丽影；
+
+womanstandpose2: 悠闲时光；
+
+mysteriousprincess: 海洋公主；
+
+manstandpose2: 演讲之星；
+        :rtype: str
+        """
+        return self._Template
+
+    @Template.setter
+    def Template(self, Template):
+        self._Template = Template
+
+
+    def _deserialize(self, params):
+        if params.get("Profile") is not None:
+            self._Profile = Image()
+            self._Profile._deserialize(params.get("Profile"))
+        self._Template = params.get("Template")
+        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 SubmitProfileTo3DJobResponse(AbstractModel):
+    r"""SubmitProfileTo3DJob返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _JobId: 任务ID（有效期24小时）
+        :type JobId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._JobId = None
+        self._RequestId = None
+
+    @property
+    def JobId(self):
+        r"""任务ID（有效期24小时）
+        :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 SubmitReduceFaceJobRequest(AbstractModel):
     r"""SubmitReduceFaceJob请求参数结构体
 

{tencentcloud_sdk_python_ai3d-3.1.27 → tencentcloud_sdk_python_ai3d-3.1.35}/tencentcloud_sdk_python_ai3d.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ai3d
-Version: 3.1.27
+Version: 3.1.35
 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.27
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.35
 
 ============================
 Tencent Cloud SDK for Python

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

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

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

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