DescribeAiUsageData

1. 接口描述

本接口 (DescribeAiUsageData) 用于查询指定 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	AiUsageData	业务响应数据，包含各模型用量统计信息。

4. 代码示例

示例

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

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

Request:
{
    "instanceIds": "1597494548165039443",
    "start": 1772074800,
    "end": 1772075400
}
Response:
{
    "requestId": "T24AB09E0-07A3-4FFA-931A-813959932AD9",
    "response": {
        "instanceModelToken": [
            {
                "modelName": "gemini-2.5-flash",
                "totalRequests": 1,
                "modelUuid": "hhlpwj8yhq",
                "totalTokens": 3345
            },
            {
                "modelName": "gpt-4o",
                "totalRequests": 2,
                "modelUuid": "551hvvb2g0",
                "totalTokens": 594
            }
        ],
        "requestId": "T24AB09E0-07A3-4FFA-931A-813959932AD9",
        "totalInputTokens": 51,
        "totalOutputTokens": 3888
    }
}

5. 错误码

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