DescribeAiUsageDataDetail

1. 接口描述

本接口 (DescribeAiUsageDataDetail) 用于查询指定 AI 网关实例在给定时间范围内的用量明细数据，按时间粒度和模型维度进行统计。

注意事项

• 本接口认证方式请参考认证方式

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数。

参数名称	必选	类型	描述
instanceIds	是	String	AI 网关实例 ID，多个实例使用英文逗号 , 分隔，例如 "1597...,1598..."。
start	是	Integer	查询起始时间，10 位 Unix 时间戳（秒），使用 UTC 时间。
end	是	Integer	查询结束时间，10 位 Unix 时间戳（秒），使用 UTC 时间，需大于 start。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。
response	AiUsageDetailData	业务响应数据，包含按时间维度的用量明细统计信息。

4. 代码示例

示例

1. 查询 AI 网关在指定时间范围内的用量明细。

POST / HTTP/1.1
Host: console.zenlayer.com/api/v2/aigw
Content-Type: application/json
X-TC-Action: DescribeAiUsageDataDetail
<Common Request Params>

Request:
{
    "instanceIds": "1597494548165039443",
    "start": 1772074800,
    "end": 1772075400
}
Response:
{
    "requestId": "T63CFC9EF-872E-4F8D-AE6C-D830D9FEFA7C",
    "response": {
        "request": [
            {
                "gemini-2.5-flash": 1,
                "time": 1772074800000,
                "gpt-4o": 2
            }
        ],
        "inputToken": [
            {
                "gemini-2.5-flash": 10,
                "time": 1772074800000,
                "gpt-4o": 41
            }
        ],
        "requestId": "T63CFC9EF-872E-4F8D-AE6C-D830D9FEFA7C",
        "outToken": [
            {
                "gemini-2.5-flash": 3335,
                "time": 1772074800000,
                "gpt-4o": 553
            }
        ],
        "token": [
            {
                "gemini-2.5-flash": 3345,
                "time": 1772074800000,
                "gpt-4o": 594
            }
        ]
    }
}

5. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码