# 数据结构

## AiUsageData

AI 网关用量汇总信息。

被如下接口引用：DescribeAiUsageData

| 参数名称               | 类型                                     | 描述                       |
| ------------------ | -------------------------------------- | ------------------------ |
| instanceModelToken | Array of [AiModelToken](#aimodeltoken) | 各模型的用量统计明细列表。            |
| totalInputTokens   | Long                                   | 查询时间范围内所有模型的总输入 token 数。 |
| totalOutputTokens  | Long                                   | 查询时间范围内所有模型的总输出 token 数。 |

## AiModelToken

AI 模型用量统计信息。

被如下接口引用：DescribeAiUsageData

| 参数名称          | 类型     | 描述                              |
| ------------- | ------ | ------------------------------- |
| modelName     | String | 模型名称，例如 `gpt-4o`。               |
| modelUuid     | String | 模型唯一标识 UUID。                    |
| totalRequests | Long   | 该模型在查询时间范围内的请求总次数。              |
| totalTokens   | Long   | 该模型在查询时间范围内消耗的 token 总数（输入+输出）。 |

## AiUsageDetailData

AI 网关用量明细信息。

被如下接口引用：DescribeAiUsageDataDetail

| 参数名称       | 类型                                               | 描述                       |
| ---------- | ------------------------------------------------ | ------------------------ |
| request    | Array of [AiUsageTimeSeries](#aiusagetimeseries) | 各时间点的请求次数明细。             |
| inputToken | Array of [AiUsageTimeSeries](#aiusagetimeseries) | 各时间点的输入 token 数明细。       |
| outToken   | Array of [AiUsageTimeSeries](#aiusagetimeseries) | 各时间点的输出 token 数明细。       |
| token      | Array of [AiUsageTimeSeries](#aiusagetimeseries) | 各时间点的总 token 数明细（输入+输出）。 |

## AiUsageTimeSeries

描述某一时间点按模型维度统计的用量数据。

被如下接口引用：DescribeAiUsageDataDetail

| 参数名称        | 类型   | 描述                                                                |
| ----------- | ---- | ----------------------------------------------------------------- |
| time        | Long | 数据时间，13 位 Unix 时间戳（毫秒），使用 UTC 时间。                                 |
| {modelName} | Long | 动态字段，字段名称为模型名称（例如 `gemini-2.5-flash`、`gpt-4o`），字段值为该模型在该时间点的指标数值。 |

## AiModelInfo

AI 模型信息。

被如下接口引用：DescribeAiModels

| 参数名称         | 类型     | 描述                    |
| ------------ | ------ | --------------------- |
| modelName    | String | 模型名称，例如 `gpt-4o`。     |
| modelType    | String | 模型类型，例如 `LLMs`。       |
| modelUuid    | String | 模型唯一标识 UUID。          |
| providerName | String | 模型提供商名称，例如 `Open AI`。 |

## AiGatewayInfo

AI 网关实例信息。

被如下接口引用：DescribeAiGateways

| 参数名称            | 类型      | 描述                                                                 |
| --------------- | ------- | ------------------------------------------------------------------ |
| gatewayUuid     | String  | AI 网关实例 UUID。                                                      |
| gatewayName     | String  | AI 网关名称。                                                           |
| createdAt       | String  | 创建时间，ISO8601 格式 UTC 时间，示例：`2025-12-04T08:39:13Z`。                  |
| updatedAt       | String  | 更新时间，ISO8601 格式 UTC 时间，示例：`2025-12-24T07:30:35Z`。                  |
| accessLimit     | Long    | token 数量限制，`0` 表示不限制。                                              |
| expireTime      | String  | token 过期时间，ISO8601 格式 UTC 时间，示例：`2025-12-11T07:14:55Z`，可能为 `null`。 |
| expireType      | String  | token 过期策略类型，例如 `CUSTOM`、`LONG_LIVED`。                             |
| modelAccess     | String  | 模型访问策略类型，例如 `UNLIMITED`。                                           |
| enabled         | Boolean | 是否可用。                                                              |
| resourceGroupId | String  | 资源组 ID。                                                            |

## AiModelDailyCostData

AI 网关模型每日费用统计信息。

被如下接口引用：DescribeAiModelDailyCost

| 参数名称   | 类型                                               | 描述                                              |
| ------ | ------------------------------------------------ | ----------------------------------------------- |
| series | Array of [AiModelCostSeries](#aimodelcostseries) | 各模型的每日费用时间序列数据列表。                               |
| dates  | Array of String                                  | 日期列表，格式为 `YYYY-MM-DD`，与 series 中的 data 数组按顺序对应。 |

## AiModelCostSeries

AI 模型费用时间序列数据。

被如下接口引用：DescribeAiModelDailyCost

| 参数名称      | 类型             | 描述                                                                 |
| --------- | -------------- | ------------------------------------------------------------------ |
| modelName | String         | 模型名称，例如 `gpt-4o`、`claude-haiku-4-5-20251001`。                      |
| data      | Array of Float | 该模型在各日期的费用数据（单位：美元），数组元素与 AiModelDailyCostData 中的 dates 数组按顺序一一对应。 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/api-reference/cn/compute/aig/datastructure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.