DescribeModelOperatorUsage - 获取模型算子用量 - 云原生数据仓库AnalyticDB

获取模型算子用量。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Keys	array	否	指标列表。多个指标用英文半角“,”分隔。取值如下： request_count：请求数。 success_count：请求成功数。 error_count：请求失败数。 success_rate：请求成功率。 input_token：输入 token 数。 output_token：输出 token 数。 total_token：总 token 数。
	string	否	指标名称。	request_count, success_count
StartTime	string	否	查询开始时间。格式为YYYY-MM-DDThh:mmZ（UTC 时间）。说明仅支持查询 30 天内的指标信息。	2026-06-01T00:00Z
EndTime	string	否	查询结束时间。格式为YYYY-MM-DDThh:mmZ（UTC 时间）。说明查询结束时间需晚于开始时间，且开始时间和结束时间的时间间隔不能超过 7 天。	2026-06-02T00:00Z
ApiKeyIds	array	否	API KEY ID 列表。多个指标用英文半角“,”分隔。如果不传，默认是实例 ID 下所有的 API KEY ID。说明列表项最多 50 个。
	integer	否	API KEY ID。	1
ModelNames	array	否	模型名称列表。多个指标用英文半角“,”分隔。
	string	否	模型名称。	qwen3.6-plus
GroupBy	string	否	series 切分维度，用英文半角“,”分隔，顺序不敏感。取值如下： model（默认值）：按模型切分。 api_key：按 apikey 切分。 model,api_key：按模型、apikey 切分。	model
Period	integer	否	时间桶大小（秒）。取值在 {1, 5, 15, 60, 300, 3600} 内。说明当 Period 未传时，按如下规则选择默认值：窗口范围 ≤ 1 小时，Period = 1。窗口范围 ≤ 1 天，Period = 60。窗口范围 ≤ 7 天，Period = 60。 Period=1 时窗口必须 ≤1 天。	1

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	ABB39CC3-4488-4857-905D-2E4A051D0521
StartTime	string	查询开始时间。格式为YYYY-MM-DDThh:mmZ（UTC 时间）。	2026-06-01T00:00Z
EndTime	string	查询结束时间。格式为YYYY-MM-DDThh:mmZ（UTC 时间）。	2026-06-02T00:00Z
Period	integer	最终采用的桶大小（秒）。	1
Keys	array<object>	指标值列表。
	array<object>	指标值详情。
Name	string	指标名称。	request_count
Unit	string	单位。取值如下： requests tokens %	requests
Series	array<object>	指标值集合。
	array<object>	切分后的指标值详情。
Role	string	归一化后的 GroupBy：model / api_key / model,api_key。	model
Name	string	GroupBy 含 model 时为模型名；仅 api_key 时为 api_key_id 字符串。	qwen3.6-plus
ApiKeyId	integer	仅当 GroupBy 含 api_key 返回该值。	1
Values	array<object>	指标值列表，每个值对应一个采集时间点。
	object	指标值详情。
Point	array	指标具体信息，由时间和指标值构成。
	string	指标具体信息。	["2026-06-01T00:00:00Z","1"]

示例

正常返回示例

JSON格式

{
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
  "StartTime": "2026-06-01T00:00Z",
  "EndTime": "2026-06-02T00:00Z",
  "Period": 1,
  "Keys": [
    {
      "Name": "request_count",
      "Unit": "requests",
      "Series": [
        {
          "Role": "model",
          "Name": "qwen3.6-plus",
          "ApiKeyId": 1,
          "Values": [
            {
              "Point": [
                "[\"2026-06-01T00:00:00Z\",\"1\"]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。