tccli 3.0.1375.1__py2.py3-none-any.whl → 3.0.1377.1__py2.py3-none-any.whl

tccli/services/ioa/v20220601/examples.json

@@ -58,6 +58,14 @@
         "title": "查询账号分组列表"
       }
     ],
+    "DescribeAggrSoftCategorySoftList": [
+      {
+        "document": "1",
+        "input": "POST / HTTP/1.1\nHost: ioa.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeAggrSoftCategorySoftList\n<公共请求参数>\n\n{\n    \"OsType\": 0\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Page\": {\n                \"PageSize\": 1,\n                \"PageNum\": 1,\n                \"PageCount\": 1,\n                \"Total\": 1\n            },\n            \"Total\": 0,\n            \"AggrSoftCategorySoftList\": [\n                {\n                    \"ID\": 0,\n                    \"Name\": \"11\",\n                    \"PiracyRisk\": 0,\n                    \"OsType\": 0,\n                    \"CorpName\": \"11\",\n                    \"InstalledDeviceNum\": 0,\n                    \"PiracyInstalledDeviceNum\": 0,\n                    \"InstalledUserNum\": 0,\n                    \"PiracyInstalledUserNum\": 0,\n                    \"AuthNum\": 0,\n                    \"GenuineRate\": 0\n                }\n            ]\n        },\n        \"RequestId\": \"11\"\n    }\n}",
+        "title": "1"
+      }
+    ],
     "DescribeDLPFileDetectResult": [
       {
         "document": "查询检测结果，结果失败",
@@ -72,6 +80,14 @@
         "title": "检测成功示例"
       }
     ],
+    "DescribeDeviceChildGroups": [
+      {
+        "document": "测试",
+        "input": "POST / HTTP/1.1\nHost: ioa.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeDeviceChildGroups\n<公共请求参数>\n\n{\n    \"ParentId\": 92,\n    \"OsType\": 0\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Items\": [\n                {\n                    \"BindAccount\": 0,\n                    \"Count\": 11,\n                    \"Description\": \"\",\n                    \"FromAuto\": 0,\n                    \"HasIp\": false,\n                    \"Icon\": \"\",\n                    \"Id\": 93,\n                    \"IdPath\": \"92.93\",\n                    \"IsLeaf\": true,\n                    \"Locked\": 0,\n                    \"Name\": \"未分组终端\",\n                    \"NamePath\": \"全网终端.未分组终端\",\n                    \"OsType\": 0,\n                    \"ParentId\": 92,\n                    \"ReadOnly\": false,\n                    \"Sort\": 0,\n                    \"WithIp\": 0\n                },\n                {\n                    \"BindAccount\": 0,\n                    \"Count\": 0,\n                    \"Description\": \"\",\n                    \"FromAuto\": 0,\n                    \"HasIp\": false,\n                    \"Icon\": \"\",\n                    \"Id\": 94,\n                    \"IdPath\": \"92.94\",\n                    \"IsLeaf\": true,\n                    \"Locked\": 0,\n                    \"Name\": \"服务器\",\n                    \"NamePath\": \"全网终端.服务器\",\n                    \"OsType\": 0,\n                    \"ParentId\": 92,\n                    \"ReadOnly\": false,\n                    \"Sort\": 0,\n                    \"WithIp\": 0\n                },\n                {\n                    \"BindAccount\": 0,\n                    \"Count\": 4,\n                    \"Description\": \"\",\n                    \"FromAuto\": 0,\n                    \"HasIp\": false,\n                    \"Icon\": \"\",\n                    \"Id\": 74700,\n                    \"IdPath\": \"92.74700\",\n                    \"IsLeaf\": false,\n                    \"Locked\": 2,\n                    \"Name\": \"TestBone\",\n                    \"NamePath\": \"全网终端.TestBone\",\n                    \"OsType\": 0,\n                    \"ParentId\": 92,\n                    \"ReadOnly\": false,\n                    \"Sort\": 0,\n                    \"WithIp\": 0\n                },\n                {\n                    \"BindAccount\": 1,\n                    \"Count\": 11,\n                    \"Description\": \"\",\n                    \"FromAuto\": 0,\n                    \"HasIp\": false,\n                    \"Icon\": \"\",\n                    \"Id\": 74699,\n                    \"IdPath\": \"92.74699\",\n                    \"IsLeaf\": false,\n                    \"Locked\": 2,\n                    \"Name\": \"Test-New\",\n                    \"NamePath\": \"全网终端.Test-New\",\n                    \"OsType\": 0,\n                    \"ParentId\": 92,\n                    \"ReadOnly\": false,\n                    \"Sort\": 0,\n                    \"WithIp\": 0\n                }\n            ]\n        },\n        \"RequestId\": \"73d262a9-4c0f-4f68-bce2-3718f98c6494\"\n    }\n}",
+        "title": "测试"
+      }
+    ],
     "DescribeDeviceHardwareInfoList": [
       {
         "document": "查询终端硬件信息列表",
@@ -148,16 +164,10 @@
     ],
     "DescribeSoftwareInformation": [
       {
-        "document": "",
-        "input": "POST / HTTP/1.1\nHost: ioa.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeSoftwareInformation\n<公共请求参数>\n\n{\n    \"Mid\": \"123\"\n}",
-        "output": "{\n    \"Response\": {\n        \"RequestId\": \"ada4c0d5-2e2d-4264-93b9-c067a4ddb62e\",\n        \"Data\": {\n            \"Items\": [],\n            \"Page\": {\n                \"Total\": 0,\n                \"PageCount\": 0,\n                \"PageSize\": 1000,\n                \"PageNum\": 1\n            }\n        }\n    }\n}",
-        "title": "查看软件详情列表"
-      },
-      {
-        "document": "获取设备安装的软件数据",
-        "input": "POST / HTTP/1.1\nHost: ioa.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeSoftwareInformation\n<公共请求参数>\n\n{\n    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\"\n}",
-        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Items\": [\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19396,\n                    \"InstallDate\": \"2025/04/03\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"微信\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19396,\n                    \"Version\": \"3.9.12.51\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 23532,\n                    \"InstallDate\": \"2025/04/16\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Google Chrome\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 23532,\n                    \"Version\": \"135.0.7049.95\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 23452,\n                    \"InstallDate\": \"2025/04/16\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Mozilla Firefox (x64 zh-CN)\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 23452,\n                    \"Version\": \"137.0.2\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19198,\n                    \"InstallDate\": \"2025/03/31\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Adobe Acrobat Reader DC MUI\",\n                    \"PiracyRisk\": 2,\n                    \"SoftwareId\": 19198,\n                    \"Version\": \"15.007.20033\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19639,\n                    \"InstallDate\": \"2025/04/01\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"企业微信\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19639,\n                    \"Version\": \"4.1.36.6004\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19197,\n                    \"InstallDate\": \"2025/03/31\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Java 8 Update 441\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19197,\n                    \"Version\": \"8.0.4410.7\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19059,\n                    \"InstallDate\": \"2024/12/13\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"运维审计系统 单点登录组件 2.0\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19059,\n                    \"Version\": \"2.0\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18422,\n                    \"InstallDate\": \"2024/04/10\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"软件管理\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18422,\n                    \"Version\": \"3.1.1442.301\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18595,\n                    \"InstallDate\": \"2025/03/27\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"腾讯 iOA\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18595,\n                    \"Version\": \"210.3.25981.62001\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 21450,\n                    \"InstallDate\": \"2025/04/11\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"向日葵远程控制\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 21450,\n                    \"Version\": \"15.8.3.19819\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18725,\n                    \"InstallDate\": \"2024/04/10\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"企业版软件管家\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18725,\n                    \"Version\": \"101.1.169.1\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19057,\n                    \"InstallDate\": \"2024/03/19\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Wireshark 3.4.6 64-bit\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19057,\n                    \"Version\": \"3.4.6\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19195,\n                    \"InstallDate\": \"2025/03/28\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"ToDesk\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19195,\n                    \"Version\": \"4.7.6.3\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19055,\n                    \"InstallDate\": \"2025/04/11\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"TeamViewer\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19055,\n                    \"Version\": \"15.46.5\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19054,\n                    \"InstallDate\": \"2024/12/13\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"SangforVNC\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19054,\n                    \"Version\": \"7,1,0,2\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19053,\n                    \"InstallDate\": \"2024/08/27\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"RayLink 8.1.0.9\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19053,\n                    \"Version\": \"8.1.0.9\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19052,\n                    \"InstallDate\": \"2024/12/17\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Python Launcher\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19052,\n                    \"Version\": \"3.13.1150.0\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19051,\n                    \"InstallDate\": \"2024/12/13\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Python 3.13.1 (64-bit)\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19051,\n                    \"Version\": \"3.13.1150.0\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19050,\n                    \"InstallDate\": \"2024/06/06\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Npcap 0.9982\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19050,\n                    \"Version\": \"0.9982\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19049,\n                    \"InstallDate\": \"2024/01/24\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Notepad++ (32-bit x86)\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19049,\n                    \"Version\": \"8.1.9\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18414,\n                    \"InstallDate\": \"2025/03/27\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"NGNClient-TAP 1.1\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18414,\n                    \"Version\": \"1.1\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18411,\n                    \"InstallDate\": \"2025/03/28\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Mozilla Maintenance Service\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18411,\n                    \"Version\": \"136.0.1\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19048,\n                    \"InstallDate\": \"2024/03/14\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Microsoft Visual C++ 2015-2019 Redistributable (x64) - 14.28.29910\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19048,\n                    \"Version\": \"14.28.29910.0\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18949,\n                    \"InstallDate\": \"2024/06/06\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Microsoft Visual C++ 2013 Redistributable (x86) - 12.0.21005\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18949,\n                    \"Version\": \"12.0.21005.1\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 22978,\n                    \"InstallDate\": \"2025/04/12\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Microsoft Edge WebView2 Runtime\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 22978,\n                    \"Version\": \"135.0.3179.73\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19046,\n                    \"InstallDate\": \"2024/12/13\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"EasyConnect\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19046,\n                    \"Version\": \"7,6,7,201\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 19045,\n                    \"InstallDate\": \"2025/03/28\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"DACS版本2023H1(43989)S\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 19045,\n                    \"Version\": \"2023H1(43989)S\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 18806,\n                    \"InstallDate\": \"2025/03/31\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"Cloudbase-Init 1.1.2\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 18806,\n                    \"Version\": \"1.1.2.0\"\n                },\n                {\n                    \"CorpName\": \"\",\n                    \"Id\": 6786,\n                    \"InstallDate\": \"2024/01/30\",\n                    \"Mid\": \"B454307F6CA03B56E0CFEC44EABF93BB67E56D6F\",\n                    \"Name\": \"7-Zip 23.01 (x64)\",\n                    \"PiracyRisk\": 0,\n                    \"SoftwareId\": 6786,\n                    \"Version\": \"23.01\"\n                }\n            ],\n            \"Page\": {\n                \"PageCount\": 1,\n                \"PageNum\": 1,\n                \"PageSize\": 1000,\n                \"Total\": 29\n            }\n        },\n        \"RequestId\": \"fc18a581-36b5-4904-90c0-a206583251d9\"\n    }\n}",
-        "title": "获取设备安装软件信息"
+        "document": "测试查询",
+        "input": "POST / HTTP/1.1\nHost: ioa.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeSoftwareInformation\n<公共请求参数>\n\n{\n    \"Mid\": \"1\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Items\": [],\n            \"Page\": {\n                \"PageCount\": 0,\n                \"PageNum\": 1,\n                \"PageSize\": 1000,\n                \"Total\": 0\n            }\n        },\n        \"RequestId\": \"6b01b324-c25a-4297-8fb7-28401163f04a\"\n    }\n}",
+        "title": "测试查询"
       }
     ],
     "DescribeVirtualDevices": [

tccli/services/iotexplorer/v20190423/api.json

@@ -4389,11 +4389,29 @@
         {
           "disabled": false,
           "document": "摘要输出配置",
-          "example": "{\"OutputLang\": \"en\"}",
+          "example": "无",
           "member": "VisionSummaryConfig",
           "name": "SummaryConfig",
           "required": false,
           "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "算法类型，可能取值：\n- `Summary`：视频/图片摘要\n- `ObjectDetect`：目标检测",
+          "example": "Summary",
+          "member": "string",
+          "name": "ServiceType",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "目标检测配置",
+          "example": "无",
+          "member": "VisionObjectDetectConfig",
+          "name": "ObjectDetectConfig",
+          "required": false,
+          "type": "object"
         }
       ],
       "type": "object"
@@ -12418,6 +12436,24 @@
           "name": "SummaryConfig",
           "required": false,
           "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "算法类型，可能取值：\n- `Summary`：视频/图片摘要\n- `ObjectDetect`：目标检测",
+          "example": "Summary",
+          "member": "string",
+          "name": "ServiceType",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "目标检测配置",
+          "example": "无",
+          "member": "VisionObjectDetectConfig",
+          "name": "ObjectDetectConfig",
+          "required": false,
+          "type": "object"
         }
       ],
       "type": "object"
@@ -17289,6 +17325,21 @@
       ],
       "usage": "out"
     },
+    "VisionObjectDetectConfig": {
+      "document": "目标检测配置",
+      "members": [
+        {
+          "disabled": false,
+          "document": "检测类别，可选值：\n- `adult`：成年人\n- `child`：儿童",
+          "example": "[\"adult\", \"child\"]",
+          "member": "string",
+          "name": "DetectTypes",
+          "required": false,
+          "type": "list"
+        }
+      ],
+      "usage": "in"
+    },
     "VisionRecognitionResult": {
       "document": "TWeSee 语义理解结果",
       "members": [

tccli/services/iotexplorer/v20190423/examples.json

@@ -297,9 +297,39 @@
     "CreateTWeSeeRecognitionTask": [
       {
         "document": "",
-        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"dev001\",\n    \"InputURL\": \"hhttps://example.com/video.mp4\",\n    \"CustomId\": \"event-1\",\n    \"EnableSearch\": true,\n    \"StartTimeMs\": 1744389074077,\n    \"EndTimeMs\": 1744389075077\n}",
-        "output": "{\n    \"Response\": {\n        \"RequestId\": \"26083bec-a7bd-491f-b6df-45e7f143638c\",\n        \"TaskId\": \"019625b1-15d6-72d8-a5d6-388b45c92c67\"\n    }\n}",
-        "title": "创建 TWeSee 语义理解任务"
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"f3d7d0eb-d28d-43b0-9b8c-676f785edcb3\",\n        \"TaskId\": \"0198cbc3-8c89-70f2-a07a-5a39b606bc92\"\n    }\n}",
+        "title": "创建视频摘要任务"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"EnableSearch\": true,\n    \"StartTimeMs\": 1755765320366,\n    \"EndTimeMs\": 1755765328366,\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"c7a2ea4f-8a8c-484c-afde-c82005c643fb\",\n        \"TaskId\": \"0198cbc4-eca1-78dd-b8ff-c150b97e081f\"\n    }\n}",
+        "title": "创建视频摘要任务且使该视频可被搜索"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"not_exist_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"IsCustomDevice\": true,\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"988080c5-b74a-4185-a404-f2877e08f97e\",\n        \"TaskId\": \"0198cbc6-e472-79c6-953a-5240495d7640\"\n    }\n}",
+        "title": "使用未创建的设备名创建视频摘要任务"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/image.jpg\",\n    \"InputType\": \"image\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"65dcf25f-385a-4b63-9a60-c99caa28f45a\",\n        \"TaskId\": \"0198cbc8-8680-7b0a-bd4f-4dbff77853cd\"\n    }\n}",
+        "title": "创建图片摘要任务"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"SummaryConfig\": {\n        \"MultiCameraLayout\": \"Vertical,Num=2,Index=0;1\"\n    },\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"35044438-d9b8-42ee-a169-a40d9ecd96cc\",\n        \"TaskId\": \"0198cbc5-e684-7335-a168-593d91d5d89f\"\n    }\n}",
+        "title": "创建视频摘要任务（包含多路摄像头的视频）"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"ObjectDetect\",\n    \"ObjectDetectConfig\": {\n        \"DetectTypes\": [\n            \"adult\",\n            \"child\"\n        ]\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"57096151-fd04-4558-a2f9-280943e9682d\",\n        \"TaskId\": \"0198cbc2-91df-79cd-96ca-0f73ef661632\"\n    }\n}",
+        "title": "创建目标检测任务"
       }
     ],
     "CreateTopicPolicy": [
@@ -1103,11 +1133,53 @@
       }
     ],
     "InvokeTWeSeeRecognitionTask": [
+      {
+        "document": "最大超时时间为 20 秒",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"穿白衣服的人正在公园的小路上行走\"\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务并等待结果返回"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"EnableSearch\": true,\n    \"StartTimeMs\": 1755765320366,\n    \"EndTimeMs\": 1755765328366,\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"穿白衣服的人正在公园的小路上行走\"\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务并等待结果返回（使该视频可被搜索）"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"not_exist_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"IsCustomDevice\": true,\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"穿白衣服的人正在公园的小路上行走\"\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务并等待结果返回（使用未创建的设备名）"
+      },
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/image.jpg\",\n    \"InputType\": \"image\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"穿白衣服的人正在公园的小路上行走\"\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建图片摘要任务并等待结果返回"
+      },
       {
         "document": "",
-        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"dev001\",\n    \"InputURL\": \"hhttps://example.com/video.mp4\",\n    \"CustomId\": \"event-1\",\n    \"EnableSearch\": true,\n    \"StartTimeMs\": 1744389074077,\n    \"EndTimeMs\": 1744389075077\n}",
-        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"26083bec-a7bd-491f-b6df-45e7f143638c\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"一个人在雨中行走\"\n        },\n        \"TaskId\": \"019625b1-15d6-72d8-a5d6-388b45c92c67\"\n    }\n}",
-        "title": "同步执行 TWeSee 语义理解任务"
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"SummaryConfig\": {\n        \"MultiCameraLayout\": \"Vertical,Num=2,Index=0;1\"\n    },\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"person\"\n            ],\n            \"Status\": 3,\n            \"Summary\": \"穿白衣服的人正在公园的小路上行走\"\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务并等待结果返回（包含多路摄像头的视频）"
+      },
+      {
+        "document": "最大超时时间为 20 秒",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"ObjectDetect\",\n    \"ObjectDetectConfig\": {\n        \"DetectTypes\": [\n            \"adult\",\n            \"child\"\n        ]\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"DetectedClassifications\": [\n                \"adult\"\n            ],\n            \"Status\": 3\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建目标检测任务并等待结果返回"
+      },
+      {
+        "document": "下载/读取视频/图片失败时，返回 Status = 2，ErrorCode 字段指出具体错误原因",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": true,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"Result\": {\n            \"ErrorCode\": \"DownloadFailed\",\n            \"Status\": 2\n        },\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务后任务执行失败的情况"
+      },
+      {
+        "document": "任务执行 20 秒仍未返回结果，返回 Completed = false，任务将继续执行，后续可凭 TaskId 通过 DescribeTWeSeeRecognitionTask 重新查询该任务的结果",
+        "input": "POST / HTTP/1.1\nHost: iotexplorer.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: InvokeTWeSeeRecognitionTask\n<公共请求参数>\n\n{\n    \"ProductId\": \"4AHMY9X89Y\",\n    \"DeviceName\": \"example_device_name\",\n    \"InputURL\": \"https://example.qq.com/video.mp4\",\n    \"ServiceType\": \"Summary\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Completed\": false,\n        \"RequestId\": \"dc51b72e-872d-4908-82c3-f2e2794f2f60\",\n        \"TaskId\": \"0198cbcc-d65f-7606-b4ac-664381086005\"\n    }\n}",
+        "title": "创建视频摘要任务后任务执行超时的情况"
       }
     ],
     "InvokeVideosKeywordsAnalyzer": [

tccli/services/iss/iss_client.py

@@ -1369,6 +1369,58 @@ def doDescribeRecordBackupTemplate(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeUserDeviceList(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.IssClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeUserDeviceListRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeUserDeviceList(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 doDescribeVideoBitRate(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -4786,6 +4838,7 @@ ACTION_MAP = {
     "DescribeDomainRegion": doDescribeDomainRegion,
     "ListRecordBackupTemplates": doListRecordBackupTemplates,
     "DescribeRecordBackupTemplate": doDescribeRecordBackupTemplate,
+    "DescribeUserDeviceList": doDescribeUserDeviceList,
     "DescribeVideoBitRate": doDescribeVideoBitRate,
     "CreateVideoDownloadTask": doCreateVideoDownloadTask,
     "DescribeRecordBackupPlan": doDescribeRecordBackupPlan,

tccli/services/iss/v20230517/api.json

@@ -385,6 +385,13 @@
       "output": "DescribeUserDeviceResponse",
       "status": "online"
     },
+    "DescribeUserDeviceList": {
+      "document": "用于批量查询设备详细信息。",
+      "input": "DescribeUserDeviceListRequest",
+      "name": "批量查询设备详情",
+      "output": "DescribeUserDeviceListResponse",
+      "status": "online"
+    },
     "DescribeVideoBitRate": {
       "document": "用于获取视频通道的码率信息",
       "input": "DescribeVideoBitRateRequest",
@@ -4238,6 +4245,22 @@
       ],
       "usage": "out"
     },
+    "DescribeDeviceListData": {
+      "document": "批量查询设备接口返回数据",
+      "members": [
+        {
+          "disabled": false,
+          "document": "设备详情列表",
+          "example": " ",
+          "member": "DescribeDeviceData",
+          "name": "List",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "DescribeDevicePresetData": {
       "document": "查询设备预置位返回数据",
       "members": [
@@ -6017,6 +6040,43 @@
       ],
       "type": "object"
     },
+    "DescribeUserDeviceListRequest": {
+      "document": "DescribeUserDeviceList请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "设备Id列表",
+          "example": "[\"cf40269b-324b-464b-b2aa-************\",\"9e05af80-edbd-4115-a706-************\"]",
+          "member": "string",
+          "name": "DeviceIds",
+          "required": true,
+          "type": "list"
+        }
+      ],
+      "type": "object"
+    },
+    "DescribeUserDeviceListResponse": {
+      "document": "DescribeUserDeviceList返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "返回结果",
+          "example": " ",
+          "member": "DescribeDeviceListData",
+          "name": "Data",
+          "output_required": true,
+          "type": "object",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "DescribeUserDeviceRequest": {
       "document": "DescribeUserDevice请求参数结构体",
       "members": [

tccli/services/iss/v20230517/examples.json

@@ -554,6 +554,14 @@
         "title": "无效的设备Id错误"
       }
     ],
+    "DescribeUserDeviceList": [
+      {
+        "document": "",
+        "input": "POST / HTTP/1.1\nHost: iss.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeUserDeviceList\n<公共请求参数>\n\n{\n    \"DeviceIds\": [\n        \"da238a8c-****-4a5b-****-************\"\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"423da921-fd90-4b07-a1a4-a17b8df24e37\",\n        \"Data\": {\n            \"List\": [\n                {\n                    \"DeviceId\": \"da238a8c-****-4a5b-****-************\",\n                    \"Name\": \"rxxxxx2710\",\n                    \"Code\": \"xxxxx\",\n                    \"Status\": 0,\n                    \"Region\": \"ap-shanghai\",\n                    \"Type\": 1,\n                    \"TransportProtocol\": 0,\n                    \"AccessProtocol\": 1,\n                    \"OrganizationId\": \"1\",\n                    \"Manufacturer\": \"\",\n                    \"Description\": \"\",\n                    \"ClusterId\": \"41xxxxxxxad-4c16-xxx-dxxx3axxxxx90\",\n                    \"ClusterName\": \"xxxx区\",\n                    \"SipId\": \"\",\n                    \"SipDomain\": \"\",\n                    \"SipIp\": \"\",\n                    \"SipPort\": 0,\n                    \"Password\": \"\",\n                    \"PushStreamUrl\": \"\",\n                    \"GatewayId\": \"\",\n                    \"GatewayName\": \"\",\n                    \"ProtocolType\": 0,\n                    \"ProtocolTypeName\": \"\",\n                    \"Ip\": \"\",\n                    \"Port\": 0,\n                    \"Username\": \"\",\n                    \"AudioSwitch\": 1,\n                    \"SubscribeSwitch\": 0,\n                    \"AppName\": \"tesxxxxxx\",\n                    \"StreamName\": \"testsxxxxx\",\n                    \"SilentFrameSwitch\": 0\n                }\n            ]\n        }\n    }\n}",
+        "title": "成功"
+      }
+    ],
     "DescribeVideoBitRate": [
       {
         "document": "正常响应",

tccli/services/live/v20180801/api.json

@@ -19521,7 +19521,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "录制间隔。\n单位秒，默认：1800。\n取值范围：30-7200。\n此参数对 HLS 无效，当录制 HLS 时从推流到断流生成一个文件。",
+          "document": "录制间隔。\n单位秒，默认：1800。\nFLV、MP4取值范围： 60-43200， AAC取值范围： 60-7200 。\n此参数对 HLS 无效，当录制 HLS 时从推流到断流生成一个文件。",
           "example": "400",
           "member": "int64",
           "name": "RecordInterval",

tccli/services/lkeap/v20240522/api.json

@@ -1,7 +1,7 @@
 {
   "actions": {
     "ChatCompletions": {
-      "document": "### 接口功能\n\n调用接口，发起一次对话请求。默认该接口下的单账号QPM上限为15000 ，TPM上限为1200000\n如需使用OpenAI兼容接口， 请参考文档：[Deepseek OpenAI对话接口](https://cloud.tencent.com/document/product/1772/115969)\n\n#### 在线体验\n如您希望在网页内直接体验 DeepSeek 模型对话，推荐您前往[腾讯云智能体开发平台](https://cloud.tencent.com/product/lke)，使用[ DeepSeek 联网助手](https://lke.cloud.tencent.com/webim_exp/#/chat/wQrAwR)。\n\n#### 已支持的模型\n- DeepSeek-V3-0324（model 参数值为**deepseek-v3-0324**）\n    - DeepSeek-V3-0324为671B参数MoE模型，在编程与技术能力、上下文理解与长文本处理等方面优势突出。\n    - 支持128K上下文长度，最大输出16k（不含思维链）。\n    - 注意：相比于DeepSeek-V3，DeepSeek-V3-0324仅更新了模型权重，未增加参数量。总模型大小为685B，其中包括671B的主模型权重和 14B 的多令牌预测（MTP）模块权重，后续均描述主模型参数量。\n- DeepSeek-V3（model 参数值为**deepseek-v3**）\n    - DeepSeek-V3为671B参数MoE模型，在百科知识、数学推理等多项任务上优势突出，评测成绩在主流榜单中位列开源模型榜首。\n    - 支持64K上下文长度，最大输出16k。\n- DeepSeek-R1（model 参数值为**deepseek-r1**）\n    - DeepSeek-R1为671B模型，使用强化学习训练，推理过程包含大量反思和验证，思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异，并为用户展现了完整的思考过程。\n    -  支持96K上下文长度，最大输入长度64k，最大输出16k（默认4k），最大思维链输出长度32k。\n- DeepSeek-R1-0528（model 参数值为**deepseek-r1-0528**）\n    - DeepSeek-R1-0528为671B 模型，架构优化与训练策略升级后，相比上一版本在代码生成、长文本处理和复杂推理领域提升明显。\n    -  支持96K上下文长度，最大输入长度64k，最大输出16k（默认4k），最大思维链输出长度32k。\n\n\n\n### 计费说明\n\n- 标准计费（2025年2月26日起生效），计费模式为后付费小时结，为保证您账户资源的正常使用，请提前[开通后付费](https://console.cloud.tencent.com/lkeap/settings)并及时[充值](https://console.cloud.tencent.com/expense/recharge)。\n\n    -  DeepSeek-R1 模型   | 输入：0.004元/千token | 输出（含思维链）：0.016元/千token\n\n    -  DeepSeek-R1-0528 模型   | 输入：0.004元/千token | 输出（含思维链）：0.016元/千token\n\n    - DeepSeek-V3 模型 | 输入：0.002元/千token | 输出：0.008元/千token\n\n    - DeepSeek-V3-0324 模型 | 输入：0.002元/千token | 输出：0.008元/千token\n\n\n### Openai兼容协议接口\n知识引擎原子能力大模型对话 API 兼容了 OpenAI 的接口规范，这意味着您可以直接使用 OpenAI 官方提供的 SDK 来调用大模型对话接口。您仅需要将 base_url 和 [api_key](https://cloud.tencent.com/document/product/1772/115970) 替换成相关配置，不需要对应用做额外修改，即可无缝将您的应用切换到相应的大模型。请参考文档：[Deepseek OpenAI对话接口](https://cloud.tencent.com/document/product/1772/115969)。\n> base_url：  https://api.lkeap.cloud.tencent.com/v1\n\n> api_key的获取请参考[API KEY管理](https://cloud.tencent.com/document/product/1772/115970)\n\n\n### 快速接入\n1. 完成[实名认证](https://console.cloud.tencent.com/developer/auth)。\n2. 主账户前往[控制台](https://console.cloud.tencent.com/lkeap)开通服务。若为子账户，需由主账号在[权限管理](https://console.cloud.tencent.com/cam)中为子账号授权，关联预设策略，策略名称：QcloudLKEAPFullAccess。\n3. 通过API Explorer[在线调试](https://console.cloud.tencent.com/api/explorer?Product=lkeap&Version=2024-05-22&Action=ChatCompletions)。\n4. 使用[官方 SDK ](https://cloud.tencent.com/document/product/1772/115963#SDK)调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）。\n\n-----------\n\n### SDK调用示例\n通过本地代码调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）：下面的代码以 Python 语言为例，展示如何访问腾讯云上的DeepSeek模型API的样例。\n（1）安装环境\n```\npython3 -m pip install --upgrade tencentcloud-sdk-python-common\npython3 -m pip install --upgrade tencentcloud-sdk-python-lkeap\n```\n\n（2）示例代码\n\n- 其中SecretKey和SecretID需要从腾讯云控制台获取\n\n- 参数params中模型Model字段可以选择“deepseek-r1“和“deepseek-v3”\n\n```\n# -*- coding: utf-8 -*-\nimport json\n\nfrom tencentcloud.common.common_client import CommonClient\nfrom tencentcloud.common import credential\nfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException\nfrom tencentcloud.common.profile.client_profile import ClientProfile\nfrom tencentcloud.common.profile.http_profile import HttpProfile\n\nclass NonStreamResponse(object):\n    def __init__(self):\n        self.response = \"\"\n\n    def _deserialize(self, obj):\n        self.response = json.dumps(obj)\n\ntry:\n    # 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密\n    # 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305\n    # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取\n    cred = credential.Credential(\"\", \"\")\n\n    httpProfile = HttpProfile()\n    httpProfile.endpoint = \"lkeap.tencentcloudapi.com\"\n    httpProfile.reqTimeout = 40000  # 流式接口可能耗时较长\n    clientProfile = ClientProfile()\n    clientProfile.httpProfile = httpProfile\n\n    params = \"{\\\"Model\\\":\\\"deepseek-r1\\\",\\\"Messages\\\":[{\\\"Role\\\":\\\"user\\\",\\\"Content\\\":\\\"你好\\\"}],\\\"Stream\\\":true}\";\n    common_client = CommonClient(\"lkeap\", \"2024-05-22\", cred, \"ap-guangzhou\", profile=clientProfile)\n    resp = common_client._call_and_deserialize(\"ChatCompletions\", json.loads(params), NonStreamResponse)\n    if isinstance(resp, NonStreamResponse):  # 非流式响应\n        print(resp.response)\n    else:  # 流式响应\n        for event in resp:\n            print(event)\nexcept TencentCloudSDKException as err:\n    print(err)\n\n```\n\n**DeepSeek-R1使用建议**\n\n1. 将温度设置在 0.5-0.7 范围内（建议为0.6），以防止无休止的重复或不连贯的输出。\n2. 避免添加system prompt，所有说明都应包含在user prompt中。",
+      "document": "### 接口功能\n\n调用接口，发起一次对话请求。默认该接口下的单账号QPM上限为15000 ，TPM上限为1200000\n如需使用OpenAI兼容接口， 请参考文档：[Deepseek OpenAI对话接口](https://cloud.tencent.com/document/product/1772/115969)\n\n#### 在线体验\n如您希望在网页内直接体验 DeepSeek 模型对话，推荐您前往[腾讯云智能体开发平台](https://cloud.tencent.com/product/lke)，使用[ DeepSeek 联网助手](https://lke.cloud.tencent.com/webim_exp/#/chat/wQrAwR)。\n\n#### 已支持的模型\n- DeepSeek-V3-0324（model 参数值为**deepseek-v3-0324**）\n    - DeepSeek-V3-0324为671B参数MoE模型，在编程与技术能力、上下文理解与长文本处理等方面优势突出。\n    - 支持128K上下文长度，最大输出16k（不含思维链）。\n    - 注意：相比于DeepSeek-V3，DeepSeek-V3-0324仅更新了模型权重，未增加参数量。总模型大小为685B，其中包括671B的主模型权重和 14B 的多令牌预测（MTP）模块权重，后续均描述主模型参数量。\n- DeepSeek-V3（model 参数值为**deepseek-v3**）\n    - DeepSeek-V3为671B参数MoE模型，在百科知识、数学推理等多项任务上优势突出，评测成绩在主流榜单中位列开源模型榜首。\n    - 支持64K上下文长度，最大输出16k。\n- DeepSeek-R1（model 参数值为**deepseek-r1**）\n    - DeepSeek-R1为671B模型，使用强化学习训练，推理过程包含大量反思和验证，思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异，并为用户展现了完整的思考过程。\n    -  支持96K上下文长度，最大输入长度64k，最大输出16k（默认4k），最大思维链输出长度32k。\n- DeepSeek-R1-0528（model 参数值为**deepseek-r1-0528**）\n    - DeepSeek-R1-0528为671B 模型，架构优化与训练策略升级后，相比上一版本在代码生成、长文本处理和复杂推理领域提升明显。\n    -  支持96K上下文长度，最大输入长度64k，最大输出16k（默认4k），最大思维链输出长度32k。\n- DeepSeek-V3.1（model 参数值为 deepseek-v3.1）\n\n    - DeepSeek-V3.1 为685B 参数 MoE 模型，支持混合推理架构，有更高的思考效率和更强的 Agent 能力。目前尚处于限制性开放的试运行阶段，如需申请开通请联系售前客服或商务经理。\n\n\n\n\n### 计费说明\n\n- 标准计费（2025年2月26日起生效），计费模式为后付费小时结，为保证您账户资源的正常使用，请提前[开通后付费](https://console.cloud.tencent.com/lkeap/settings)并及时[充值](https://console.cloud.tencent.com/expense/recharge)。\n\n    -  DeepSeek-R1 模型   | 输入：0.004元/千token | 输出（含思维链）：0.016元/千token\n\n    -  DeepSeek-R1-0528 模型   | 输入：0.004元/千token | 输出（含思维链）：0.016元/千token\n\n    - DeepSeek-V3 模型 | 输入：0.002元/千token | 输出：0.008元/千token\n\n    - DeepSeek-V3-0324 模型 | 输入：0.002元/千token | 输出：0.008元/千token\n\n\n### Openai兼容协议接口\n知识引擎原子能力大模型对话 API 兼容了 OpenAI 的接口规范，这意味着您可以直接使用 OpenAI 官方提供的 SDK 来调用大模型对话接口。您仅需要将 base_url 和 [api_key](https://cloud.tencent.com/document/product/1772/115970) 替换成相关配置，不需要对应用做额外修改，即可无缝将您的应用切换到相应的大模型。请参考文档：[Deepseek OpenAI对话接口](https://cloud.tencent.com/document/product/1772/115969)。\n> base_url：  https://api.lkeap.cloud.tencent.com/v1\n\n> api_key的获取请参考[API KEY管理](https://cloud.tencent.com/document/product/1772/115970)\n\n\n### 快速接入\n1. 完成[实名认证](https://console.cloud.tencent.com/developer/auth)。\n2. 主账户前往[控制台](https://console.cloud.tencent.com/lkeap)开通服务。若为子账户，需由主账号在[权限管理](https://console.cloud.tencent.com/cam)中为子账号授权，关联预设策略，策略名称：QcloudLKEAPFullAccess。\n3. 通过API Explorer[在线调试](https://console.cloud.tencent.com/api/explorer?Product=lkeap&Version=2024-05-22&Action=ChatCompletions)。\n4. 使用[官方 SDK ](https://cloud.tencent.com/document/product/1772/115963#SDK)调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）。\n\n-----------\n\n### SDK调用示例\n通过本地代码调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）：下面的代码以 Python 语言为例，展示如何访问腾讯云上的DeepSeek模型API的样例。\n（1）安装环境\n```\npython3 -m pip install --upgrade tencentcloud-sdk-python-common\npython3 -m pip install --upgrade tencentcloud-sdk-python-lkeap\n```\n\n（2）示例代码\n\n- 其中SecretKey和SecretID需要从腾讯云控制台获取\n\n- 参数params中模型Model字段可以选择“deepseek-r1“和“deepseek-v3”\n\n```\n# -*- coding: utf-8 -*-\nimport json\n\nfrom tencentcloud.common.common_client import CommonClient\nfrom tencentcloud.common import credential\nfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException\nfrom tencentcloud.common.profile.client_profile import ClientProfile\nfrom tencentcloud.common.profile.http_profile import HttpProfile\n\nclass NonStreamResponse(object):\n    def __init__(self):\n        self.response = \"\"\n\n    def _deserialize(self, obj):\n        self.response = json.dumps(obj)\n\ntry:\n    # 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密\n    # 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305\n    # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取\n    cred = credential.Credential(\"\", \"\")\n\n    httpProfile = HttpProfile()\n    httpProfile.endpoint = \"lkeap.tencentcloudapi.com\"\n    httpProfile.reqTimeout = 40000  # 流式接口可能耗时较长\n    clientProfile = ClientProfile()\n    clientProfile.httpProfile = httpProfile\n\n    params = \"{\\\"Model\\\":\\\"deepseek-r1\\\",\\\"Messages\\\":[{\\\"Role\\\":\\\"user\\\",\\\"Content\\\":\\\"你好\\\"}],\\\"Stream\\\":true}\";\n    common_client = CommonClient(\"lkeap\", \"2024-05-22\", cred, \"ap-guangzhou\", profile=clientProfile)\n    resp = common_client._call_and_deserialize(\"ChatCompletions\", json.loads(params), NonStreamResponse)\n    if isinstance(resp, NonStreamResponse):  # 非流式响应\n        print(resp.response)\n    else:  # 流式响应\n        for event in resp:\n            print(event)\nexcept TencentCloudSDKException as err:\n    print(err)\n\n```\n\n**DeepSeek-R1使用建议**\n\n1. 将温度设置在 0.5-0.7 范围内（建议为0.6），以防止无休止的重复或不连贯的输出。\n2. 避免添加system prompt，所有说明都应包含在user prompt中。",
       "input": "ChatCompletionsRequest",
       "name": "DeepSeek API 接口",
       "output": "ChatCompletionsResponse",
@@ -311,7 +311,7 @@
         {
           "disabled": false,
           "document": "聊天上下文信息。\n说明：\n1. 长度最多为 40，按对话时间从旧到新在数组中排列。\n2. Message.Role 可选值：system、user、assistant。\n其中，system 角色可选，如存在则必须位于列表的最开始。user 和 assistant 需交替出现，以 user 提问开始，user 提问结束，Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。\n",
-          "example": "{ \"Role\": \"user\", \"Content\": \"你是谁\" }",
+          "example": "无",
           "member": "Message",
           "name": "Messages",
           "required": true,
@@ -693,7 +693,7 @@
         {
           "disabled": false,
           "document": "说明：文件的 URL 地址。\n备注：文件存储于腾讯云的 URL 可保障更高的下载速度和稳定性，建议文件存储于腾讯云。 非腾讯云存储的 URL 速度和稳定性可能受一定影响。\n参考：[腾讯云COS文档](https://cloud.tencent.com/document/product/436/7749)",
-          "example": "无",
+          "example": "http://examplebucket-1250000000.cos.ap-beijing.myqcloud.com/example.jpg",
           "member": "string",
           "name": "FileUrl",
           "required": false,
@@ -702,7 +702,7 @@
         {
           "disabled": false,
           "document": "文件的 Base64 值。\n支持的文件类型： PNG、JPG、JPEG、PDF、GIF、BMP、TIFF\n支持的文件大小：所下载文件经Base64编码后不超过 8M。文件下载时间不超过 3 秒。\n支持的图片像素：单边介于20-10000px之间。\n文件的 FileUrl、FileBase64 必须提供一个，如果都提供，只使用 FileUrl。",
-          "example": "无",
+          "example": "文件base64值",
           "member": "string",
           "name": "FileBase64",
           "required": false,
@@ -729,7 +729,7 @@
         {
           "disabled": false,
           "document": "说明：创建文档解析任务配置信息。\n备注：可设置结果的返回格式\n默认值：无",
-          "example": "{\"TableResultType\":\"1\"}",
+          "example": "无",
           "member": "CreateReconstructDocumentFlowConfig",
           "name": "Config",
           "required": false,
@@ -844,7 +844,7 @@
         {
           "disabled": true,
           "document": "文件的 Base64 值。\n支持的文件大小：所下载文件经Base64编码后不超过 8M。文件下载时间不超过 3 秒。\n支持的图片像素：单边介于20-10000px之间。\n文件的 FileUrl、FileBase64 必须提供一个，如果都提供，只使用 FileUrl。",
-          "example": "无",
+          "example": "文件base64值",
           "member": "string",
           "name": "FileBase64",
           "required": false,
@@ -871,7 +871,7 @@
         {
           "disabled": false,
           "document": "文档拆分任务的配置信息。\n",
-          "example": "{\"EnableMllm\":true,\"MaxChunkSize\":4800}\t",
+          "example": "无",
           "member": "CreateSplitDocumentFlowConfig",
           "name": "Config",
           "required": false,
@@ -1292,6 +1292,16 @@
           "output_required": false,
           "type": "int",
           "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "文件大小，单位KB",
+          "example": "100",
+          "member": "int64",
+          "name": "FileSize",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
         }
       ],
       "usage": "out"

tccli/services/mna/v20210119/api.json

@@ -3672,7 +3672,7 @@
         },
         {
           "disabled": false,
-          "document": "购买失败后是否回滚（删除）设备，默认true，如果设备绑定了生效中的流量包则不能回滚。",
+          "document": "购买失败后是否回滚（删除）设备，默认false，如果设备绑定了生效中的流量包则不能回滚。",
           "example": "true",
           "member": "bool",
           "name": "RollBack",