计费管理/获取成本概览指标
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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 | 组织不存在,请主账号开通权限后再试,或联系管理员 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。