> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/compute/aig/datastructure.md).

# 数据结构

## AiGatewayInfo

描述AI网关实例的信息。包括过期策略，状态，模型限制等。

被如下接口引用：DescribeAiGateways

| 参数名称            | 类型                          | 描述            |
| --------------- | --------------------------- | ------------- |
| gatewayUuid     | String                      | AI网关唯一ID。     |
| gatewayName     | String                      | AI网关显示名称。     |
| enabled         | Boolean                     | 是否启用。         |
| createdAt       | String                      | 创建时间。         |
| updatedAt       | String                      | 更新时间。         |
| resourceGroupId | String                      | AI网关所属的资源组ID。 |
| accessLimit     | Integer                     | 配额。           |
| expireType      | [ExpireType](#expiretype)   | 过期时间类型。       |
| expireTime      | String                      | 过期时间。         |
| modelAccess     | [ModelAccess](#modelaccess) | 模型访问限制。       |
| tags            | [Tags](#tags)               | AI网关关联的标签。    |

## AiGatewayModel

描述AI网关关联模型的信息。包模型uuid和模型名称。

被如下接口引用：DescribeAiGatewayModels

| 参数名称      | 类型     | 描述      |
| --------- | ------ | ------- |
| modelUuid | String | 模型uuid。 |
| modelName | String | 模型名称。   |

## AiModel

描述AI网关模型的信息。包模型uuid、模型名称、模型类型等。

被如下接口引用：DescribeAiModels

| 参数名称         | 类型     | 描述      |
| ------------ | ------ | ------- |
| modelUuid    | String | 模型uuid。 |
| modelName    | String | 模型名称。   |
| modelType    | String | 模型类型。   |
| providerName | String | 厂商名称。   |

## DailyMetricItem

日用量条目。

被如下接口引用：DescribeAiModelDailyUsage

| 参数名称         | 类型                                           | 描述                |
| ------------ | -------------------------------------------- | ----------------- |
| date         | String                                       | 日期，格式：yyyy-MM-dd。 |
| model\_usage | Array of [ModelDailyUsage](#modeldailyusage) | 各模型用量列表。          |

## ExpireType

描述AI网关过期策略

被如下接口引用：DescribeAiGateways, CreateAiGateway, ModifyAiGatewayExpireTime, DescribeAiGatewayExpireTime

| 值           | 值说明     |
| ----------- | ------- |
| LONG\_LIVED | 长期      |
| CUSTOM      | 自定义过期时间 |

## GatewayStatus

描述AI网关的配置状态

被如下接口引用：DescribeAiGateways

| 值           | 值说明  |
| ----------- | ---- |
| CREATING    | 创建中  |
| CONFIGURING | 配置中  |
| SUCCEED     | 配置成功 |
| FAILED      | 配置失败 |

## IpAclType

描述AI网关IP黑白名单的类型

被如下接口引用：ModifyAiGatewayIpAcl, DescribeAiGatewayIpAcl

| 值     | 值说明   |
| ----- | ----- |
| WHITE | IP白名单 |
| BLACK | IP黑名单 |

## ModelAccess

描述AI网关访问模型是否受限

被如下接口引用：DescribeAiGateways, ModifyAiGatewayModels, CreateAiGateway

| 值         | 值说明                |
| --------- | ------------------ |
| UNLIMITED | 不限制模型，可使用当前上架的所有模型 |
| LIMITED   | 受限，只可使用关联的模型       |

## ModelCacheHitSeries

描述模型日缓存命中率信息。

被如下接口引用：DescribeAiModelDailyCacheHitRate

| 参数名称      | 类型              | 描述                    |
| --------- | --------------- | --------------------- |
| modelName | String          | 模型名称。                 |
| data      | Array of String | 模型日缓存命中率列表，格式如 "90%"。 |

## ModelCostSeries

描述模型日费用信息。

被如下接口引用：DescribeAiModelDailyCost

| 参数名称      | 类型             | 描述       |
| --------- | -------------- | -------- |
| modelName | String         | 模型名称。    |
| data      | Array of Float | 模型日费用列表。 |

## ModelDailyUsage

模型日用量。

被如下接口引用：DescribeAiModelDailyUsage

| 参数名称                     | 类型      | 描述                       |
| ------------------------ | ------- | ------------------------ |
| modelName                | String  | 模型名称。                    |
| promptMissedTokens       | Integer | 未命中缓存的输入Token数。          |
| completionTokens         | Integer | 输出Token数。                |
| cachedTokens             | Integer | 命中缓存的Token数。             |
| cacheCreationInputTokens | Integer | 缓存创建Token数（Anthropic模型）。 |
| reasoningTokens          | Integer | 推理Token数。                |

## ModelValueItem

模型用量值项

被如下接口引用：DescribeAiUsageDetailData

| 参数名称  | 类型      | 描述    |
| ----- | ------- | ----- |
| model | String  | 模型名称。 |
| value | Integer | 用量值。  |

## Tag

描述一个标签键值对的信息。

被如下接口引用：DescribeAiGateways, CreateAiGateway

| 参数名称  | 类型     | 必选 | 描述                              |
| ----- | ------ | -- | ------------------------------- |
| key   | String | 是  | <p>标签键。</p><p>长度限制：1～64个字符。</p> |
| value | String | 否  | <p>标签值。</p><p>长度限制：1～64个字符。</p> |

## TagAssociation

描述创建资源时同时绑定的标签对的信息。

被如下接口引用：CreateAiGateway

| 参数名称 | 类型                   | 必选 | 描述     |
| ---- | -------------------- | -- | ------ |
| tags | Array of [Tag](#tag) | 是  | 标签对列表。 |

## Tags

描述资源关联的标签信息。

被如下接口引用：DescribeAiGateways

| 参数名称 | 类型                   | 描述     |
| ---- | -------------------- | ------ |
| tags | Array of [Tag](#tag) | 标签对列表。 |

## UsageData

描述AI网关模型用量信息。

被如下接口引用：DescribeAiUsageData

| 参数名称          | 类型      | 描述                              |
| ------------- | ------- | ------------------------------- |
| modelUuid     | String  | 模型uuid。                         |
| modelName     | String  | 模型名称。                           |
| totalTokens   | Integer | <p>模型总token数。</p><p>默认值：0</p>   |
| totalRequests | Integer | <p>模型总request数。</p><p>默认值：0</p> |

## UsageDataPoint

用量数据点，包含时间戳和各模型的用量值

被如下接口引用：DescribeAiUsageDetailData

| 参数名称 | 类型                                         | 描述         |
| ---- | ------------------------------------------ | ---------- |
| time | Integer                                    | 时间戳（毫秒）。   |
| data | Array of [ModelValueItem](#modelvalueitem) | 各模型的用量值列表。 |