ModelRouterQueryCostOverviewMetrics - 获取用量概览指标

更新时间:
复制 MD 格式

计费管理/获取成本概览指标

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aicontent:ModelRouterQueryCostOverviewMetrics

list

*全部资源

*

请求语法

GET /api/v1/modelRouter/open/billing/cost/overview HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

startTime

integer

开始时间,Unix 时间戳(秒)

1700000000

endTime

integer

结束时间,Unix 时间戳(秒)

1700086400

modelTypes

string

模型类型,逗号分隔

LLM,VL

clientId

integer

部门 ID 过滤

1

apiKeyId

integer

100

granularity

string

自动聚合,无需传入。粒度:hourly/daily,默认 hourly

hourly

maxResults

integer

最大结果数

10

nextToken

string

nextToken

xxxx-xxx-xxxxx

返回参数

名称

类型

描述

示例值

object

OpenApiSingleResponse<List>

{ "success": true, "data": [{"key": "total_calls", "label": "调用次数", "unit": "次", "value": 100}], "requestId": "592A27EF-26D3-1434-98C1-97AD63337852" }

requestId

string

请求编号

xxxx-xxxx-xxxx-xxxxxxxx

success

boolean

是否成功

true

errCode

string

错误信息编码

UNKNOWN_ERROR

errMessage

string

错误信息

未知错误

httpStatusCode

integer

http 状态码

200

data

array

数据对象

[]

MetricValueDTO

返回数据结构体

[]

maxResults

integer

最大结果数

10

nextToken

string

nextToken

xxxx-xxx-xxxxx

示例

正常返回示例

JSON格式

{
  "requestId": "xxxx-xxxx-xxxx-xxxxxxxx",
  "success": true,
  "errCode": "UNKNOWN_ERROR",
  "errMessage": "未知错误",
  "httpStatusCode": 200,
  "data": [
    {
      "key": "total_calls",
      "label": "调用次数",
      "unit": "次",
      "value": 100
    }
  ],
  "maxResults": 10,
  "nextToken": "xxxx-xxx-xxxxx"
}

错误码

HTTP status code

错误码

错误信息

描述

500 Server.Internal.UnknownError The request processing has failed due to some unknown error.
403 B.Permission.DeniedException 鉴权失败或权限不足
403 B.Permission.OrgNoExistException 组织不存在,请主账号开通权限后再试,或联系管理员

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

变更历史

更多信息,参考变更详情