查询服务调用详情

查询服务调用详情

更新时间：2026-02-26

POST

https://qianfan.baidubce.com/v2/service?Action=DescribeServiceStats

本接口用于查询服务调用详情。

鉴权说明

调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Query 参数

Action string

方法名称，固定值DescribeServiceStats

必选

Body 参数

serviceId array

服务ID，说明：（1）不填写该字段，默认查询全部服务ID
（2）可以通过任一方式获取：方式一：通过调用接口创建服务，返回参数serviceId获取方式二：通过千帆控制台-在线推理-我的服务页面，点击某服务详情查看，如下图所示：

必选

显示子属性隐藏子属性

items string

appId array

应用ID，说明：（1）不填写该字段，默认查询全部应用（2）通过控制台-系统管理与统计-应用接入页面，查看AppID，如下图所示：

可选

显示子属性隐藏子属性

items string

startTime string

查询起始时间，格式如2025-03-30T16:00:00Z (ISO 8601)

必选

endTime string

查询终止时间，格式如2025-03-31T15:59:00Z (ISO 8601)

必选

interval integer

时间粒度。可选值: 86400, 3600, 60

必选

protocolVersion integer

服务版本。可选值: 1, 2

可选

请求结构

POST /v2/service?Action=DescribeServiceStats HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
    "serviceId": ["svco-tv5t4zpkj3za"],
    "appId": ["1483416575"],
    "startTime": "2025-03-30T16:00:00Z",
    "endTime": "2025-03-31T15:59:00Z",
    "interval": 86400,
    "protocolVersion":2
}

示例代码

JSON

curl --location 'https://qianfan.baidubce.com/v2/service?Action=DescribeServiceStats' \
--header 'Authorization: bce-auth-v1/047ab241bad24xxx28b1ac/2024-01-10T08:39:09Z/180000/host;x-bce-date/eae9855604cxxxxe03cfcbaff' \
--header 'x-bce-date: 2024-01-10T08:37:40Z' \
--header 'Content-Type: application/json' \
--data '{
    "serviceId": ["svco-tv5t4zpkj3za"],
    "appId": ["1483416575"],
    "startTime": "2025-03-30T16:00:00Z",
    "endTime": "2025-03-31T15:59:00Z",
    "interval": 86400,
    "protocolVersion":2
}'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

requestId string

请求ID

可选

result object {3}

可选

显示子属性隐藏子属性

startTime string

查询起始时间 (ISO 8601)

可选

endTime string

查询终止时间 (ISO 8601)

可选

serviceList array

服务列表

可选

显示子属性隐藏子属性

items object {3}

显示子属性隐藏子属性

serviceId string

服务ID

可选

serviceName string

服务名

可选

appList array

app列表

可选

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

appId string

appID

可选

metrics array

监控指标，返回入参指定的指标结果

可选

显示子属性隐藏子属性

items object {27}

显示子属性隐藏子属性

tpm array

TPM使用情况，仅时间粒度为分钟时展示

可选

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

timestamp integer

时间戳，只展示有变化的时间点及数据

可选

tpmRateLimit integer

TPM限额

可选

rpm array

RPM使用情况，仅时间粒度为分钟时展示

可选

显示子属性隐藏子属性

items object {3}

显示子属性隐藏子属性

timestamp integer

时间戳，只展示有变化的时间点和数据

可选

rpmRateLimit integer

RPM限额

可选

rpm integer

RPM实际使用量

可选

timeToFirstTokenP99 integer

首Tokens时延P99分位(ms)

可选

timeToFirstTokenP90 integer

首Tokens时延P90分位(ms)

可选

timeToFirstTokenP50 integer

首Tokens时延P50分位(ms)

可选

latencyP99 integer

整句时延P99分位(ms)

可选

latencyP90 integer

整句时延P90分位(ms)

可选

latencyP50 integer

整句时延P50分位(ms)

可选

outputTokensPerSecondP99 float

OTPS P99分位（tokens/s）

可选

outputTokensPerSecondP90 float

OTPS P90分位（tokens/s）

可选

outputTokensPerSecondP50 float

OTPS P50分位（tokens/s）

可选

inputTokensTotal float

输入token数（千tokens）

可选

outputTokensTotal float

输出token数（千tokens）

可选

tokensTotal float

总token数（千tokens）

可选

succeedCallTotal integer

调用成功次数

可选

failureCallTotal integer

调用失败次数

可选

callTotal integer

调用总次数

可选

searchCountTotal integer

搜索触发次数，说明：模型触发此功能时，返回该字段

可选

searchTokensTotal float

搜索膨胀Tokens数（千tokens），说明：模型触发此功能时，返回该字段

可选

cachedCountTotal integer

Prompt cache触发次数，说明：模型触发此功能时，返回该字段

可选

cachedTokensTotal float

Prompt cache Tokens数（千tokens），说明：模型触发此功能时，返回该字段

可选

chatfileplusCountTotal integer

ChatfilePlus触发次数，说明：模型触发此功能时，返回该字段

可选

chatfileplusTokensTotal float

ChatfilePlus触发tokens数（千tokens），说明：模型触发此功能时，返回该字段

可选

successQpsAvg float

单位时间内成功请求的平均QPS

可选

successQpsMax integer

单位时间内成功请求的最大QPS

可选

failureQpsAvg float

单位时间内失败请求的平均QPS

可选

failureQpsMax integer

单位时间内失败请求的最大QPS

可选

JSON

{
    "requestId": "1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result": {
        "startTime": "2025-03-30T16:00:00Z",
        "endTime": "2025-03-31T15:59:00Z",
        "serviceList": [
            {
                "serviceId": "svco-tv5t4zpkj3da",
                "serviceName": "sunyueru0506",
                "appList": [
                    {
                        "appId": "1483416575",
                        "metrics": [
                            {
                                "timeStamp": 1746002820,
                                "tpm": [],
                                "rpm": [],
                                "timeToFirstTokenP99": 0,
                                "timeToFirstTokenP90": 0,
                                "timeToFirstTokenP50": 0,
                                "latencyP99": 11416,
                                "latencyP90": 11416,
                                "latencyP50": 11416,
                                "outputTokensPerSecondP99": 0,
                                "outputTokensPerSecondP90": 0,
                                "outputTokensPerSecondP50": 0,
                                "inputTokensTotal": 555.555,
                                "outputTokensTotal": 22.222,
                                "tokensTotal": 577.777,
                                "succeedCallTotal": 880,
                                "failureCallTotal": 120,
                                "callTotal": 1000,
                                "searchCountTotal": 50,
                                "searchTokensTotal": 525.525,
                                "cachedCountTotal": 0,
                                "cachedTokensTotal": 0,
                                "chatfileplusCountTotal": 6,
                                "chatfileplusTokensTotal": 6.666,
                                "successQpsAvg": 0.5,
                                "successQpsMax": 15,
                                "failureQpsAvg": 0.1,
                                "failureQpsMax": 3
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

错误码

若请求错误，服务器将返回的JSON文本包含以下参数：

名称	描述
`requestId`	请求ID
`code`	错误码
`message`	错误描述信息，帮助理解和解决发生的错误

例如错误返回：

text

{
    "requestId":"6ba7b810-xxxc04fd430c8",
    "code":"AccessDenied",
    "message":"Access denied."
}

更多其他错误码，也可以查看错误码说明。

百度智能云

千帆AI应用开发者中心-API参考 qianfan-api

千帆AI应用开发者中心-API参考 qianfan-api

鉴权说明

请求参数

示例代码

返回响应

错误码