获取 Agent 峰值 RPM

按时间区间获取某个 Agent 的峰值 RPM（每分钟请求数），同时返回峰值发生的时刻、平均 RPM 和请求总数。

注意：最多查询 31 天的数据；只统计开发空间的渠道，统计范围见下方「统计口径」。

请求方式

GET

调用地址

https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm

调用验证

使用账号级 DevKey / DevSecret 的 Basic 鉴权：Authorization: Basic ${BASIC_TOKEN}，其中 ${BASIC_TOKEN} 为 DevKey:DevSecret 的 Base64 编码。

调用账号必须是 org_id 对应组织的成员，并具备「用量查看」权限（组织 Owner、管理员默认具备），同时要能查看该 Agent：Agent 创建者、组织 Owner，或被授予了该 Agent（或全部 Agent）权限的成员。
请调用组织所在数据中心的地址，${endpoint} 取查询组织列表返回的 region（SG → sg、TH → th、JP → jp）。调用了其它数据中心会返回「不是该组织成员」。

调用频率

每个开发者密钥调用本接口每分钟最多 60 次。
每次调用同时计入组织套餐「统计类 API」的每分钟额度，与 Agent API Key 调用统计类接口共用该额度。
数据每小时更新一次，同一小时内重复查询返回同一份结果，建议每小时调用一次。

请求

请求示例

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1788796800000' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1788796800000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

此代碼塊在浮窗中顯示

请求头

字段	类型	描述
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 后的 Basic Token。

请求参数

字段	类型	必填	描述
org_id	String	是	组织 ID。
agent_id	String	是	Agent ID。不支持 Workflow。
start_time	Long	是	开始时间，毫秒时间戳。向下对齐到整点。
end_time	Long	是	结束时间（不含），毫秒时间戳。向上对齐到整点。对齐后的区间不能超过 31 天。
conversation_type	String	否	只看某个渠道，如 `API`、`SHARE`、`EMBED`、`WIDGET`、`LIVEDESK`。只能是开发空间的渠道；不传则统计全部开发空间渠道。

响应

响应示例

{ "code": 0, "message": "OK", "data": { "agent_id": "65f0c2a1b4e8d93a1c7e5b21", "range_start": 1788192000000, "range_end": 1788796800000, "data_until": 1788793200000, "peak_rpm": 42, "peak_at": 1788512460000, "avg_rpm": 3.18, "total_requests": 18234 } }

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "agent_id": "65f0c2a1b4e8d93a1c7e5b21",
        "range_start": 1788192000000,
        "range_end": 1788796800000,
        "data_until": 1788793200000,
        "peak_rpm": 42,
        "peak_at": 1788512460000,
        "avg_rpm": 3.18,
        "total_requests": 18234
    }
}

此代碼塊在浮窗中顯示

成功响应

字段	类型	描述
agent_id	String	Agent ID。
range_start	Long	实际统计区间的起点：`start_time` 向下对齐到整点后的毫秒时间戳。
range_end	Long	实际统计区间的终点（不含）：`end_time` 向上对齐到整点后的毫秒时间戳。
data_until	Long	数据已经统计到的时刻（毫秒时间戳）。区间里晚于该时刻的部分还没有数据。
peak_rpm	Long	峰值 RPM：各渠道在同一分钟的请求数相加后，区间内最大的那一分钟的请求数。
peak_at	Long	峰值所在分钟的起点（毫秒时间戳）。多个分钟并列时取最早的一分钟；区间内没有请求时为 `null`。
avg_rpm	Number	平均 RPM：请求总数 ÷ 有请求的分钟数，保留 2 位小数。
total_requests	Long	区间内的请求总数。

失败响应

字段	类型	描述
code	Integer	错误码。
message	String	错误详情。

错误码

HTTP 状态码为错误码的前三位，例如 40000 对应 400、40100 对应 401、403132 对应 403。

错误码	描述
40000	参数错误，如缺少必填参数、参数取值不合法。
40001	调用过于频繁：该开发者密钥超过了本接口的每分钟上限。
40008	超过组织套餐「统计类 API」的每分钟额度。
40010	接口暂时关闭，请稍后再试。
40100	没有权限：缺少用量查看权限，或无权查看该 Agent（包括 Agent 不属于该组织）。
40105	不是该组织成员，或调用了其它数据中心的地址。
40324	DevKey 或 DevSecret 错误。
40378	Agent 已删除。
403132	时间范围无效：开始时间不早于结束时间，或超过了最大查询范围。

统计口径

请求：用户发出的提问消息，加上对话报错（包括因超过调用频率被拒绝的请求），与控制台「Agent 洞察 → 分均发起请求」一致。它不是 HTTP 请求数，与套餐限流的计数可能不同。
统计范围：只统计开发空间的渠道，包括 API、分享页、网页嵌入、气泡组件、LiveDesk 以及各即时通讯和电话渠道；不包括开发空间里的调试预览、Workflow 运行，以及该 Agent 发布到工作空间后在工作空间里的使用。
更新频率：数据每小时整点统计一次，约有 1 小时延迟，以 data_until 为准。2026-03-09 之前的数据没有分钟级明细，查询结果为 0。