创建接入点
更新时间：2026-01-19
POST
https://qianfan.baidubce.com/v2/service?Action=CreateEndpoint
本接口为指定服务创建一个新的接入点，返回接入点ID。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。
- 运维操作千帆大模型平台预测服务的权限：
QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，参见鉴权认证。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值：CreateEndpoint。
必选
Body 参数
name
string
接入点名称，需符合以下要求：
- 长度：2~64个字符。
- 首字符：中文、大小写字母、数字、短横线 (-)。
- 后续字符：中文、大小写字母、数字、短横线 (-)、下划线 (_)。
必选
description
string
接入点描述，最多可输入300个字符。
可选
endpointIdSuffix
string
接入点ID后缀，用于生成接入点ID，需符合以下要求：
- 长度：1~19个字符。
- 字符范围：小写字母、数字、短横线 (-)、下划线 (_)。
- 结尾限制：必须以小写字母或数字结尾，不支持符号结尾。
必选
rateLimit
object {4}
限流配置。设定值不可超过所属模型服务的配额上限。
必选
显示子属性
隐藏子属性
tpm
integer
TPM限制。
可选
rpm
integer
RPM限制。
可选
tpmInput
integer
输入TPM限制。
可选
tpmOutput
integer
输出TPM限制。
可选
请求结构
POST /v2/service?Action=CreateEndpoint HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"serviceId": "svcp-****252832",
"name": "Qianfan_Chat_Service_01",
"endpointIdSuffix": "chat-service-v1",
"rateLimit": {
"tpm": 150000,
"rpm": 10,
"tpmInput": 15000,
"tpmOutput": 15000
}
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=CreateEndpoint" \
-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 '{
"serviceId": "svcp-****252832",
"name": "Qianfan_Chat_Service_01",
"endpointIdSuffix": "chat-service-v1",
"rateLimit": {
"tpm": 150000,
"rpm": 10,
"tpmInput": 15000,
"tpmOutput": 15000
}
}'
返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，用于追踪和定位问题。
必选
result
object {1}
响应结果对象。
必选
显示子属性
隐藏子属性
endpointId
string
接入点ID。
必选
成功响应
{
"requestId": "dc8221e2-f51f-****-a9d4-0d0720643d40",
"result": {
"endpointId": "ep_1fu****5r_chat-service-v1"
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
错误示例
json
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，可查看错误码说明。