tccli 3.0.1141.1__py2.py3-none-any.whl → 3.0.1143.1__py2.py3-none-any.whl

tccli/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.1141.1'
+__version__ = '3.0.1143.1'

tccli/services/aiart/aiart_client.py

@@ -69,6 +69,58 @@ def doSubmitTextToImageProJob(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doReplaceBackground(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')], endpoint=g_param["sts_cred_endpoint"]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_WEB_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.AiartClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.ReplaceBackgroundRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.ReplaceBackground(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doSubmitTrainPortraitModelJob(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -549,6 +601,7 @@ MODELS_MAP = {
 
 ACTION_MAP = {
     "SubmitTextToImageProJob": doSubmitTextToImageProJob,
+    "ReplaceBackground": doReplaceBackground,
     "SubmitTrainPortraitModelJob": doSubmitTrainPortraitModelJob,
     "QueryTextToImageProJob": doQueryTextToImageProJob,
     "GenerateAvatar": doGenerateAvatar,

tccli/services/aiart/v20221229/api.json

@@ -35,6 +35,13 @@
       "output": "QueryTrainPortraitModelJobResponse",
       "status": "online"
     },
+    "ReplaceBackground": {
+      "document": "商品背景生成接口根据指定的背景描述 Prompt，将商品图中的原背景替换为自定义的新背景并保留商品主体形象，实现商品背景的自由生成与更换。\n\n商品背景生成默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。",
+      "input": "ReplaceBackgroundRequest",
+      "name": "商品背景生成",
+      "output": "ReplaceBackgroundResponse",
+      "status": "online"
+    },
     "SubmitDrawPortraitJob": {
       "document": "AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。\n每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。\n生成图片分为提交任务和查询任务2个接口。\n- 提交生成写真图片任务：完成训练写真模型后，选择风格模板，提交一个生成写真图片异步任务，根据写真模型 ID 开始生成人物形象在指定风格上的写真图片，获得任务 ID。\n- 查询生成写真图片任务：根据任务 ID 查询生成图片任务的处理状态、处理结果。\n\n提交生成写真图片任务默认提供1个并发任务数。",
       "input": "SubmitDrawPortraitJobRequest",
@@ -653,6 +660,107 @@
       ],
       "type": "object"
     },
+    "ReplaceBackgroundRequest": {
+      "document": "ReplaceBackground请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "商品原图 Url。\n图片限制：单边分辨率小于4000，长宽比在2:5 ~ 5:2之间，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。",
+          "example": "无",
+          "member": "string",
+          "name": "ProductUrl",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "商品 Mask 图 Url，要求背景透明，保留商品主体。\n如果不传，将自动使用内置的商品分割算法得到 Mask。\n支持自定义上传 Mask，如果该参数不为空，则以实际上传的数据为准。\n图片限制：Mask 图必须和商品原图分辨率一致，转成 Base64 字符串后小于 6MB，格式仅支持 png。",
+          "example": "无",
+          "member": "string",
+          "name": "MaskUrl",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "对新背景的文本描述。\n最多支持256个 utf-8 字符，支持中、英文。",
+          "example": "无",
+          "member": "string",
+          "name": "Prompt",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "替换背景后生成的商品图分辨率。\n支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片，不传默认生成1280:1280。\n建议图片比例为1:1、9:16、16:9，生成效果更佳，使用其他比例的生成效果可能不如建议比例。",
+          "example": "1280:1280",
+          "member": "string",
+          "name": "Resolution",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "为生成结果图添加标识的开关，默认为1。\n1：添加标识。\n0：不添加标识。\n其他数值：默认按1处理。\n建议您使用显著标识来提示结果图是 AI 生成的图片。",
+          "example": "无",
+          "member": "int64",
+          "name": "LogoAdd",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "标识内容设置。\n默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
+          "example": "无",
+          "member": "LogoParam",
+          "name": "LogoParam",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。\n生成图分辨率较大时建议选择 url，使用 base64 可能因图片过大导致返回失败。",
+          "example": "base64",
+          "member": "string",
+          "name": "RspImgType",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ReplaceBackgroundResponse": {
+      "document": "ReplaceBackground返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "根据入参 RspImgType 填入不同，返回不同的内容。\n如果传入 base64 则返回生成图 Base64 编码。\n如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。",
+          "example": "无",
+          "member": "string",
+          "name": "ResultImage",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "如果 MaskUrl 未传，则返回使用内置商品分割算法得到的 Mask 结果。",
+          "example": "无",
+          "member": "string",
+          "name": "MaskImage",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "ResultConfig": {
       "document": "返回结果配置",
       "members": [

tccli/services/aiart/v20221229/examples.json

@@ -40,6 +40,14 @@
         "title": "查询成功"
       }
     ],
+    "ReplaceBackground": [
+      {
+        "document": "成功调用并生成图片",
+        "input": "POST / HTTP/1.1\nHost: aiart.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ReplaceBackground\n<公共请求参数>\n\n{\n    \"ProductUrl\": \"https://xxx.com/test.jpg\",\n    \"MaskUrl\": \"https://xxx.com/test.jpg\",\n    \"Prompt\": \"backpack,real picture quality, fabric texture, fine, cartoon\",\n    \"RspImgType\": \"url\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"0d0728ed-f777-4861-aa4b-5a6167daa0b6\",\n        \"ResultImage\": \"https://result.jpg\"\n    }\n}",
+        "title": "成功调用并生成图片"
+      }
+    ],
     "SubmitDrawPortraitJob": [
       {
         "document": "调用成功",

tccli/services/clb/v20180317/api.json

@@ -1569,180 +1569,180 @@
         {
           "disabled": false,
           "document": "负载均衡监听器ID",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "ListenerId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "负载均衡监听器端口",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "ListenerPort",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "监听器后端转发端口",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "InstancePort",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "监听器名称",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "ListenerName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "监听器协议类型",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "Protocol",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "会话保持时间",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "SessionExpire",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "是否开启了健康检查：1（开启）、0（关闭）",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "HealthSwitch",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "响应超时时间",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "TimeOut",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "检查间隔",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "IntervalTime",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "健康阈值",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "HealthNum",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "不健康阈值",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "UnhealthNum",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "传统型公网负载均衡的 HTTP、HTTPS 监听器的请求均衡方法。wrr 表示按权重轮询，ip_hash 表示根据访问的源 IP 进行一致性哈希方式来分发",
-          "example": "",
+          "document": "传统型公网负载均衡 监听器的请求均衡方法。空字符串或wrr 表示按权重轮询，ip_hash 表示根据访问的源 IP 进行一致性哈希方式来分发，least_conn表示按最小连接数。",
+          "example": "无",
           "member": "string",
           "name": "HttpHash",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "传统型公网负载均衡的 HTTP、HTTPS 监听器的健康检查返回码。具体可参考创建监听器中对该字段的解释",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "HttpCode",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "传统型公网负载均衡的 HTTP、HTTPS 监听器的健康检查路径",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "HttpCheckPath",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "传统型公网负载均衡的 HTTPS 监听器的认证方式",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "SSLMode",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "传统型公网负载均衡的 HTTPS 监听器的服务端证书 ID",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "CertId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "传统型公网负载均衡的 HTTPS 监听器的客户端证书 ID",
-          "example": "",
+          "example": "无",
           "member": "string",
           "name": "CertCaId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "监听器的状态，0 表示创建中，1 表示运行中",
-          "example": "",
+          "example": "无",
           "member": "int64",
           "name": "Status",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }