修改接入点
更新时间：2026-01-19
POST
https://qianfan.baidubce.com/v2/service?Action=ModifyEndpoint
本接口修改已存在接入点的配置信息。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。
- 运维操作千帆大模型平台预测服务的权限：
QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，参见鉴权认证。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值：ModifyEndpoint。
必选
Body 参数
name
string
修改的接入点名称，需符合以下要求：
- 长度：2~64个字符。
- 首字符：中文、大小写字母、数字、短横线 (-)。
- 后续字符：中文、大小写字母、数字、短横线 (-)、下划线 (_)。
必选
description
string
修改的接入点描述，，最多可输入300个字符。
可选
endpointId
string
接入点ID，用于确定需修改的接入点。
必选
rateLimit
object {4}
限流配置。设定值不可超过所属模型服务的配额上限。
可选
显示子属性
隐藏子属性
tpm
integer
TPM限制。
可选
rpm
integer
RPM限制。
可选
tpmInput
integer
输入TPM限制。
可选
tpmOutput
integer
输出TPM限制。
可选
请求结构
POST /v2/service?Action=ModifyEndpoint HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"endpointId": "ep_1fu****5r_chat-service-v1",
"name": "Qianfan_Chat_Service_V2_Upgrade",
"rateLimit": {
"tpm": 100,
"rpm": 60,
"tpmInput": 1500,
"tpmOutput": 1500
}
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=ModifyEndpoint" \
-H "Content-Type: application/json" \
-H "x-bce-date: 2026-01-15T07:48:39Z" \
-H "Authorization: bce-auth-v1/ALTA***Key/2026-01-15T07:48:39Z/1800/host;x-bce-date/SignatureString****" \
--data '{
"endpointId": "ep_1fu****5r_chat-service-v1",
"name": "Qianfan_Chat_Service_V2_Upgrade",
"rateLimit": {
"tpm": 100,
"rpm": 60,
"tpmInput": 1500,
"tpmOutput": 1500
}
}'
返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，用于追踪和定位问题。
必选
result
boolean
修改结果，表示接入点修改是否成功。true：修改成功false：修改失败
必选
成功响应
{
"requestId": "5f426429-****-4917-b7cb-a5ce706f7aab",
"result": true
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
错误示例
json
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，可查看错误码说明。