文档首页/ 云搜索服务 CSS_企业搜索服务 KooSearch/ API参考/ API/ 历史API/ 模型管理/ 更新模型
更新时间：2025-08-11 GMT+08:00
查看PDF
分享

更新模型

功能介绍

更新模型配置

URI

PUT /v1/koosearch/models/{model_name}

表1 路径参数

参数

是否必选

参数类型

描述

model_name

是

String

模型名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

接口鉴权使用的Token，Token获取方式参考：3.2节 认证鉴权。

约束限制：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

detail

否

String

模型描述。

endpoint

否

String

模型endpoint。

extend_config

否

ModelExtendConfig object

模型的自定义配置，json格式。

alias

否

String

昇腾模型场景请求模型需要的name。
表4 ModelExtendConfig

参数

是否必选

参数类型

描述

iam_info

是

IamInfo object

iam鉴权委托信息。

custom_header

否

map<string, object>

扩展请求头。

deployment_id

否

String

模型的deployment_id信息。

vector_config

否

VectorConfig object

向量模型的相关配置。

nlp_config

否

NlpConfig object

NLP大模型相关配置。
表5 IamInfo

参数

是否必选

参数类型

描述

iam_enabled

否

Boolean

是否启用iam鉴权。

agency_enabled

否

Boolean

是否使用委托账号进行鉴权。

project_id

否

String

iam用户的project_id信息，iam_enable=true是为必填字段。

domain_name

否

String

委托账号的账号名。

agency_name

否

String

委托名。
表6 VectorConfig

参数

是否必选

参数类型

描述

embedding_url

是

String

embedding或query2query模型的调用url。

rerank_url

是

String

rerank模型的调用url。
表7 NlpConfig

参数

是否必选

参数类型

描述

context_length

是

Integer

上下文长度，即NLP大模型在进行一次特定的推理时可以考虑的最大令牌数。

响应参数

状态码：400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

PUT https://{endpoint}/v1/koosearch/models/pangu_38b

{
  "detail" : "pangu_38b",
  "endpoint" : "http://10.0.0.169:31010",
  "extend_config" : {
    "deployment_id" : "123",
    "iam_info" : {
      "project_id" : "123",
      "iam_enabled" : false,
      "agency_enabled" : false
    },
    "nlp_config" : {
      "context_length" : 32
    }
  }
}

响应示例

无

状态码

状态码

描述

200

更新成功。

400

请求体错误

500

内部异常

错误码

请参见错误码。

父主题： 模型管理