tencentcloud-sdk-python 3.0.1413__py2.py3-none-any.whl → 3.0.1415__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1413'
+__version__ = '3.0.1415'

tencentcloud/aiart/v20221229/aiart_client.py

@@ -529,6 +529,54 @@ class AiartClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def TextToImageLite(self, request):
+        """混元文生图接口，基于混元大模型，根据输入的文本描述智能生成图片
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        :param request: Request instance for TextToImageLite.
+        :type request: :class:`tencentcloud.aiart.v20221229.models.TextToImageLiteRequest`
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.TextToImageLiteResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("TextToImageLite", params, headers=headers)
+            response = json.loads(body)
+            model = models.TextToImageLiteResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def TextToImageRapid(self, request):
+        """混元文生图接口，基于混元大模型，根据输入的文本描述智能生成图片
+        默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        :param request: Request instance for TextToImageRapid.
+        :type request: :class:`tencentcloud.aiart.v20221229.models.TextToImageRapidRequest`
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.TextToImageRapidResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("TextToImageRapid", params, headers=headers)
+            response = json.loads(body)
+            model = models.TextToImageRapidResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def UploadTrainPortraitImages(self, request):
         """AI 写真分为上传训练图片、训练写真模型（可选跳过）、生成写真图片3个环节，需要依次调用对应接口。
         本接口用于上传人像图片并指定对应的写真模型 ID。上传的图片要求是同一个人，建议上传单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的图片。

tencentcloud/aiart/v20221229/errorcodes.py

@@ -41,6 +41,9 @@ FAILEDOPERATION_INNERERROR = 'FailedOperation.InnerError'
 # 任务不存在。
 FAILEDOPERATION_JOBNOTEXIST = 'FailedOperation.JobNotExist'
 
+# 审核失败
+FAILEDOPERATION_MODERATIONFAILED = 'FailedOperation.ModerationFailed'
+
 # 整个请求体太大（通常主要是图片）。
 FAILEDOPERATION_REQUESTENTITYTOOLARGE = 'FailedOperation.RequestEntityTooLarge'
 

tencentcloud/aiart/v20221229/models.py

@@ -584,6 +584,57 @@ class GenerateAvatarResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class Image(AbstractModel):
+    """图片
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Base64: 图片Base64
+        :type Base64: str
+        :param _Url: 图片Url
+        :type Url: str
+        """
+        self._Base64 = None
+        self._Url = None
+
+    @property
+    def Base64(self):
+        """图片Base64
+        :rtype: str
+        """
+        return self._Base64
+
+    @Base64.setter
+    def Base64(self, Base64):
+        self._Base64 = Base64
+
+    @property
+    def Url(self):
+        """图片Url
+        :rtype: str
+        """
+        return self._Url
+
+    @Url.setter
+    def Url(self, Url):
+        self._Url = Url
+
+
+    def _deserialize(self, params):
+        self._Base64 = params.get("Base64")
+        self._Url = params.get("Url")
+        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 ImageInpaintingRemovalRequest(AbstractModel):
     """ImageInpaintingRemoval请求参数结构体
 
@@ -3786,6 +3837,525 @@ class SubmitTrainPortraitModelJobResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class TextToImageLiteRequest(AbstractModel):
+    """TextToImageLite请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Prompt: 文本描述。将根据输入的文本智能生成与之相关的图像。
+不能为空，推荐使用中文。最多可传1024个 utf-8 字符。
+        :type Prompt: str
+        :param _NegativePrompt: 反向提示词。 减少生成结果中出现描述内容。
+推荐使用中文。最多可传1024个 utf-8 字符。
+        :type NegativePrompt: str
+        :param _Resolution: 生成图分辨率，默认1024:1024。
+支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。
+支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。
+        :type Resolution: str
+        :param _Seed: 随机种子，默认随机。
+0：随机种子生成。
+不传：随机种子生成。
+正数：固定种子生成。
+
+        :type Seed: int
+        :param _LogoAdd: 为生成结果图添加标识的开关，默认为1。
+1：添加标识。
+0：不添加标识。
+其他数值：默认按1处理。
+建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        :type LogoAdd: int
+        :param _LogoParam: 标识内容设置。
+默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        :type LogoParam: :class:`tencentcloud.aiart.v20221229.models.LogoParam`
+        :param _RspImgType: 返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。
+        :type RspImgType: str
+        """
+        self._Prompt = None
+        self._NegativePrompt = None
+        self._Resolution = None
+        self._Seed = None
+        self._LogoAdd = None
+        self._LogoParam = None
+        self._RspImgType = None
+
+    @property
+    def Prompt(self):
+        """文本描述。将根据输入的文本智能生成与之相关的图像。
+不能为空，推荐使用中文。最多可传1024个 utf-8 字符。
+        :rtype: str
+        """
+        return self._Prompt
+
+    @Prompt.setter
+    def Prompt(self, Prompt):
+        self._Prompt = Prompt
+
+    @property
+    def NegativePrompt(self):
+        """反向提示词。 减少生成结果中出现描述内容。
+推荐使用中文。最多可传1024个 utf-8 字符。
+        :rtype: str
+        """
+        return self._NegativePrompt
+
+    @NegativePrompt.setter
+    def NegativePrompt(self, NegativePrompt):
+        self._NegativePrompt = NegativePrompt
+
+    @property
+    def Resolution(self):
+        """生成图分辨率，默认1024:1024。
+支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。
+支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。
+        :rtype: str
+        """
+        return self._Resolution
+
+    @Resolution.setter
+    def Resolution(self, Resolution):
+        self._Resolution = Resolution
+
+    @property
+    def Seed(self):
+        """随机种子，默认随机。
+0：随机种子生成。
+不传：随机种子生成。
+正数：固定种子生成。
+
+        :rtype: int
+        """
+        return self._Seed
+
+    @Seed.setter
+    def Seed(self, Seed):
+        self._Seed = Seed
+
+    @property
+    def LogoAdd(self):
+        """为生成结果图添加标识的开关，默认为1。
+1：添加标识。
+0：不添加标识。
+其他数值：默认按1处理。
+建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        :rtype: int
+        """
+        return self._LogoAdd
+
+    @LogoAdd.setter
+    def LogoAdd(self, LogoAdd):
+        self._LogoAdd = LogoAdd
+
+    @property
+    def LogoParam(self):
+        """标识内容设置。
+默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.LogoParam`
+        """
+        return self._LogoParam
+
+    @LogoParam.setter
+    def LogoParam(self, LogoParam):
+        self._LogoParam = LogoParam
+
+    @property
+    def RspImgType(self):
+        """返回图像方式（base64 或 url），二选一，默认为 base64。url 有效期为1小时。
+        :rtype: str
+        """
+        return self._RspImgType
+
+    @RspImgType.setter
+    def RspImgType(self, RspImgType):
+        self._RspImgType = RspImgType
+
+
+    def _deserialize(self, params):
+        self._Prompt = params.get("Prompt")
+        self._NegativePrompt = params.get("NegativePrompt")
+        self._Resolution = params.get("Resolution")
+        self._Seed = params.get("Seed")
+        self._LogoAdd = params.get("LogoAdd")
+        if params.get("LogoParam") is not None:
+            self._LogoParam = LogoParam()
+            self._LogoParam._deserialize(params.get("LogoParam"))
+        self._RspImgType = params.get("RspImgType")
+        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 TextToImageLiteResponse(AbstractModel):
+    """TextToImageLite返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _ResultImage: 根据入参 RspImgType 填入不同，返回不同的内容。
+如果传入 base64 则返回生成图 Base64 编码。
+如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
+        :type ResultImage: str
+        :param _Seed: Seed
+        :type Seed: int
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._ResultImage = None
+        self._Seed = None
+        self._RequestId = None
+
+    @property
+    def ResultImage(self):
+        """根据入参 RspImgType 填入不同，返回不同的内容。
+如果传入 base64 则返回生成图 Base64 编码。
+如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
+        :rtype: str
+        """
+        return self._ResultImage
+
+    @ResultImage.setter
+    def ResultImage(self, ResultImage):
+        self._ResultImage = ResultImage
+
+    @property
+    def Seed(self):
+        """Seed
+        :rtype: int
+        """
+        return self._Seed
+
+    @Seed.setter
+    def Seed(self, Seed):
+        self._Seed = Seed
+
+    @property
+    def RequestId(self):
+        """唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._ResultImage = params.get("ResultImage")
+        self._Seed = params.get("Seed")
+        self._RequestId = params.get("RequestId")
+
+
+class TextToImageRapidRequest(AbstractModel):
+    """TextToImageRapid请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Prompt: 文本描述。
+算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。
+不能为空，推荐使用中文。最多可传256个 utf-8 字符。
+        :type Prompt: str
+        :param _Resolution: 生成图分辨率，默认1024:1024。
+支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。
+支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。
+        :type Resolution: str
+        :param _Seed: 随机种子，默认随机。
+0：随机种子生成。
+不传：随机种子生成。
+正数：固定种子生成。
+
+        :type Seed: int
+        :param _Image: 参考图。
+
+- Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
+- 当传入Image参数时，Style和Resolution参数不生效，输出图分辨率将保持Image传入图分辨率。
+- 图片限制：单边分辨率大于128且小于2048；图片小于6M；格式支持 jpg、jpeg、png、bmp、tiff、webp。
+        :type Image: :class:`tencentcloud.aiart.v20221229.models.Image`
+        :param _Style: 生成的图片风格，参考值：
+
+1：宫崎骏风格；
+2：新海诚风格；
+3：去旅行风格；
+4：水彩风格；
+5：像素风格；
+6：童话世界风格；
+7：奇趣卡通风格；
+8：赛博朋克风格；
+9：极简风格；
+10：复古风格；
+11：暗黑系风格；
+12：波普风风格；
+13：糖果色风格；
+14：胶片电影风格；
+15：素描风格；
+16：水墨画风格；
+17：油画风格；
+18：粉笔风格；
+19：粘土风格；
+20：毛毡风格；
+21：刺绣风格；
+22：彩铅风格；
+23：莫奈风格；
+24：毕加索风格；
+25：穆夏风格；
+26：古风二次元风格；
+27：都市二次元风格；
+28：悬疑风格；
+29：校园风格；
+30：都市异能风格。
+        :type Style: str
+        :param _LogoAdd: 为生成结果图添加标识的开关，默认为1。
+1：添加标识。
+0：不添加标识。
+其他数值：默认按1处理。
+建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        :type LogoAdd: int
+        :param _LogoParam: 标识内容设置。
+默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        :type LogoParam: :class:`tencentcloud.aiart.v20221229.models.LogoParam`
+        :param _RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        :type RspImgType: str
+        """
+        self._Prompt = None
+        self._Resolution = None
+        self._Seed = None
+        self._Image = None
+        self._Style = None
+        self._LogoAdd = None
+        self._LogoParam = None
+        self._RspImgType = None
+
+    @property
+    def Prompt(self):
+        """文本描述。
+算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。
+不能为空，推荐使用中文。最多可传256个 utf-8 字符。
+        :rtype: str
+        """
+        return self._Prompt
+
+    @Prompt.setter
+    def Prompt(self, Prompt):
+        self._Prompt = Prompt
+
+    @property
+    def Resolution(self):
+        """生成图分辨率，默认1024:1024。
+支持的图像宽高比例: 1:1，3:4，4:3，9:16，16:9。
+支持的长边分辨率: 160，200，225，258，512，520，608，768，1024，1080，1280，1600，1620，1920，2048，2400，2560，2592，3440，3840，4096。
+        :rtype: str
+        """
+        return self._Resolution
+
+    @Resolution.setter
+    def Resolution(self, Resolution):
+        self._Resolution = Resolution
+
+    @property
+    def Seed(self):
+        """随机种子，默认随机。
+0：随机种子生成。
+不传：随机种子生成。
+正数：固定种子生成。
+
+        :rtype: int
+        """
+        return self._Seed
+
+    @Seed.setter
+    def Seed(self, Seed):
+        self._Seed = Seed
+
+    @property
+    def Image(self):
+        """参考图。
+
+- Base64 和 Url 必须提供一个，如果都提供以 Url 为准。
+- 当传入Image参数时，Style和Resolution参数不生效，输出图分辨率将保持Image传入图分辨率。
+- 图片限制：单边分辨率大于128且小于2048；图片小于6M；格式支持 jpg、jpeg、png、bmp、tiff、webp。
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.Image`
+        """
+        return self._Image
+
+    @Image.setter
+    def Image(self, Image):
+        self._Image = Image
+
+    @property
+    def Style(self):
+        """生成的图片风格，参考值：
+
+1：宫崎骏风格；
+2：新海诚风格；
+3：去旅行风格；
+4：水彩风格；
+5：像素风格；
+6：童话世界风格；
+7：奇趣卡通风格；
+8：赛博朋克风格；
+9：极简风格；
+10：复古风格；
+11：暗黑系风格；
+12：波普风风格；
+13：糖果色风格；
+14：胶片电影风格；
+15：素描风格；
+16：水墨画风格；
+17：油画风格；
+18：粉笔风格；
+19：粘土风格；
+20：毛毡风格；
+21：刺绣风格；
+22：彩铅风格；
+23：莫奈风格；
+24：毕加索风格；
+25：穆夏风格；
+26：古风二次元风格；
+27：都市二次元风格；
+28：悬疑风格；
+29：校园风格；
+30：都市异能风格。
+        :rtype: str
+        """
+        return self._Style
+
+    @Style.setter
+    def Style(self, Style):
+        self._Style = Style
+
+    @property
+    def LogoAdd(self):
+        """为生成结果图添加标识的开关，默认为1。
+1：添加标识。
+0：不添加标识。
+其他数值：默认按1处理。
+建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+        :rtype: int
+        """
+        return self._LogoAdd
+
+    @LogoAdd.setter
+    def LogoAdd(self, LogoAdd):
+        self._LogoAdd = LogoAdd
+
+    @property
+    def LogoParam(self):
+        """标识内容设置。
+默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        :rtype: :class:`tencentcloud.aiart.v20221229.models.LogoParam`
+        """
+        return self._LogoParam
+
+    @LogoParam.setter
+    def LogoParam(self, LogoParam):
+        self._LogoParam = LogoParam
+
+    @property
+    def RspImgType(self):
+        """返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        :rtype: str
+        """
+        return self._RspImgType
+
+    @RspImgType.setter
+    def RspImgType(self, RspImgType):
+        self._RspImgType = RspImgType
+
+
+    def _deserialize(self, params):
+        self._Prompt = params.get("Prompt")
+        self._Resolution = params.get("Resolution")
+        self._Seed = params.get("Seed")
+        if params.get("Image") is not None:
+            self._Image = Image()
+            self._Image._deserialize(params.get("Image"))
+        self._Style = params.get("Style")
+        self._LogoAdd = params.get("LogoAdd")
+        if params.get("LogoParam") is not None:
+            self._LogoParam = LogoParam()
+            self._LogoParam._deserialize(params.get("LogoParam"))
+        self._RspImgType = params.get("RspImgType")
+        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 TextToImageRapidResponse(AbstractModel):
+    """TextToImageRapid返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _ResultImage: 根据入参 RspImgType 填入不同，返回不同的内容。
+如果传入 base64 则返回生成图 Base64 编码。
+如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
+        :type ResultImage: str
+        :param _Seed: Seed
+        :type Seed: int
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._ResultImage = None
+        self._Seed = None
+        self._RequestId = None
+
+    @property
+    def ResultImage(self):
+        """根据入参 RspImgType 填入不同，返回不同的内容。
+如果传入 base64 则返回生成图 Base64 编码。
+如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
+        :rtype: str
+        """
+        return self._ResultImage
+
+    @ResultImage.setter
+    def ResultImage(self, ResultImage):
+        self._ResultImage = ResultImage
+
+    @property
+    def Seed(self):
+        """Seed
+        :rtype: int
+        """
+        return self._Seed
+
+    @Seed.setter
+    def Seed(self, Seed):
+        self._Seed = Seed
+
+    @property
+    def RequestId(self):
+        """唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._ResultImage = params.get("ResultImage")
+        self._Seed = params.get("Seed")
+        self._RequestId = params.get("RequestId")
+
+
 class TextToImageRequest(AbstractModel):
     """TextToImage请求参数结构体