tccli 3.0.1266.1__py2.py3-none-any.whl → 3.0.1268.1__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. tccli/__init__.py +1 -1
  2. tccli/services/antiddos/v20200309/api.json +206 -142
  3. tccli/services/antiddos/v20200309/examples.json +17 -17
  4. tccli/services/bi/v20220105/api.json +1 -1
  5. tccli/services/cbs/v20170312/api.json +18 -0
  6. tccli/services/ccc/v20200210/api.json +2 -2
  7. tccli/services/cdn/v20180606/api.json +3 -0
  8. tccli/services/cloudaudit/v20190319/api.json +3 -3
  9. tccli/services/cloudaudit/v20190319/examples.json +1 -1
  10. tccli/services/cwp/v20180228/api.json +11 -1
  11. tccli/services/emr/v20190103/api.json +11 -1
  12. tccli/services/ess/ess_client.py +159 -0
  13. tccli/services/ess/v20201111/api.json +350 -2
  14. tccli/services/ess/v20201111/examples.json +36 -0
  15. tccli/services/gme/v20180711/api.json +77 -39
  16. tccli/services/gme/v20180711/examples.json +2 -2
  17. tccli/services/hunyuan/v20230901/api.json +5 -5
  18. tccli/services/hunyuan/v20230901/examples.json +6 -6
  19. tccli/services/lcic/lcic_client.py +61 -8
  20. tccli/services/lcic/v20220817/api.json +71 -18
  21. tccli/services/lcic/v20220817/examples.json +8 -0
  22. tccli/services/lighthouse/v20200324/api.json +14 -14
  23. tccli/services/live/v20180801/api.json +60 -4
  24. tccli/services/lkeap/v20240522/api.json +3 -3
  25. tccli/services/mps/v20190612/api.json +40 -0
  26. tccli/services/ocr/v20181119/api.json +63 -24
  27. tccli/services/postgres/v20170312/api.json +1 -1
  28. tccli/services/redis/v20180412/api.json +40 -40
  29. tccli/services/rum/v20210622/api.json +1 -1
  30. tccli/services/smh/v20210712/api.json +50 -30
  31. tccli/services/smop/v20201203/api.json +34 -34
  32. tccli/services/tdmq/v20200217/api.json +97 -0
  33. tccli/services/teo/v20220901/api.json +3 -3
  34. tccli/services/thpc/v20230321/api.json +19 -0
  35. tccli/services/trocket/v20230308/api.json +130 -11
  36. tccli/services/vms/v20200902/api.json +2 -2
  37. tccli/services/vpc/v20170312/api.json +1012 -17
  38. tccli/services/vpc/v20170312/examples.json +100 -4
  39. tccli/services/vpc/vpc_client.py +690 -54
  40. tccli/services/wedata/v20210820/api.json +108 -12
  41. tccli/services/wedata/v20210820/examples.json +3 -3
  42. {tccli-3.0.1266.1.dist-info → tccli-3.0.1268.1.dist-info}/METADATA +2 -2
  43. {tccli-3.0.1266.1.dist-info → tccli-3.0.1268.1.dist-info}/RECORD +46 -46
  44. {tccli-3.0.1266.1.dist-info → tccli-3.0.1268.1.dist-info}/WHEEL +0 -0
  45. {tccli-3.0.1266.1.dist-info → tccli-3.0.1268.1.dist-info}/entry_points.txt +0 -0
  46. {tccli-3.0.1266.1.dist-info → tccli-3.0.1268.1.dist-info}/license_files/LICENSE +0 -0
@@ -57,9 +57,9 @@
57
57
  "status": "online"
58
58
  },
59
59
  "BindDocumentToRoom": {
60
- "document": "绑定文档到房间",
60
+ "document": "功能概述\n本接口提供教学场景下的课程文档预绑定能力,支持将课件课堂ID进行关联映射,实现课件的自动化预加载。\n\n应用场景建议\n\n绑定时机\n推荐在创建课堂预约阶段同步完成文档绑定操作,确保课件资源在课堂开始前完成上传。\n\n接口限制与频控策略\n\n频控维度\n开发者账号维度限频\n默认频控阈值为20 QPS(每秒请求次数)\n\n最佳实践建议\n\n重试策略\n当触发限频错误时,建议采用以下策略:\n启用退避重试机制(建议使用指数退避算法)\n初始重试间隔不低于500ms\n最大重试次数不超过3次",
61
61
  "input": "BindDocumentToRoomRequest",
62
- "name": "绑定文档到房间",
62
+ "name": "绑定课件到房间",
63
63
  "output": "BindDocumentToRoomResponse",
64
64
  "status": "online"
65
65
  },
@@ -252,6 +252,13 @@
252
252
  "output": "DescribeRecordStreamResponse",
253
253
  "status": "online"
254
254
  },
255
+ "DescribeRecordTask": {
256
+ "document": "查询录制任务ID",
257
+ "input": "DescribeRecordTaskRequest",
258
+ "name": "查询录制任务ID",
259
+ "output": "DescribeRecordTaskResponse",
260
+ "status": "online"
261
+ },
255
262
  "DescribeRoom": {
256
263
  "document": "获取房间配置信息",
257
264
  "input": "DescribeRoomRequest",
@@ -3509,6 +3516,52 @@
3509
3516
  ],
3510
3517
  "type": "object"
3511
3518
  },
3519
+ "DescribeRecordTaskRequest": {
3520
+ "document": "DescribeRecordTask请求参数结构体",
3521
+ "members": [
3522
+ {
3523
+ "disabled": false,
3524
+ "document": "学校ID",
3525
+ "example": "3456721",
3526
+ "member": "uint64",
3527
+ "name": "SdkAppId",
3528
+ "required": true,
3529
+ "type": "int"
3530
+ },
3531
+ {
3532
+ "disabled": false,
3533
+ "document": "房间ID",
3534
+ "example": "9090",
3535
+ "member": "uint64",
3536
+ "name": "RoomId",
3537
+ "required": true,
3538
+ "type": "int"
3539
+ }
3540
+ ],
3541
+ "type": "object"
3542
+ },
3543
+ "DescribeRecordTaskResponse": {
3544
+ "document": "DescribeRecordTask返回参数结构体",
3545
+ "members": [
3546
+ {
3547
+ "disabled": false,
3548
+ "document": "任务ID",
3549
+ "example": "2432324323",
3550
+ "member": "string",
3551
+ "name": "TaskId",
3552
+ "output_required": false,
3553
+ "type": "string",
3554
+ "value_allowed_null": false
3555
+ },
3556
+ {
3557
+ "document": "唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。",
3558
+ "member": "string",
3559
+ "name": "RequestId",
3560
+ "type": "string"
3561
+ }
3562
+ ],
3563
+ "type": "object"
3564
+ },
3512
3565
  "DescribeRoomForbiddenUserRequest": {
3513
3566
  "document": "DescribeRoomForbiddenUser请求参数结构体",
3514
3567
  "members": [
@@ -3989,23 +4042,23 @@
3989
4042
  },
3990
4043
  {
3991
4044
  "disabled": false,
3992
- "document": "秒级unix时间戳,实际房间开始时间。\n注意:此字段可能返回 null,表示取不到有效值。",
4045
+ "document": "秒级unix时间戳,实际房间开始时间。",
3993
4046
  "example": "1675677337",
3994
4047
  "member": "uint64",
3995
4048
  "name": "RealStartTime",
3996
4049
  "output_required": true,
3997
4050
  "type": "int",
3998
- "value_allowed_null": true
4051
+ "value_allowed_null": false
3999
4052
  },
4000
4053
  {
4001
4054
  "disabled": false,
4002
- "document": "秒级unix时间戳,实际房间结束时间。\n注意:此字段可能返回 null,表示取不到有效值。",
4055
+ "document": "秒级unix时间戳,实际房间结束时间。",
4003
4056
  "example": "1675677337",
4004
4057
  "member": "uint64",
4005
4058
  "name": "RealEndTime",
4006
4059
  "output_required": true,
4007
4060
  "type": "int",
4008
- "value_allowed_null": true
4061
+ "value_allowed_null": false
4009
4062
  },
4010
4063
  {
4011
4064
  "disabled": false,
@@ -4320,13 +4373,13 @@
4320
4373
  },
4321
4374
  {
4322
4375
  "disabled": false,
4323
- "document": "用户在客户系统的Id\n注意:此字段可能返回 null,表示取不到有效值。",
4376
+ "document": "用户在客户系统的Id",
4324
4377
  "example": "2CvDgjRNjylAsBZB4iZc0F6koXe",
4325
4378
  "member": "string",
4326
4379
  "name": "OriginId",
4327
4380
  "output_required": true,
4328
4381
  "type": "string",
4329
- "value_allowed_null": true
4382
+ "value_allowed_null": false
4330
4383
  },
4331
4384
  {
4332
4385
  "document": "唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。",
@@ -4826,13 +4879,13 @@
4826
4879
  },
4827
4880
  {
4828
4881
  "disabled": false,
4829
- "document": "详细事件内容。包含相应的类型、发生的时间戳。\n注意:此字段可能返回 null,表示取不到有效值。",
4882
+ "document": "详细事件内容。包含相应的类型、发生的时间戳。",
4830
4883
  "example": "[{\"Timestamp\":1234,\"EventType\":\"RoomStart\",\"EventData\":{\"RoomId\":123456}}]",
4831
4884
  "member": "EventInfo",
4832
4885
  "name": "Events",
4833
4886
  "output_required": true,
4834
4887
  "type": "list",
4835
- "value_allowed_null": true
4888
+ "value_allowed_null": false
4836
4889
  },
4837
4890
  {
4838
4891
  "document": "唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。",
@@ -5019,43 +5072,43 @@
5019
5072
  "members": [
5020
5073
  {
5021
5074
  "disabled": false,
5022
- "document": "老师视频区域的水印参数配置\n注意:此字段可能返回 null,表示取不到有效值。",
5075
+ "document": "老师视频区域的水印参数配置",
5023
5076
  "example": "无",
5024
5077
  "member": "WatermarkConfig",
5025
5078
  "name": "TeacherLogo",
5026
5079
  "output_required": true,
5027
5080
  "type": "object",
5028
- "value_allowed_null": true
5081
+ "value_allowed_null": false
5029
5082
  },
5030
5083
  {
5031
5084
  "disabled": false,
5032
- "document": "白板区域的水印参数配置\n注意:此字段可能返回 null,表示取不到有效值。",
5085
+ "document": "白板区域的水印参数配置",
5033
5086
  "example": "无",
5034
5087
  "member": "WatermarkConfig",
5035
5088
  "name": "BoardLogo",
5036
5089
  "output_required": true,
5037
5090
  "type": "object",
5038
- "value_allowed_null": true
5091
+ "value_allowed_null": false
5039
5092
  },
5040
5093
  {
5041
5094
  "disabled": false,
5042
- "document": "背景图片配置\n注意:此字段可能返回 null,表示取不到有效值。",
5095
+ "document": "背景图片配置",
5043
5096
  "example": "无",
5044
5097
  "member": "BackgroundPictureConfig",
5045
5098
  "name": "BackgroundPicture",
5046
5099
  "output_required": true,
5047
5100
  "type": "object",
5048
- "value_allowed_null": true
5101
+ "value_allowed_null": false
5049
5102
  },
5050
5103
  {
5051
5104
  "disabled": false,
5052
- "document": "文字水印配置\n注意:此字段可能返回 null,表示取不到有效值。",
5105
+ "document": "文字水印配置",
5053
5106
  "example": "无",
5054
5107
  "member": "TextMarkConfig",
5055
5108
  "name": "Text",
5056
5109
  "output_required": true,
5057
5110
  "type": "object",
5058
- "value_allowed_null": true
5111
+ "value_allowed_null": false
5059
5112
  },
5060
5113
  {
5061
5114
  "document": "唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。",
@@ -306,6 +306,14 @@
306
306
  "title": "DescribeRecordStream"
307
307
  }
308
308
  ],
309
+ "DescribeRecordTask": [
310
+ {
311
+ "document": "",
312
+ "input": "POST / HTTP/1.1\nHost: lcic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeRecordTask\n<公共请求参数>\n\n{\n \"SdkAppId\": 38901738,\n \"RoomId\": 567825\n}",
313
+ "output": "{\n \"Response\": {\n \"RequestId\": \"743fff05-5133b-4c4e-a572-99917288eded3\",\n \"TaskId\": \"d4ckjh5-9b1e-5648-ab79-0123khjk6b\"\n }\n}",
314
+ "title": "查询录制任务ID"
315
+ }
316
+ ],
309
317
  "DescribeRoom": [
310
318
  {
311
319
  "document": "获取房间信息",
@@ -7323,13 +7323,13 @@
7323
7323
  },
7324
7324
  {
7325
7325
  "disabled": false,
7326
- "document": "折扣梯度详情,每个梯度包含的信息有:时长,折扣数,总价,折扣价,折扣详情(用户折扣、官网折扣、最终折扣)。\n注意:此字段可能返回 null,表示取不到有效值。",
7326
+ "document": "折扣梯度详情,每个梯度包含的信息有:时长,折扣数,总价,折扣价,折扣详情(用户折扣、官网折扣、最终折扣)。",
7327
7327
  "example": "无",
7328
7328
  "member": "DiscountDetail",
7329
7329
  "name": "DiscountDetail",
7330
7330
  "output_required": true,
7331
7331
  "type": "list",
7332
- "value_allowed_null": true
7332
+ "value_allowed_null": false
7333
7333
  }
7334
7334
  ],
7335
7335
  "usage": "out"
@@ -7411,43 +7411,43 @@
7411
7411
  "members": [
7412
7412
  {
7413
7413
  "disabled": false,
7414
- "document": " 来源:RESTRICT:封禁、FREEZW:冻结\n注意:此字段可能返回 null,表示取不到有效值。",
7414
+ "document": " 来源:RESTRICT:封禁、FREEZW:冻结",
7415
7415
  "example": "FREEZING",
7416
7416
  "member": "string",
7417
7417
  "name": "Source",
7418
- "output_required": false,
7418
+ "output_required": true,
7419
7419
  "type": "string",
7420
- "value_allowed_null": true
7420
+ "value_allowed_null": false
7421
7421
  },
7422
7422
  {
7423
7423
  "disabled": false,
7424
- "document": "是否允许自助解封:1是,2否\n注意:此字段可能返回 null,表示取不到有效值。",
7424
+ "document": "是否允许自助解封:1是,2",
7425
7425
  "example": "2",
7426
7426
  "member": "string",
7427
7427
  "name": "State",
7428
- "output_required": false,
7428
+ "output_required": true,
7429
7429
  "type": "string",
7430
- "value_allowed_null": true
7430
+ "value_allowed_null": false
7431
7431
  },
7432
7432
  {
7433
7433
  "disabled": false,
7434
- "document": "违规类型\n注意:此字段可能返回 null,表示取不到有效值。",
7434
+ "document": "违规类型",
7435
7435
  "example": "未备案",
7436
7436
  "member": "string",
7437
7437
  "name": "Reason",
7438
- "output_required": false,
7438
+ "output_required": true,
7439
7439
  "type": "string",
7440
- "value_allowed_null": true
7440
+ "value_allowed_null": false
7441
7441
  },
7442
7442
  {
7443
7443
  "disabled": false,
7444
- "document": "违规内容(URL、关联域名)\n注意:此字段可能返回 null,表示取不到有效值。",
7444
+ "document": "违规内容(URL、关联域名)",
7445
7445
  "example": "http://157.*.*.29/",
7446
7446
  "member": "string",
7447
7447
  "name": "Content",
7448
- "output_required": false,
7448
+ "output_required": true,
7449
7449
  "type": "string",
7450
- "value_allowed_null": true
7450
+ "value_allowed_null": false
7451
7451
  }
7452
7452
  ],
7453
7453
  "usage": "out"
@@ -2218,7 +2218,7 @@
2218
2218
  {
2219
2219
  "disabled": false,
2220
2220
  "document": "模板名称。",
2221
- "example": "aaa",
2221
+ "example": "回调模板1",
2222
2222
  "member": "string",
2223
2223
  "name": "TemplateName",
2224
2224
  "output_required": true,
@@ -2228,7 +2228,7 @@
2228
2228
  {
2229
2229
  "disabled": false,
2230
2230
  "document": "描述信息。",
2231
- "example": "xxx",
2231
+ "example": "场景1回调模版配置",
2232
2232
  "member": "string",
2233
2233
  "name": "Description",
2234
2234
  "output_required": true,
@@ -2318,12 +2318,32 @@
2318
2318
  {
2319
2319
  "disabled": false,
2320
2320
  "document": "音频审核回调 URL。\n注意:此字段可能返回 null,表示取不到有效值。",
2321
- "example": "",
2321
+ "example": "http://domain.com/path",
2322
2322
  "member": "string",
2323
2323
  "name": "AudioAuditNotifyUrl",
2324
2324
  "output_required": true,
2325
2325
  "type": "string",
2326
2326
  "value_allowed_null": true
2327
+ },
2328
+ {
2329
+ "disabled": false,
2330
+ "document": "录制异常回调 URL。",
2331
+ "example": "http://domain.com/path",
2332
+ "member": "string",
2333
+ "name": "RecordExceptionNotifyUrl",
2334
+ "output_required": false,
2335
+ "type": "string",
2336
+ "value_allowed_null": false
2337
+ },
2338
+ {
2339
+ "disabled": false,
2340
+ "document": "录制异常回调级别,可选择:error: 错误。alarm: 告警。",
2341
+ "example": "[\"error\"]",
2342
+ "member": "string",
2343
+ "name": "RecordExceptionLevels",
2344
+ "output_required": false,
2345
+ "type": "list",
2346
+ "value_allowed_null": false
2327
2347
  }
2328
2348
  ],
2329
2349
  "usage": "out"
@@ -4564,6 +4584,24 @@
4564
4584
  "name": "AudioAuditNotifyUrl",
4565
4585
  "required": false,
4566
4586
  "type": "string"
4587
+ },
4588
+ {
4589
+ "disabled": false,
4590
+ "document": "录制异常回调 URL。",
4591
+ "example": "http://domain.com/path",
4592
+ "member": "string",
4593
+ "name": "RecordExceptionNotifyUrl",
4594
+ "required": false,
4595
+ "type": "string"
4596
+ },
4597
+ {
4598
+ "disabled": false,
4599
+ "document": "录制异常回调级别,可选择:error、warning、info。",
4600
+ "example": "[\"error\"]",
4601
+ "member": "string",
4602
+ "name": "RecordExceptionLevels",
4603
+ "required": false,
4604
+ "type": "list"
4567
4605
  }
4568
4606
  ],
4569
4607
  "type": "object"
@@ -15604,6 +15642,24 @@
15604
15642
  "name": "AudioAuditNotifyUrl",
15605
15643
  "required": false,
15606
15644
  "type": "string"
15645
+ },
15646
+ {
15647
+ "disabled": false,
15648
+ "document": "录制异常回调 URL。\t",
15649
+ "example": "http://domain.com/path\t",
15650
+ "member": "string",
15651
+ "name": "RecordExceptionNotifyUrl",
15652
+ "required": false,
15653
+ "type": "string"
15654
+ },
15655
+ {
15656
+ "disabled": false,
15657
+ "document": "录制异常回调级别,可选择:error、warning、info。",
15658
+ "example": "[\"error\"]",
15659
+ "member": "string",
15660
+ "name": "RecordExceptionLevels",
15661
+ "required": false,
15662
+ "type": "list"
15607
15663
  }
15608
15664
  ],
15609
15665
  "type": "object"
@@ -18575,7 +18631,7 @@
18575
18631
  {
18576
18632
  "disabled": false,
18577
18633
  "document": "录制文件名。\n支持的特殊占位符有:\n{StreamID}: 流ID\n{StartYear}: 开始时间-年\n{StartMonth}: 开始时间-月\n{StartDay}: 开始时间-日\n{StartHour}: 开始时间-小时\n{StartMinute}: 开始时间-分钟\n{StartSecond}: 开始时间-秒\n{StartMillisecond}: 开始时间-毫秒\n{EndYear}: 结束时间-年\n{EndMonth}: 结束时间-月\n{EndDay}: 结束时间-日\n{EndHour}: 结束时间-小时\n{EndMinute}: 结束时间-分钟\n{EndSecond}: 结束时间-秒\n{EndMillisecond}: 结束时间-毫秒\n\n若未设置默认录制文件名为{StreamID}_{StartYear}-{StartMonth}-{StartDay}-{StartHour}-{StartMinute}-{StartSecond}_{EndYear}-{EndMonth}-{EndDay}-{EndHour}-{EndMinute}-{EndSecond}",
18578
- "example": "{StreamID}_{StartYear}-{StartMonth}-{StartDay}-{StartHour}-{Star",
18634
+ "example": "{StreamID}_{StartYear}-{StartMonth}-{StartDay}-{StartHour}-{StartMinute}-{StartSecond}_{EndYear}-{EndMonth}-{EndDay}-{EndHour}-{EndMinute}-{EndSecond}",
18579
18635
  "member": "string",
18580
18636
  "name": "VodFileName",
18581
18637
  "output_required": true,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "actions": {
3
3
  "ChatCompletions": {
4
- "document": "#### 接口功能\n\n调用接口,发起一次对话请求。\n如需使用OpenAI兼容接口, 请参考文档:[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1772/115968)\n\n#### 已支持的模型\n- DeepSeek-V3(model 参数值为**deepseek-v3**)\n - DeepSeek-V3为671B参数MoE模型,在百科知识、数学推理等多项任务上优势突出,评测成绩在主流榜单中位列开源模型榜首。\n - 支持64K上下文长度,最大支持8K输出长度。\n- DeepSeek-R1(model 参数值为**deepseek-r1**)\n - DeepSeek-R1为671B模型,使用强化学习训练,推理过程包含大量反思和验证,思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异,并为用户展现了完整的思考过程。\n - 支持64K上下文长度,最大支持8K输出长度。\n\n#### 计费说明\n- 限时免费\n\n本接口调用DeepSeek系列模型限时免费。即日至北京时间2025年2月25日23:59:59,所有腾讯云用户均可享受DeepSeek-V3、DeepSeek-R1模型限时免费服务,单账号限制接口并发上限为5。在此之后,模型价格将恢复至原价。\n- 标准计费(2025年2月26日起生效)\n![image](https://cdn.xiaowei.qq.com/static/lke/deepseek-token.png)\n\n### Openai兼容协议接口\n知识引擎原子能力大模型对话 API 兼容了 OpenAI 的接口规范,这意味着您可以直接使用 OpenAI 官方提供的 SDK 来调用大模型对话接口。您仅需要将 base_url 和 [api_key](https://cloud.tencent.com/document/product/1772/115970) 替换成相关配置,不需要对应用做额外修改,即可无缝将您的应用切换到相应的大模型。请参考文档:[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1772/115968)。\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中。",
4
+ "document": "#### 接口功能\n\n调用接口,发起一次对话请求。\n如需使用OpenAI兼容接口, 请参考文档:[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1772/115968)\n\n#### 已支持的模型\n- DeepSeek-V3(model 参数值为**deepseek-v3**)\n - DeepSeek-V3为671B参数MoE模型,在百科知识、数学推理等多项任务上优势突出,评测成绩在主流榜单中位列开源模型榜首。\n - 支持64K上下文长度,最大支持8K输出长度。\n- DeepSeek-R1(model 参数值为**deepseek-r1**)\n - DeepSeek-R1为671B模型,使用强化学习训练,推理过程包含大量反思和验证,思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异,并为用户展现了完整的思考过程。\n - 支持64K上下文长度,最大支持8K输出长度。\n\n#### 计费说明\n- 限时免费\n\n本接口调用DeepSeek系列模型限时免费。即日至北京时间2025年2月25日23:59:59,所有腾讯云用户均可享受DeepSeek-V3、DeepSeek-R1模型限时免费服务,单账号限制接口并发上限为5。在此之后,模型价格将恢复至原价。\n- 标准计费(2025年2月26日起生效)\n\n ![image](https://cdn.xiaowei.qq.com/static/lke/deekseep-token0212.png)\n\n### Openai兼容协议接口\n知识引擎原子能力大模型对话 API 兼容了 OpenAI 的接口规范,这意味着您可以直接使用 OpenAI 官方提供的 SDK 来调用大模型对话接口。您仅需要将 base_url 和 [api_key](https://cloud.tencent.com/document/product/1772/115970) 替换成相关配置,不需要对应用做额外修改,即可无缝将您的应用切换到相应的大模型。请参考文档:[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1772/115968)。\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中。",
5
5
  "input": "ChatCompletionsRequest",
6
6
  "name": "对话",
7
7
  "output": "ChatCompletionsResponse",
@@ -310,8 +310,8 @@
310
310
  },
311
311
  {
312
312
  "disabled": false,
313
- "document": "聊天上下文信息。\n说明:\n1. 长度最多为 40,按对话时间从旧到新在数组中排列。\n2. Message.Role 可选值:system、user、assistant。\n其中,system 角色可选,如存在则必须位于列表的最开始。user(tool) 和 assistant 需交替出现(一问一答),以 user 提问开始,user(tool)提问结束,其中tool可以连续出现多次,且 Content 不能为空。Role 的顺序示例:[system(可选) user assistant user(tool tool ...) assistant user(tool tool ...) ...]。\n",
314
- "example": "[{\"role\":\"user\",\"content\":\"你好\"}]",
313
+ "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",
314
+ "example": "{ \"Role\": \"user\", \"Content\": \"你是谁\" }",
315
315
  "member": "Message",
316
316
  "name": "Messages",
317
317
  "required": true,
@@ -3059,6 +3059,26 @@
3059
3059
  "type": "string",
3060
3060
  "value_allowed_null": true
3061
3061
  },
3062
+ {
3063
+ "disabled": false,
3064
+ "document": "分段标题",
3065
+ "example": "分段标题",
3066
+ "member": "string",
3067
+ "name": "Title",
3068
+ "output_required": false,
3069
+ "type": "string",
3070
+ "value_allowed_null": false
3071
+ },
3072
+ {
3073
+ "disabled": false,
3074
+ "document": "分段关键词",
3075
+ "example": "[\"words1\",\"words2\"]",
3076
+ "member": "string",
3077
+ "name": "Keywords",
3078
+ "output_required": false,
3079
+ "type": "list",
3080
+ "value_allowed_null": false
3081
+ },
3062
3082
  {
3063
3083
  "disabled": false,
3064
3084
  "document": "分段起始时间点,秒\n注意:此字段可能返回 null,表示取不到有效值。",
@@ -19226,6 +19246,26 @@
19226
19246
  "type": "float",
19227
19247
  "value_allowed_null": false
19228
19248
  },
19249
+ {
19250
+ "disabled": false,
19251
+ "document": "智能描述标题",
19252
+ "example": "标题",
19253
+ "member": "string",
19254
+ "name": "Title",
19255
+ "output_required": false,
19256
+ "type": "string",
19257
+ "value_allowed_null": false
19258
+ },
19259
+ {
19260
+ "disabled": false,
19261
+ "document": "智能描述关键词",
19262
+ "example": "[\"word1\",\"word2\"]",
19263
+ "member": "string",
19264
+ "name": "Keywords",
19265
+ "output_required": false,
19266
+ "type": "list",
19267
+ "value_allowed_null": false
19268
+ },
19229
19269
  {
19230
19270
  "disabled": false,
19231
19271
  "document": "分段结果。\n注意:此字段可能返回 null,表示取不到有效值。",