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

tencentcloud/ai3d/v20250513/ai3d_client.py

@@ -73,7 +73,7 @@ class Ai3dClient(AbstractClient):
 
 
     def DescribeReduceFaceJob(self, request):
-        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        r"""混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
 
         :param request: Request instance for DescribeReduceFaceJob.
@@ -97,7 +97,7 @@ class Ai3dClient(AbstractClient):
 
 
     def DescribeTextureTo3DJob(self, request):
-        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        r"""混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
 
         :param request: Request instance for DescribeTextureTo3DJob.
@@ -286,7 +286,7 @@ class Ai3dClient(AbstractClient):
 
 
     def SubmitReduceFaceJob(self, request):
-        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        r"""混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
 
         :param request: Request instance for SubmitReduceFaceJob.
@@ -310,7 +310,7 @@ class Ai3dClient(AbstractClient):
 
 
     def SubmitTextureTo3DJob(self, request):
-        r"""混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        r"""混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
 
         :param request: Request instance for SubmitTextureTo3DJob.

tencentcloud/ai3d/v20250513/ai3d_client_async.py

@@ -67,7 +67,7 @@ class Ai3dClient(AbstractClient):
             opts: Dict = None,
     ) -> models.DescribeReduceFaceJobResponse:
         """
-        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
         """
         
@@ -86,7 +86,7 @@ class Ai3dClient(AbstractClient):
             opts: Dict = None,
     ) -> models.DescribeTextureTo3DJobResponse:
         """
-        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
         """
         
@@ -235,7 +235,7 @@ class Ai3dClient(AbstractClient):
             opts: Dict = None,
     ) -> models.SubmitReduceFaceJobResponse:
         """
-        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
         """
         
@@ -254,7 +254,7 @@ class Ai3dClient(AbstractClient):
             opts: Dict = None,
     ) -> models.SubmitTextureTo3DJobResponse:
         """
-        混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。
+        混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
         """
         

tencentcloud/ai3d/v20250513/models.py

@@ -25,7 +25,7 @@ class Convert3DFormatRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _File3D: 3D文件url地址。
+        :param _File3D: 3D文件url地址，模型文件大小≤60m，支持fbx，obj，glb格式3D文件输入。
         :type File3D: str
         :param _Format: 返回的3D文件格式，参考值：STL, USDZ, FBX, MP4, GIF。
         :type Format: str
@@ -35,7 +35,7 @@ class Convert3DFormatRequest(AbstractModel):
 
     @property
     def File3D(self):
-        r"""3D文件url地址。
+        r"""3D文件url地址，模型文件大小≤60m，支持fbx，obj，glb格式3D文件输入。
         :rtype: str
         """
         return self._File3D
@@ -1142,38 +1142,46 @@ 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不能同时存在。
         :type Prompt: str
         :param _ImageBase64: 输入图 Base64 数据。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右)
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :type ImageBase64: str
-        :param _ImageUrl: 输入图Url。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        :param _ImageUrl: 输入图Url
+大小: 单边分辨率要求不小于128，不大于5000，大小≤8m
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :type ImageUrl: str
         :param _MultiViewImages: 多视角的模型图片，视角参考值：
 left：左视图；
 right：右视图；
 back：后视图；
+top：顶视图（仅3.1版本支持）；
+bottom：底视图（仅3.1版本支持）；
+left_front：左前45°视图（仅3.1版本支持）；
+right_front：右前45°视图（仅3.1版本支持）；
 
 每个视角仅限制一张图片。
-●图片大小限制：编码后大小不可超过8M。（base64编码后会大30%左右，建议实际输入图片不超过5m）
+●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）
 ●图片分辨率限制：单边分辨率小于5000且大于128。
 ●支持图片格式：支持jpg或png
         :type MultiViewImages: list of ViewImage
         :param _EnablePBR: 是否开启 PBR材质生成，默认 false。
         :type EnablePBR: bool
         :param _FaceCount: 生成3D模型的面数，默认值为500000。
-可支持生成面数范围，参考值：40000-1500000。
+可支持生成面数范围，参考值：10000-1500000。
+GenerateType中选择LowPoly时，参考值：3000-1500000。
         :type FaceCount: int
         :param _GenerateType: 生成任务类型，默认Normal，参考值：
 Normal：可生成带纹理的几何模型。
-LowPoly：可生成智能减面后的模型。
+LowPoly：可生成智能拓扑后的模型，选择此参数时，面数最低可到达3000面。
 Geometry：可生成不带纹理的几何模型（白模），选择此任务时，EnablePBR参数不生效。
 Sketch：可输入草图或线稿图生成模型，此模式下prompt和ImageUrl/ImageBase64可一起输入。
         :type GenerateType: str
@@ -1183,7 +1191,10 @@ Sketch：可输入草图或线稿图生成模型，此模式下prompt和ImageUrl
 triangle: 三角形面。
 quadrilateral: 四边形面与三角形面混合生成。
         :type PolygonType: str
+        :param _ResultFormat: 生成模型的格式，仅限制生成一种格式； 生成模型文件组默认返回obj、glb格式（开启时Geometry参数时，默认为glb格式）； 可选值：STL，USDZ，FBX；
+        :type ResultFormat: str
         """
+        self._Model = None
         self._Prompt = None
         self._ImageBase64 = None
         self._ImageUrl = None
@@ -1192,6 +1203,19 @@ quadrilateral: 四边形面与三角形面混合生成。
         self._FaceCount = None
         self._GenerateType = None
         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):
@@ -1209,9 +1233,9 @@ ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl
     @property
     def ImageBase64(self):
         r"""输入图 Base64 数据。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右)
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :rtype: str
         """
         return self._ImageBase64
@@ -1222,10 +1246,10 @@ ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl
 
     @property
     def ImageUrl(self):
-        r"""输入图Url。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        r"""输入图Url
+大小: 单边分辨率要求不小于128，不大于5000，大小≤8m
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :rtype: str
         """
         return self._ImageUrl
@@ -1240,9 +1264,13 @@ ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl
 left：左视图；
 right：右视图；
 back：后视图；
+top：顶视图（仅3.1版本支持）；
+bottom：底视图（仅3.1版本支持）；
+left_front：左前45°视图（仅3.1版本支持）；
+right_front：右前45°视图（仅3.1版本支持）；
 
 每个视角仅限制一张图片。
-●图片大小限制：编码后大小不可超过8M。（base64编码后会大30%左右，建议实际输入图片不超过5m）
+●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大30%左右）
 ●图片分辨率限制：单边分辨率小于5000且大于128。
 ●支持图片格式：支持jpg或png
         :rtype: list of ViewImage
@@ -1267,7 +1295,8 @@ back：后视图；
     @property
     def FaceCount(self):
         r"""生成3D模型的面数，默认值为500000。
-可支持生成面数范围，参考值：40000-1500000。
+可支持生成面数范围，参考值：10000-1500000。
+GenerateType中选择LowPoly时，参考值：3000-1500000。
         :rtype: int
         """
         return self._FaceCount
@@ -1280,7 +1309,7 @@ back：后视图；
     def GenerateType(self):
         r"""生成任务类型，默认Normal，参考值：
 Normal：可生成带纹理的几何模型。
-LowPoly：可生成智能减面后的模型。
+LowPoly：可生成智能拓扑后的模型，选择此参数时，面数最低可到达3000面。
 Geometry：可生成不带纹理的几何模型（白模），选择此任务时，EnablePBR参数不生效。
 Sketch：可输入草图或线稿图生成模型，此模式下prompt和ImageUrl/ImageBase64可一起输入。
         :rtype: str
@@ -1306,8 +1335,20 @@ quadrilateral: 四边形面与三角形面混合生成。
     def PolygonType(self, PolygonType):
         self._PolygonType = PolygonType
 
+    @property
+    def ResultFormat(self):
+        r"""生成模型的格式，仅限制生成一种格式； 生成模型文件组默认返回obj、glb格式（开启时Geometry参数时，默认为glb格式）； 可选值：STL，USDZ，FBX；
+        :rtype: str
+        """
+        return self._ResultFormat
+
+    @ResultFormat.setter
+    def ResultFormat(self, ResultFormat):
+        self._ResultFormat = ResultFormat
+
 
     def _deserialize(self, params):
+        self._Model = params.get("Model")
         self._Prompt = params.get("Prompt")
         self._ImageBase64 = params.get("ImageBase64")
         self._ImageUrl = params.get("ImageUrl")
@@ -1321,6 +1362,7 @@ quadrilateral: 四边形面与三角形面混合生成。
         self._FaceCount = params.get("FaceCount")
         self._GenerateType = params.get("GenerateType")
         self._PolygonType = params.get("PolygonType")
+        self._ResultFormat = params.get("ResultFormat")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -1386,14 +1428,14 @@ class SubmitHunyuanTo3DRapidJobRequest(AbstractModel):
 文生3D, ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :type Prompt: str
         :param _ImageBase64: 输入图 Base64 数据。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右)
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :type ImageBase64: str
-        :param _ImageUrl: 输入图Url。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        :param _ImageUrl: 输入图Url
+大小: 单边分辨率要求不小于128，不大于5000，大小≤8m
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :type ImageUrl: str
         :param _ResultFormat: 生成模型的格式，仅限制生成一种格式。
 生成模型文件组默认返回obj格式。
@@ -1427,9 +1469,9 @@ ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl
     @property
     def ImageBase64(self):
         r"""输入图 Base64 数据。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右)
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :rtype: str
         """
         return self._ImageBase64
@@ -1440,10 +1482,10 @@ ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl
 
     @property
     def ImageUrl(self):
-        r"""输入图Url。
-大小：单边分辨率要求不小于128，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过5m）
-格式：jpg，png，jpeg，webp。
-ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        r"""输入图Url
+大小: 单边分辨率要求不小于128，不大于5000，大小≤8m
+格式: jpg，png，jpeg，webp.
+lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。
         :rtype: str
         """
         return self._ImageUrl

tencentcloud/aiart/v20221229/aiart_client.py

@@ -51,6 +51,29 @@ class AiartClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeTemplateToImageJob(self, request):
+        r"""查询图片特效任务
+
+        :param request: Request instance for DescribeTemplateToImageJob.
+        :type request: :class:`tencentcloud.aiart.v20221229.models.DescribeTemplateToImageJobRequest`
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.DescribeTemplateToImageJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeTemplateToImageJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeTemplateToImageJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def GenerateAvatar(self, request):
         r"""百变头像接口将根据输入的人像照片，生成风格百变的头像。
         百变头像默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
@@ -469,6 +492,29 @@ class AiartClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def SubmitTemplateToImageJob(self, request):
+        r"""提交图片特效任务
+
+        :param request: Request instance for SubmitTemplateToImageJob.
+        :type request: :class:`tencentcloud.aiart.v20221229.models.SubmitTemplateToImageJobRequest`
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.SubmitTemplateToImageJobResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("SubmitTemplateToImageJob", params, headers=headers)
+            response = json.loads(body)
+            model = models.SubmitTemplateToImageJobResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def SubmitTextToImageJob(self, request):
         r"""混元生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
         默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。

tencentcloud/aiart/v20221229/aiart_client_async.py

@@ -45,6 +45,24 @@ class AiartClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeTemplateToImageJob(
+            self,
+            request: models.DescribeTemplateToImageJobRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTemplateToImageJobResponse:
+        """
+        查询图片特效任务
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTemplateToImageJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTemplateToImageJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def GenerateAvatar(
             self,
             request: models.GenerateAvatarRequest,
@@ -383,6 +401,24 @@ class AiartClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def SubmitTemplateToImageJob(
+            self,
+            request: models.SubmitTemplateToImageJobRequest,
+            opts: Dict = None,
+    ) -> models.SubmitTemplateToImageJobResponse:
+        """
+        提交图片特效任务
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "SubmitTemplateToImageJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.SubmitTemplateToImageJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def SubmitTextToImageJob(
             self,
             request: models.SubmitTextToImageJobRequest,