kingsoftcloud-sdk-python 1.5.8.70__tar.gz → 1.5.8.71__tar.gz

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kingsoftcloud-sdk-python
-Version: 1.5.8.70
+Version: 1.5.8.71
 Summary: Kingsoft Cloud SDK for Python
 Home-page: https://github.com/ksyun/ksyun-sdk-python
 Author: Kingsoft Cloud

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/kingsoftcloud_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kingsoftcloud-sdk-python
-Version: 1.5.8.70
+Version: 1.5.8.71
 Summary: Kingsoft Cloud SDK for Python
 Home-page: https://github.com/ksyun/ksyun-sdk-python
 Author: Kingsoft Cloud

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/kingsoftcloud_sdk_python.egg-info/SOURCES.txt

@@ -199,6 +199,10 @@ ksyun/client/kls/__init__.py
 ksyun/client/kls/v20170101/__init__.py
 ksyun/client/kls/v20170101/client.py
 ksyun/client/kls/v20170101/models.py
+ksyun/client/kmaf/__init__.py
+ksyun/client/kmaf/v20260130/__init__.py
+ksyun/client/kmaf/v20260130/client.py
+ksyun/client/kmaf/v20260130/models.py
 ksyun/client/kmr/__init__.py
 ksyun/client/kmr/v20210902/__init__.py
 ksyun/client/kmr/v20210902/client.py

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '1.5.8.70'
+__version__ = '1.5.8.71'

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/client/aicp/v20240612/client.py

@@ -721,6 +721,29 @@ class AicpClient(AbstractClient):
                 raise KsyunSDKException(message=str(e))
 
 
+    def QueryTokenData(self, request):
+        """查询模型API token用量
+        :param request: Request instance for QueryTokenData.
+        :type request: :class:`ksyun.client.aicp.v20240612.models.QueryTokenDataRequest`
+        """
+        try:
+            params = request._serialize()
+            body = self.call_judge("QueryTokenData", params, "application/x-www-form-urlencoded")
+            response = json.loads(body)
+            if "Error" not in response:
+                return body
+            else:
+                code = response["Error"]["Code"]
+                message = response["Error"]["Message"]
+                req_id = response["RequestId"]
+                raise KsyunSDKException(code, message, req_id)
+        except Exception as e:
+            if isinstance(e, KsyunSDKException):
+                raise
+            else:
+                raise KsyunSDKException(message=str(e))
+
+
     def DisableApikeyStatus(self, request):
         """禁用API Key
         :param request: Request instance for DisableApikeyStatus.

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/client/aicp/v20240612/models.py

@@ -147,7 +147,7 @@ class DeleteStorageConfigRequest(AbstractModel):
 
     def __init__(self):
         r"""删除存储配置
-        :param StorageConfigId: 存储配置Id
+        :param StorageConfigId: 存储配置ID
         :type PathPrefix: String
         """
         self.StorageConfigId = None
@@ -241,9 +241,9 @@ class ModifyNotebookRequest(AbstractModel):
         r"""修改开发任务
         :param NotebookId: 开发任务ID
         :type PathPrefix: String
-        :param NotebookName: 名称
+        :param NotebookName: 开发任务名称
         :type PathPrefix: String
-        :param Description: 描述
+        :param Description: 描述信息
         :type PathPrefix: String
         :param ImageId: 镜像ID
         :type PathPrefix: String
@@ -289,7 +289,7 @@ class ModifyNotebookRequest(AbstractModel):
         :type PathPrefix: String
         :param ImageSource: 镜像来源，当改变镜像来源时，需传入该值。
 - Official 官方镜像
-- Personal 个人镜像
+- Personal 自定义镜像
 - ThirdParty 第三方镜像
 
 当修改镜像类型为第三方镜像时，需同时传入"ImageRegistryId", "ImageRepoId", "ImageTagId"三个入参
@@ -401,13 +401,13 @@ class DescribeNotebooksRequest(AbstractModel):
 
     def __init__(self):
         r"""查询开发任务
-        :param NotebookId: 开发任务ID
+        :param NotebookId: 多个开发任务的ID
         :type PathPrefix: Filter
         :param Name: 开发任务名称
         :type PathPrefix: String
-        :param Page: 页数
+        :param Page: 页码
         :type PathPrefix: Int
-        :param PageSize: 每页查询数目
+        :param PageSize: 单次调用可返回的最大条目数量
         :type PathPrefix: Int
         :param Filter: 条件过滤
         :type PathPrefix: Filter
@@ -442,17 +442,17 @@ class CreateNotebookRequest(AbstractModel):
 
     def __init__(self):
         r"""创建开发任务
-        :param NotebookName: 任务名称
+        :param NotebookName: 开发任务名称
         :type PathPrefix: String
         :param Description: 描述信息
         :type PathPrefix: String
-        :param ResourcePoolId: 资源池ID
+        :param ResourcePoolId: 资源组ID
         :type PathPrefix: String
         :param QueueName: 队列名称
         :type PathPrefix: String
         :param GPUType: GPU类型
         :type PathPrefix: String
-        :param GPUNumber: GPU卡数，当GPUType不为空时，此值有效，允许范围为0~10000, 如果可虚拟化，支持[0.1,0.9]
+        :param GPUNumber: GPU卡数，当GPUType不为空时，此值有效且必传，允许范围为0~10000, 如果可虚拟化，支持[0.1,0.9]
         :type PathPrefix: String
         :param CPUNum: CPU核数，允许范围为0~10000
         :type PathPrefix: Int
@@ -462,13 +462,13 @@ class CreateNotebookRequest(AbstractModel):
         :type PathPrefix: String
         :param StorageConfigs: 存储配置列表
         :type PathPrefix: Array
-        :param AutoSave: 是否自动保存镜像
+        :param AutoSave: 自动保存镜像。当值为true时，开发任务停止前会执行自动保存镜像
         :type PathPrefix: Boolean
-        :param ServiceConfigs: 开放服务端口列表
+        :param ServiceConfigs: 自定义服务配置
         :type PathPrefix: Array
         :param ImageSource: 镜像来源
 - 官方镜像 Official
-- 个人镜像 Personal
+- 自定义镜像 Personal
 - 第三方镜像 ThirdParty
 
 当传入值为ThirdParty时，"ImageRegistryId", "ImageRepoId", "ImageTagId"必须传入
@@ -492,7 +492,7 @@ class CreateNotebookRequest(AbstractModel):
         :type PathPrefix: Boolean
         :param AllocationId: 弹性IP ID，当EnablePublicNetworkSsh=true时，此参数必传
         :type PathPrefix: String
-        :param RunOnCPU: 开启后，仅调度CPU
+        :param RunOnCPU: 仅调度到CPU节点。当GPUNumber为空或值为0时此值有效
         :type PathPrefix: String
         """
         self.NotebookName = None
@@ -1069,7 +1069,7 @@ class DescribeNotebookLogRequest(AbstractModel):
 
     def __init__(self):
         r"""查看开发机的pod日志
-        :param NotebookId: 开发任务Id
+        :param NotebookId: 开发任务ID
         :type PathPrefix: String
         :param SinceSeconds: 日志默认显示时间，单位秒；比如10分钟内的，值为600
         :type PathPrefix: Int
@@ -1357,6 +1357,69 @@ class DescribeApikeysRequest(AbstractModel):
             self.KeyId = params.get("KeyId")
 
 
+class QueryTokenDataRequest(AbstractModel):
+    """QueryTokenData请求参数结构体
+    """
+
+    def __init__(self):
+        r"""查询模型API token用量
+        :param StartTimestamp: 开始时间，毫秒时间戳
+        :type PathPrefix: Long
+        :param EndTimestamp: 截止时间，毫秒时间戳
+        :type PathPrefix: Long
+        :param LastKey: 分页用的游标，表示上次已经获取到的数据，当前请求可以取上次返回结果的LastKey，首页时不传
+        :type PathPrefix: String
+        :param MaxResults: 分页页长，最大10000
+        :type PathPrefix: Int
+        :param ModelKeyword: model 搜索关键词
+        :type PathPrefix: String
+        :param Keyword: 搜索关键词
+        :type PathPrefix: String
+        :param GroupBy: 分组字段：model、keyId
+        :type PathPrefix: String
+        :param ReasoningType: 推理类型：normal-在线，batch-批量，web-在线体验，为空表示全部。
+        :type PathPrefix: String
+        :param Marker: 页码，从1开始。
+        :type PathPrefix: Int
+        :param ModelName: 模型名称
+- 当按照模型分组时，Keyword优先，Keyword为空再以该字段筛选
+- 当按照APIKEY分组时，该字段始终生效
+        :type PathPrefix: String
+        """
+        self.StartTimestamp = None
+        self.EndTimestamp = None
+        self.LastKey = None
+        self.MaxResults = None
+        self.ModelKeyword = None
+        self.Keyword = None
+        self.GroupBy = None
+        self.ReasoningType = None
+        self.Marker = None
+        self.ModelName = None
+
+    def _deserialize(self, params):
+        if params.get("StartTimestamp"):
+            self.StartTimestamp = params.get("StartTimestamp")
+        if params.get("EndTimestamp"):
+            self.EndTimestamp = params.get("EndTimestamp")
+        if params.get("LastKey"):
+            self.LastKey = params.get("LastKey")
+        if params.get("MaxResults"):
+            self.MaxResults = params.get("MaxResults")
+        if params.get("ModelKeyword"):
+            self.ModelKeyword = params.get("ModelKeyword")
+        if params.get("Keyword"):
+            self.Keyword = params.get("Keyword")
+        if params.get("GroupBy"):
+            self.GroupBy = params.get("GroupBy")
+        if params.get("ReasoningType"):
+            self.ReasoningType = params.get("ReasoningType")
+        if params.get("Marker"):
+            self.Marker = params.get("Marker")
+        if params.get("ModelName"):
+            self.ModelName = params.get("ModelName")
+
+
 class DisableApikeyStatusRequest(AbstractModel):
     """DisableApikeyStatus请求参数结构体
     """

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/client/aicp/v20251114/client.py

@@ -376,3 +376,49 @@ class AicpClient(AbstractClient):
                 raise KsyunSDKException(message=str(e))
 
 
+    def CreateMemorySdk(self, request):
+        """向指定记忆库写入记忆
+        :param request: Request instance for CreateMemorySdk.
+        :type request: :class:`ksyun.client.aicp.v20251114.models.CreateMemorySdkRequest`
+        """
+        try:
+            params = request._serialize()
+            body = self.call_judge("CreateMemorySdk", params, "application/json")
+            response = json.loads(body)
+            if "Error" not in response:
+                return body
+            else:
+                code = response["Error"]["Code"]
+                message = response["Error"]["Message"]
+                req_id = response["RequestId"]
+                raise KsyunSDKException(code, message, req_id)
+        except Exception as e:
+            if isinstance(e, KsyunSDKException):
+                raise
+            else:
+                raise KsyunSDKException(message=str(e))
+
+
+    def QueryMemorySdk(self, request):
+        """从记忆库检索记忆
+        :param request: Request instance for QueryMemorySdk.
+        :type request: :class:`ksyun.client.aicp.v20251114.models.QueryMemorySdkRequest`
+        """
+        try:
+            params = request._serialize()
+            body = self.call_judge("QueryMemorySdk", params, "application/json")
+            response = json.loads(body)
+            if "Error" not in response:
+                return body
+            else:
+                code = response["Error"]["Code"]
+                message = response["Error"]["Message"]
+                req_id = response["RequestId"]
+                raise KsyunSDKException(code, message, req_id)
+        except Exception as e:
+            if isinstance(e, KsyunSDKException):
+                raise
+            else:
+                raise KsyunSDKException(message=str(e))
+
+

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/client/aicp/v20251114/models.py

@@ -372,3 +372,105 @@ class CreateKnowledgeBaseRequest(AbstractModel):
             self.RetrievalModel = params.get("RetrievalModel")
 
 
+class CreateMemorySdkRequest(AbstractModel):
+    """CreateMemorySdk请求参数结构体
+    """
+
+    def __init__(self):
+        r"""向指定记忆库写入记忆
+        :param Namespace: 
+        :type PathPrefix: String
+        :param UserId: 
+        :type PathPrefix: String
+        :param AgentId: 
+        :type PathPrefix: String
+        :param SessionId: 
+        :type PathPrefix: String
+        :param SceneId: 
+        :type PathPrefix: String
+        :param DataType: 
+        :type PathPrefix: String
+        :param Data: 
+        :type PathPrefix: Object
+        """
+        self.Namespace = None
+        self.UserId = None
+        self.AgentId = None
+        self.SessionId = None
+        self.SceneId = None
+        self.DataType = None
+        self.Data = None
+
+    def _deserialize(self, params):
+        if params.get("Namespace"):
+            self.Namespace = params.get("Namespace")
+        if params.get("UserId"):
+            self.UserId = params.get("UserId")
+        if params.get("AgentId"):
+            self.AgentId = params.get("AgentId")
+        if params.get("SessionId"):
+            self.SessionId = params.get("SessionId")
+        if params.get("SceneId"):
+            self.SceneId = params.get("SceneId")
+        if params.get("DataType"):
+            self.DataType = params.get("DataType")
+        if params.get("Data"):
+            self.Data = params.get("Data")
+
+
+class QueryMemorySdkRequest(AbstractModel):
+    """QueryMemorySdk请求参数结构体
+    """
+
+    def __init__(self):
+        r"""从记忆库检索记忆
+        :param Namespace: 
+        :type PathPrefix: String
+        :param UserId: 
+        :type PathPrefix: String
+        :param Query: 
+        :type PathPrefix: String
+        :param SceneId: 
+        :type PathPrefix: String
+        :param OccurredAfter: 
+        :type PathPrefix: Long
+        :param OccurredBefore: 
+        :type PathPrefix: Long
+        :param Mode: 
+        :type PathPrefix: String
+        :param ReturnCitations: 
+        :type PathPrefix: Boolean
+        :param Limit: 
+        :type PathPrefix: Int
+        """
+        self.Namespace = None
+        self.UserId = None
+        self.Query = None
+        self.SceneId = None
+        self.OccurredAfter = None
+        self.OccurredBefore = None
+        self.Mode = None
+        self.ReturnCitations = None
+        self.Limit = None
+
+    def _deserialize(self, params):
+        if params.get("Namespace"):
+            self.Namespace = params.get("Namespace")
+        if params.get("UserId"):
+            self.UserId = params.get("UserId")
+        if params.get("Query"):
+            self.Query = params.get("Query")
+        if params.get("SceneId"):
+            self.SceneId = params.get("SceneId")
+        if params.get("OccurredAfter"):
+            self.OccurredAfter = params.get("OccurredAfter")
+        if params.get("OccurredBefore"):
+            self.OccurredBefore = params.get("OccurredBefore")
+        if params.get("Mode"):
+            self.Mode = params.get("Mode")
+        if params.get("ReturnCitations"):
+            self.ReturnCitations = params.get("ReturnCitations")
+        if params.get("Limit"):
+            self.Limit = params.get("Limit")
+
+

{kingsoftcloud_sdk_python-1.5.8.70 → kingsoftcloud_sdk_python-1.5.8.71}/ksyun/client/aicp/v20251212/models.py

@@ -15,7 +15,7 @@ class CreateTrainJobRequest(AbstractModel):
         :param Priority: 优先级，有效值：
 - kaic-high 高优先级
 - kaic-normal 中优先级
-- kaic-low 低优先级
+- kaic-low  低优先级
         :type PathPrefix: String
         :param QueueName: 队列名称
         :type PathPrefix: String

kingsoftcloud_sdk_python-1.5.8.71/ksyun/client/kmaf/v20260130/client.py

@@ -0,0 +1,56 @@
+import json
+
+from ksyun.common.exception.ksyun_sdk_exception import KsyunSDKException
+from ksyun.common.abstract_client import AbstractClient
+
+
+class KmafClient(AbstractClient):
+    _apiVersion = '2026-01-30'
+    _endpoint = 'kmaf.api.ksyun.com'
+    _service = 'kmaf'
+    def QueryAnswer(self, request):
+        """获取安全代答内容
+        :param request: Request instance for QueryAnswer.
+        :type request: :class:`ksyun.client.kmaf.v20260130.models.QueryAnswerRequest`
+        """
+        try:
+            params = request._serialize()
+            body = self.call_judge("QueryAnswer", params, "application/json")
+            response = json.loads(body)
+            if "Error" not in response:
+                return body
+            else:
+                code = response["Error"]["Code"]
+                message = response["Error"]["Message"]
+                req_id = response["RequestId"]
+                raise KsyunSDKException(code, message, req_id)
+        except Exception as e:
+            if isinstance(e, KsyunSDKException):
+                raise
+            else:
+                raise KsyunSDKException(message=str(e))
+
+
+    def CheckModerate(self, request):
+        """检测模型输入和输出内容
+        :param request: Request instance for CheckModerate.
+        :type request: :class:`ksyun.client.kmaf.v20260130.models.CheckModerateRequest`
+        """
+        try:
+            params = request._serialize()
+            body = self.call_judge("CheckModerate", params, "application/json")
+            response = json.loads(body)
+            if "Error" not in response:
+                return body
+            else:
+                code = response["Error"]["Code"]
+                message = response["Error"]["Message"]
+                req_id = response["RequestId"]
+                raise KsyunSDKException(code, message, req_id)
+        except Exception as e:
+            if isinstance(e, KsyunSDKException):
+                raise
+            else:
+                raise KsyunSDKException(message=str(e))
+
+

kingsoftcloud_sdk_python-1.5.8.71/ksyun/client/kmaf/v20260130/models.py

@@ -0,0 +1,64 @@
+from ksyun.common.abstract_model import AbstractModel
+
+class QueryAnswerRequest(AbstractModel):
+    """QueryAnswer请求参数结构体
+    """
+
+    def __init__(self):
+        r"""获取安全代答内容
+        :param AppId: 防护应用ID
+        :type PathPrefix: String
+        :param MsgId: 消息ID
+        :type PathPrefix: String
+        :param UseStream: 是否返回流式结果：0-非流式，1-流式
+        :type PathPrefix: Int
+        """
+        self.AppId = None
+        self.MsgId = None
+        self.UseStream = None
+
+    def _deserialize(self, params):
+        if params.get("AppId"):
+            self.AppId = params.get("AppId")
+        if params.get("MsgId"):
+            self.MsgId = params.get("MsgId")
+        if params.get("UseStream"):
+            self.UseStream = params.get("UseStream")
+
+
+class CheckModerateRequest(AbstractModel):
+    """CheckModerate请求参数结构体
+    """
+
+    def __init__(self):
+        r"""检测模型输入和输出内容
+        :param AppId: 防护应用ID
+        :type PathPrefix: String
+        :param MsgId: 消息ID，用于流式检测场景
+        :type PathPrefix: String
+        :param UseStream: 流式状态：0-非流式，1-流式，2-流式结束
+        :type PathPrefix: Int
+        :param Message: 
+        :type PathPrefix: Object
+        :param History: 
+        :type PathPrefix: Array
+        """
+        self.AppId = None
+        self.MsgId = None
+        self.UseStream = None
+        self.Message = None
+        self.History = None
+
+    def _deserialize(self, params):
+        if params.get("AppId"):
+            self.AppId = params.get("AppId")
+        if params.get("MsgId"):
+            self.MsgId = params.get("MsgId")
+        if params.get("UseStream"):
+            self.UseStream = params.get("UseStream")
+        if params.get("Message"):
+            self.Message = params.get("Message")
+        if params.get("History"):
+            self.History = params.get("History")
+
+