Get Account Usage

查询个人账户的 Usage、Provider 和 Performance 数据，查询粒度与开桥控制台 Analysis > Usage 一致。

http

GET https://openqiao.com/api/v1/management/usage

鉴权

Authorization Header *

http

Authorization: Bearer <OPENQIAO_MANAGEMENT_API_KEY>

参数名：Authorization
格式：Bearer <API_KEY>
说明：Management API Key，使用个人账户在开桥控制台创建

仅支持 Management API Key

仅接受个人账户直接创建的 sk-mg-v1-* Management API Key。普通 API Key、OAuth access token 和组织 Management Key 均不支持。

查询参数

参数	必填	说明
`type`	是	`usage`、`provider` 或 `performance`
`query_dimension`	是	`BIZ_MTH`、`BIZ_DT` 或 `BIZ_HOUR`
`query_time`	是	与查询维度对应的 `YYYYMM`、`YYYYMMDD` 或 `YYYYMMDDHH`
`api_key_ids`	否	API Key ID，多个值用逗号分隔；为空表示个人账户全部 API Key
`model_slugs`	否	模型 slug，多个值用逗号分隔；`provider` 必须且只能传一个模型
`bill_types`	否	`metered`：按量付费，扣账户余额；`subscription`：使用订阅额度；`fallbackMetered`：订阅转按量付费的兜底用量。多个值用逗号分隔，留空查询全部类型

type=usage 或 type=performance 时，若不传 api_key_ids、model_slugs 和 bill_types（或留空），将查询当前 Management Key 所属个人账户在 query_dimension、query_time 指定周期内的全部汇总和分组统计数据。

type=provider 仍必须通过 model_slugs 指定且仅指定一个模型；api_key_ids 和 bill_types 可以省略。

BIZ_MTH 返回所选月的按日序列，BIZ_DT 返回所选日的按小时序列，BIZ_HOUR 返回所选小时的按分钟序列。使用 BIZ_HOUR 时，需要像控制台一样先把本地小时转换成 UTC，再生成 query_time。

CSV 参数会去除空白和重复值。未知参数、非法日期返回 400。

api_key_ids 仅支持当前个人账户下未删除的推理或订阅 API Key ID；传入 Management Key ID、其他账户的 Key ID 或已删除的 Key ID，将返回 403。

返回值

success `boolean`

请求是否成功。成功响应中固定为 true。

data `object`

查询结果，结构由 type 决定。以下所有汇总和分组数据都应用本次请求的账户、时间及筛选条件。

费用口径

Flow 是开桥订阅计划的计费单位，其美元等价价值会浮动；PAYG 桥票（Credits）则固定为 1 桥票 = 1 美元。

对于 subscription 用量，返回的花费仅为 USD 参考价格，不代表实际扣款金额或订阅套餐费用。metered 和 fallbackMetered 按 PAYG 计费；混合查询订阅与 PAYG 用量时，汇总花费不能直接视为实际扣款金额。

金额、Token 数、计数、比例和性能指标的非空值均为十进制字符串，而非 JSON 数字。null 表示没有可用统计值或当前分组不使用该字段，不等同于 "0"。无数据时仍可返回成功响应，数组为空，汇总字段可能为 null。

时间序列中的 bizTime 按 query_dimension 使用以下格式：

`query_dimension`	每条记录的粒度	`bizTime` 格式	示例
`BIZ_MTH`	日	`YYYYMMDD`	`"20260903"`
`BIZ_DT`	小时	`YYYYMMDDHH`	`"2026090312"`
`BIZ_HOUR`	分钟	`YYYYMMDDHHmm`	`"202609031215"`

Usage (`type=usage`)

data.tokensTotal `string | null`

当前筛选范围内的 Token 总数。

data.tokensPrompt `string | null`

当前筛选范围内的输入 Token 数。

data.tokensCompletion `string | null`

当前筛选范围内的输出 Token 数。

data.requestCounts `string | null`

当前筛选范围内的请求总数。

下面的 tokensByModel、tokensByTokenType 和 tokensByApiKey 是同一用量的不同分组方式，不应将三个数组的 Token 数重复相加。

data.tokensByModel `array`

按时间和模型分组。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string — 模型标识，例如 openai/gpt-5，不是模型展示名称。
tokenType string | null — 当前分组不按 Token 类型拆分，通常为 null。
apiKeyId string | null — 当前分组不按 API Key 拆分，通常为 null。
tokens string | null — 该分组在当前时间桶内的 Token 数。
requestCounts string | null — 该分组在当前时间桶内的请求数。

data.tokensByTokenType `array`

按时间和 Token 类型分组。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string | null — 当前分组不按模型拆分，通常为 null。
tokenType string — 计费 Token 类型，例如 prompt（输入）或 completion（输出）。
apiKeyId string | null — 当前分组不按 API Key 拆分，通常为 null。
tokens string | null — 该分组在当前时间桶内的 Token 数。
requestCounts string | null — 该分组通常不返回请求数，此时为 null。

data.tokensByApiKey `array`

按时间和 API Key 分组。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string | null — 当前分组不按模型拆分，通常为 null。
tokenType string | null — 当前分组不按 Token 类型拆分，通常为 null。
apiKeyId string — API Key 的资源 ID，与 api_key_ids 使用的值相同，不是密钥 token。
tokens string | null — 该分组在当前时间桶内的 Token 数。
requestCounts string | null — 该分组在当前时间桶内的请求数。

data.countsByWebSearch `array`

按时间和模型分组的 Web Search 请求数。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string — 模型标识，例如 openai/gpt-5，不是模型展示名称。
tokenType string | null — 当前分组不按 Token 类型拆分，通常为 null。
apiKeyId string | null — 当前分组不按 API Key 拆分，通常为 null。
tokens string | null — Web Search 按次数统计，此字段通常为 null，不表示搜索的 Token 消耗。
requestCounts string | null — 该模型在当前时间桶内的 Web Search 请求数，不要与整体请求总数重复相加。

Provider (`type=provider`)

model_slugs 必须且只能包含一个模型。data 返回该模型在当前筛选范围内的 Endpoint 统计：

data.fastestEndpointSlug `string | null`

当前查询范围内响应最快的 Endpoint 标识；无法确定时可为 null。

data.mainEndpointSlug `string | null`

当前查询范围内请求量最大的主要 Endpoint 标识；无法确定时可为 null。

data.uptime `string | null`

所选模型的整体请求成功率，范围 0～1。例如 "0.9920" 表示 99.20%，不是运行时长。

data.endpointCount `string | null`

当前查询范围内的 Endpoint 数量，以字符串表示。

data.endpointUsages `array`

按 Endpoint 拆分的统计。每个元素包含：

endpointSlug string — 接入点标识，用于区分所选模型实际使用的 Endpoint。
requestCounts string | null — 该 Endpoint 的请求总数。
tokens string | null — 该 Endpoint 的 Token 总数。
requestRatio string | null — 该 Endpoint 的请求数占当前查询请求总数的比例，范围 0～1；"0.8" 表示 80%。
tokenRatio string | null — 该 Endpoint 的 Token 数占当前查询 Token 总数的比例，范围 0～1。
medianLatency string | null — 该 Endpoint 的请求延迟中位数，单位毫秒（ms），不是平均延迟。
medianThroughput string | null — 该 Endpoint 的吞吐量中位数，单位 Token/秒。
billAmount string | null — 该 Endpoint 对应的费用，单位 USD。
billAmountRatio string | null — 该 Endpoint 的费用占当前查询总费用的比例，范围 0～1。

Performance (`type=performance`)

data.medianLatency `string | null`

当前筛选范围内的请求延迟中位数，单位毫秒（ms），不是平均延迟。

data.medianThroughput `string | null`

当前筛选范围内的吞吐量中位数，单位 Token/秒。

不应通过对各模型的中位数取平均来计算整体中位数。

data.modelPerformances `array`

按模型汇总的性能数据。每个元素包含：

modelSlug string — 模型标识，例如 openai/gpt-5，不是模型展示名称。
medianLatency string | null — 该模型的请求延迟中位数，单位毫秒（ms）。
medianThroughput string | null — 该模型的吞吐量中位数，单位 Token/秒。

data.latencyDetails `array`

按时间和模型分组的延迟序列。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string — 模型标识，例如 openai/gpt-5，不是模型展示名称。
medianLatency string | null — 该模型在当前时间桶内的请求延迟中位数，单位毫秒（ms）。

data.throughputDetails `array`

按时间和模型分组的吞吐量序列。每个元素包含：

bizTime string — 统计时间桶标识，格式见上方时间表，不是单次请求的发生时间。
modelSlug string — 模型标识，例如 openai/gpt-5，不是模型展示名称。
medianThroughput string | null — 该模型在当前时间桶内的吞吐量中位数，单位 Token/秒。

cURL

curl -G https://openqiao.com/api/v1/management/usage \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY" \
  --data-urlencode "type=usage" \
  --data-urlencode "query_dimension=BIZ_MTH" \
  --data-urlencode "query_time=202609" \
  --data-urlencode "api_key_ids=key_1,key_2" \
  --data-urlencode "model_slugs=openai/gpt-5" \
  --data-urlencode "bill_types=metered,subscription"

json

{
  "success": true,
  "data": {
    "tokensTotal": "1500000",
    "tokensPrompt": "1000000",
    "tokensCompletion": "500000",
    "requestCounts": "125",
    "tokensByModel": [
      {
        "bizTime": "20260903",
        "modelSlug": "openai/gpt-5",
        "tokenType": null,
        "apiKeyId": null,
        "tokens": "1500000",
        "requestCounts": "125"
      }
    ],
    "tokensByTokenType": [
      {
        "bizTime": "20260903",
        "modelSlug": null,
        "tokenType": "prompt",
        "apiKeyId": null,
        "tokens": "1000000",
        "requestCounts": null
      },
      {
        "bizTime": "20260903",
        "modelSlug": null,
        "tokenType": "completion",
        "apiKeyId": null,
        "tokens": "500000",
        "requestCounts": null
      }
    ],
    "tokensByApiKey": [
      {
        "bizTime": "20260903",
        "modelSlug": null,
        "tokenType": null,
        "apiKeyId": "key_1",
        "tokens": "1000000",
        "requestCounts": "80"
      },
      {
        "bizTime": "20260903",
        "modelSlug": null,
        "tokenType": null,
        "apiKeyId": "key_2",
        "tokens": "500000",
        "requestCounts": "45"
      }
    ],
    "countsByWebSearch": [
      {
        "bizTime": "20260903",
        "modelSlug": "openai/gpt-5",
        "tokenType": null,
        "apiKeyId": null,
        "tokens": null,
        "requestCounts": "3"
      }
    ]
  }
}

cURL

curl -G https://openqiao.com/api/v1/management/usage \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY" \
  --data-urlencode "type=provider" \
  --data-urlencode "query_dimension=BIZ_DT" \
  --data-urlencode "query_time=20260903" \
  --data-urlencode "model_slugs=openai/gpt-5"

json

{
  "success": true,
  "data": {
    "fastestEndpointSlug": "provider-a",
    "mainEndpointSlug": "provider-a",
    "uptime": "0.9920",
    "endpointCount": "2",
    "endpointUsages": [
      {
        "endpointSlug": "provider-a",
        "requestCounts": "100",
        "tokens": "1200000",
        "requestRatio": "0.8000",
        "tokenRatio": "0.8000",
        "medianLatency": "320",
        "medianThroughput": "85.5",
        "billAmount": "9.1234000000",
        "billAmountRatio": "0.7390"
      },
      {
        "endpointSlug": "provider-b",
        "requestCounts": "25",
        "tokens": "300000",
        "requestRatio": "0.2000",
        "tokenRatio": "0.2000",
        "medianLatency": "410",
        "medianThroughput": "76.5",
        "billAmount": "3.2222000000",
        "billAmountRatio": "0.2610"
      }
    ]
  }
}

cURL

curl -G https://openqiao.com/api/v1/management/usage \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY" \
  --data-urlencode "type=performance" \
  --data-urlencode "query_dimension=BIZ_HOUR" \
  --data-urlencode "query_time=2026090312" \
  --data-urlencode "model_slugs=openai/gpt-5,anthropic/claude-sonnet-4"

json

{
  "success": true,
  "data": {
    "medianThroughput": "82.5",
    "medianLatency": "340",
    "modelPerformances": [
      {
        "modelSlug": "openai/gpt-5",
        "medianLatency": "320",
        "medianThroughput": "85.5"
      },
      {
        "modelSlug": "anthropic/claude-sonnet-4",
        "medianLatency": "360",
        "medianThroughput": "79.5"
      }
    ],
    "latencyDetails": [
      {
        "bizTime": "202609031215",
        "modelSlug": "openai/gpt-5",
        "medianLatency": "320"
      },
      {
        "bizTime": "202609031215",
        "modelSlug": "anthropic/claude-sonnet-4",
        "medianLatency": "360"
      }
    ],
    "throughputDetails": [
      {
        "bizTime": "202609031215",
        "modelSlug": "openai/gpt-5",
        "medianThroughput": "85.5"
      },
      {
        "bizTime": "202609031215",
        "modelSlug": "anthropic/claude-sonnet-4",
        "medianThroughput": "79.5"
      }
    ]
  }
}

限流与错误

个人 Usage 和 Cost 两条接口按账户共享每分钟 60 次请求。第 61 次返回 429，并携带 Retry-After: 60。平台现有 Management API 限流仍然生效。

状态码	含义
400	查询参数缺失、格式错误、不支持或互相不匹配
401	缺少 Authorization
403	凭证类型、账户类型或 API Key ID 无权访问
429	Usage/Cost 共享限流超限
502	Usage/Cost 数据服务调用失败

Get Account Usage ​

鉴权 ​

Authorization Header * ​

查询参数 ​

返回值 ​

success boolean ​

data object ​

Usage (type=usage) ​

data.tokensTotal string | null ​

data.tokensPrompt string | null ​

data.tokensCompletion string | null ​

data.requestCounts string | null ​

data.tokensByModel array ​

data.tokensByTokenType array ​

data.tokensByApiKey array ​

data.countsByWebSearch array ​

Provider (type=provider) ​

data.fastestEndpointSlug string | null ​

data.mainEndpointSlug string | null ​

data.uptime string | null ​

data.endpointCount string | null ​

data.endpointUsages array ​

Performance (type=performance) ​

data.medianLatency string | null ​

data.medianThroughput string | null ​

data.modelPerformances array ​

data.latencyDetails array ​

data.throughputDetails array ​

限流与错误 ​

Get Account Usage

鉴权

Authorization Header *

查询参数

返回值

success `boolean`

data `object`

Usage (`type=usage`)

data.tokensTotal `string | null`

data.tokensPrompt `string | null`

data.tokensCompletion `string | null`

data.requestCounts `string | null`

data.tokensByModel `array`

data.tokensByTokenType `array`

data.tokensByApiKey `array`

data.countsByWebSearch `array`

Provider (`type=provider`)

data.fastestEndpointSlug `string | null`

data.mainEndpointSlug `string | null`

data.uptime `string | null`

data.endpointCount `string | null`

data.endpointUsages `array`

Performance (`type=performance`)

data.medianLatency `string | null`

data.medianThroughput `string | null`

data.modelPerformances `array`

data.latencyDetails `array`

data.throughputDetails `array`

限流与错误