更新时间:2026-09-21 GMT+08:00
分享

更新自定义大模型

功能介绍

更新自定义大模型

URI

PUT /v1/{project_id}/aiguard/custom-llms/{llmId}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于指定操作所属的项目。

约束限制:

必填,字符串类型。

取值范围:

通过调用IAM服务获取的projectId值。

默认取值:

不涉及。

llmId

String

参数解释:

自定义大模型ID,用于唯一标识一个自定义大模型。

约束限制:

必填,字符串类型。

取值范围:

通过创建自定义大模型接口返回的id值或通过查询自定义大模型列表接口获取的id值。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,用于身份认证和权限验证,通过调用IAM服务的用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必填,字符串类型,必须为有效的未过期Token。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

String

参数解释:

请求体内容类型,用于指定本次请求的数据格式。

约束限制:

必填,字符串类型。

取值范围:

application/json;charset=utf-8。

默认取值:

application/json;charset=utf-8。

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

自定义大模型名称。

约束限制:

可选,字符串类型,非空时最大长度128个字符。

取值范围:

只能包含字母、数字、中文、下划线和连字符。

默认取值:

不涉及。

description

String

参数解释:

自定义大模型描述。

约束限制:

可选,字符串类型,最大长度256个字符。

取值范围:

不涉及。

默认取值:

不涉及。

model_name

String

参数解释:

模型名称。

约束限制:

可选,字符串类型,非空时最大长度128个字符。

取值范围:

只能包含字母、数字、下划线、连字符、点号、冒号和斜杠。

默认取值:

不涉及。

protocol

String

参数解释:

协议类型。

约束限制:

可选,字符串类型。

取值范围:

当前仅支持openai-chat。

默认取值:

不涉及。

url

String

参数解释:

自定义大模型的请求地址。

约束限制:

可选,字符串类型,非空时须以http://或https://开头,传入url时apiKey必须同时传入。

取值范围:

须以http://或https://开头。

默认取值:

不涉及。

api_key

String

参数解释:

API密钥。

约束限制:

可选,字符串类型,非空时明文最大长度512个字符。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释:

自定义大模型ID。

取值范围:

不涉及。

name

String

参数解释:

自定义大模型名称。

取值范围:

不涉及。

description

String

参数解释:

自定义大模型描述。

取值范围:

不涉及。

model_name

String

参数解释:

模型名称。

取值范围:

不涉及。

protocol

String

参数解释:

协议类型。

取值范围:

不涉及。

url

String

参数解释:

自定义大模型的请求地址。

取值范围:

不涉及。

referenced_policies

Array of ReferencedPolicy objects

参数解释:

引用的策略列表。

取值范围:

数组元素为ReferencedPolicy对象。

create_time

Long

参数解释:

创建时间。

取值范围:

毫秒时间戳,int64格式。

update_time

Long

参数解释:

更新时间。

取值范围:

毫秒时间戳,int64格式。

表5 ReferencedPolicy

参数

参数类型

描述

policy_id

String

参数解释:

策略ID。

取值范围:

不涉及。

policy_name

String

参数解释:

策略名称。

取值范围:

不涉及。

请求示例

响应示例

状态码

状态码

描述

200

操作成功

错误码

请参见错误码

相关文档