更新时间:2026-02-10 gmt 08:00

编辑自定义接入点-j9九游会登录

功能介绍

该api用于编辑指定接入点的流控、内容安全护栏开关、接入点名称、接入点描述。

接口约束

  • 该功能仅支持“西南-贵阳一”区域。
  • 自定义接入点创建后,不支持修改模型服务。

uri

put /v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id}

表1 路径参数

参数

是否必选

参数类型

描述

project-id

string

参数解释:项目id,获取方式请参见获取项目id和名称

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

custom_endpoint_id

string

参数解释:自定义接入点id。创建接入点时接口会返回,或者使用查询接口获取。具体操作,请参见创建自定义接入点查询自定义接入点

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

参数解释:用户token。通过调用iam服务的获取用户token接口获取(响应消息头中x-subject-token的值)。具体操作,请参见认证鉴权

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

content-type

string

参数解释:消息体的类型,固定为application/json。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表3 请求body参数

参数

是否必选

参数类型

描述

endpoint_name

string

参数解释:接入点名称。

约束限制:单用户的名称具有唯一性。

取值范围:输入长度1至64位,以中文,大小写字母开始,只包含中文、大小写字母、数字、中划线、下划线和小数点。

默认取值:不涉及。

remark

string

参数解释:接入点的描述。

约束限制:不涉及。

取值范围:输入长度最大256个字符。

默认取值:不涉及。

rpm

integer

参数解释:接入点rpm流控值。

约束限制:不涉及。

取值范围:每个模型的取值范围不同,您可以在在线推理 > 预置服务页签的“模型限流”列查看模型对应的取值范围。

默认取值:不涉及。

tpm

integer

参数解释:接入点tpm流控值。

约束限制:不涉及。

取值范围:每个模型的取值范围不同,您可以在在线推理 > 预置服务页签的“模型限流”列查看模型对应的取值范围。

默认取值:不涉及。

moderation

boolean

参数解释:是否开启内容安全护栏。仅客户等级为v2及以上,支持开启或关闭内容安全护栏。更多信息,请参见和如何查看客户等级

约束限制:非必填,默认值为true。

取值范围:

  • true:在模型推理链路中,开启内容安全护栏,提供额外拦截输入输出有害内容的能力,可能导致时延增加
  • false:不开启内容安全护栏,使用模型原生安全能力。

默认取值:true。

agreement_id

string

参数解释:开关内容安全护栏需要签订协议,这里传入的是协议id。获取方式请参见获取最新内容安全护栏免责声明中的agreement_id。

约束限制:moderation为false时为必填。

取值范围:不涉及。

默认取值:不涉及。

响应参数

表4 响应参数(成功)

参数

参数类型

描述

1

string

参数解释:操作结果标识,固定返回1。

取值范围:不涉及。

表5 响应参数(错误)

参数

参数类型

描述

error_msg

string

参数解释:错误描述信息。

取值范围:不涉及。

error_code

string

参数解释:错误码,标识错误类型。

取值范围:不涉及。

请求示例

此处以修改自定义接入点的名称、描述、内容安全护栏开关、rpm和tpm参数为例。

/v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id} 
{
"endpoint_name": "deepseek-test",
"remark": "deepseek自定义接入点测试",
"moderation": false,
"agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62b6c6",
"rpm":0,
"tpm":0 
}

响应示例

  • 成功响应,状态码:200
    1
  • 失败响应,状态码:400
    {
    "error_msg": "invalid token.",
    "error_code": "modelarts.0104" 
    }

状态码

请参见状态码

错误码

请参见错误码

相关文档

网站地图