获取接入点详情
更新时间：2026-01-19
POST
https://qianfan.baidubce.com/v2/service?Action=DescribeEndpoint
此接口用于查询特定接入点的详细信息，包括服务ID、名称、描述、状态以及速率限制等信息。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。
- 只读访问千帆大模型平台预测服务的权限：
QianfanServiceReadAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，参见鉴权认证。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值：DescribeEndpoint。
必选
Body 参数
请求结构
POST /v2/service?Action=DescribeEndpoint HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"endpointId":"ep_1****be5r_chat-service-v1"
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=DescribeEndpoint" \
-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_1****be5r_chat-service-v1"
}'
返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，用于追踪和定位问题。
必选
result
object {6}
接入点详细信息。
必选
显示子属性
隐藏子属性
serverId
string
服务ID。
必选
name
string
接入点名称。
必选
description
string
接入点描述。
必选
status
string
接入点状态。
Active：已启用Activating：启用中Inactive：已停用Deactivating：停用中
必选
endpointId
string
接入点ID。与请求参数中的 endpointId 一致。
必选
rateLimit
object {4}
限流配置。
必选
显示子属性
隐藏子属性
tpm
integer
TPM限制。
可选
rpm
integer
RPM限制。
可选
tpmInput
integer
输入TPM限制。
可选
tpmOutput
integer
输出TPM限制。
可选
成功响应
{
"requestId": "6add9aa2-****-4ff5-a0ab-11cf2888bf3d",
"result": {
"serverId": "svcp-****ae252832",
"name": "Qianfan_Chat_Service_05",
"description": "",
"status": "Active",
"endpointId": "ep_****hnt7p_chat-service-v1",
"rateLimit": {
"tpm": 150000,
"rpm": 10
}
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
错误示例
json
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，可查看错误码说明。