大模型服务平台 TokenHub 数据结构

BatchCreateFailedItem

批量创建失败项

被如下接口引用：CreateTokenPlanApiKeys。

名称	类型	描述
Index	Integer	失败项的序号（从 1 开始，对应后缀编号）。示例值：1
Name	String	失败项的名称。示例值：aaa-1-x7k2m9
Reason	String	失败原因。示例值：create sub package failed

CreateApiKeysResultItem

批量创建成功项

被如下接口引用：CreateTokenPlanApiKeys。

名称	类型	描述
ApiKeyId	String	APIKey ID。示例值：ak-tp-20260401-a1b2c3d4

RequestFilter

过滤条件

被如下接口引用：DescribeTokenPlanApiKeyList, DescribeTokenPlanList。

名称	类型	必选	描述
Name	String	是	过滤字段名称。示例值：Brand
Op	String	是	过滤操作符。取值：EXACT（精确匹配）、FUZZY（模糊匹配）、NOT（排除匹配）。示例值：EXACT
Values	Array of String	是	过滤值列表。最多支持 10 个。示例值：["Tencent"]

RequestSort

排序条件

被如下接口引用：DescribeTokenPlanApiKeyList, DescribeTokenPlanList。

名称	类型	必选	描述
Name	String	是	排序字段名称。示例值：RecommendWeight
Order	String	是	排序方向。取值：ASC（升序）、DESC（降序）。示例值：DESC

SubPackageBalance

API Key 额度及用量信息

被如下接口引用：DescribeTokenPlanApiKey, DescribeTokenPlanApiKeyList。

名称	类型	描述
ExclusiveQuota	String	独占额度。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：500000
ExclusiveUsed	String	独占额度已用量。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：100000
ExclusiveRemain	String	独占额度剩余量。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：400000
SharedQuota	String	共享额度上限，-1 表示不限。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：-1
SharedUsed	String	共享额度已用量。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：50000
SharedRemain	String	共享额度剩余量。单位说明如下： - 套餐类型为专业套餐，单位取值为积分； - 套餐类型为轻享套餐，单位取值为 token。示例值：-1
Status	Integer	API Key 额度包状态。取值：0（正常）、1（耗尽）。示例值：0

TokenPlanApiKeyInfo

Token Plan API Key 详情

被如下接口引用：DescribeTokenPlanApiKey。

名称	类型	描述
ApiKeyId	String	API Key ID。示例值：ak-tp-20260401-a1b2c3d4
ApiKey	String	API Key 密钥值（脱敏）。示例值：sk-tp-xxxxxxxx
Name	String	API Key 名称。示例值：生产环境主Key
TeamId	String	所属套餐 ID。示例值：tp-ent-abcdefgh
AppId	String	账号APP ID。示例值：1300000001
Uin	String	主账号 UIN。示例值：100000000001
AllowedModels	String	API Key 可用模型列表（JSON 数组字符串）。示例值：["glm-5","kimi-k2.5","tc-code-latest"]
Status	String	API Key 是否可用。取值：enable（启用）、disable（停用）。示例值：enable
StopReason	String	API Key 停用原因。取值：NORMAL（正常，默认值），QUOTA_EXHAUSTED（API Key额度包耗尽），ABNORMAL（异常，需人工介入）示例值：NORMAL
UseStatus	String	用户侧开关。取值：enable（启用）、disable（停用）。示例值：enable
KeyVersion	Integer	密钥版本号。示例值：1
LastRotatedAt	Timestamp ISO8601	最近一次重置时间。（ISO 8601）示例值：2026-04-01T00:00:00Z
Creator	String	创建人，如果是子账号创建，则该值为子账号UIN。示例值：100000000002
CreatedAt	Timestamp ISO8601	创建时间。示例值：2026-04-01T00:00:00Z
UpdatedAt	Timestamp ISO8601	更新时间。示例值：2026-04-01T00:00:00Z
TPM	Integer	TPM 限制（Tokens Per Minute）。示例值：1000000
ProductType	String	套餐类型。取值：enterprise（企业版专业套餐）、enterprise-auto（企业版轻享套餐）示例值：enterprise

TokenPlanApiKeyListItem

Token Plan API Key 列表项

被如下接口引用：DescribeTokenPlanApiKeyList。

名称	类型	描述
ApiKeyId	String	API Key ID。示例值：ak-tp-20260401-a1b2c3d4
ApiKey	String	API Key 密钥值（脱敏）。示例值：sk-tp-****xxxx
Name	String	API Key 名称。示例值：生产Key
TeamId	String	所属套餐 ID。示例值：team-tp-20260401-a1b2c3d4
AppId	String	账号APP ID。示例值：1300000001
Uin	String	主账号 UIN。最大 128 字符。示例值：100000000001
AllowedModels	String	API Key 可用模型列表（JSON 数组字符串）。示例值：["glm-5"]
Status	String	API Key 是否可用。取值：enable（启用）、disable（停用）。示例值：enable
StopReason	String	API Key 停用原因。取值：NORMAL（正常，默认值），QUOTA_EXHAUSTED（API Key额度包耗尽），ABNORMAL（异常，需人工介入）示例值：NORMAL
UseStatus	String	用户侧开关。取值：enable（启用）、disable（停用）。示例值：enable
KeyVersion	Integer	密钥版本号。示例值：1
LastRotatedAt	Timestamp ISO8601	最近一次重置时间。（ISO 8601）示例值：2026-04-01T00:00:00Z
Creator	String	创建人，如果是子账号创建，则该值为子账号UIN。示例值：100000000002
CreatedAt	Timestamp ISO8601	创建时间。示例值：2026-04-01T00:00:00Z
UpdatedAt	Timestamp ISO8601	更新时间。示例值：2026-04-01T00:00:00Z
Balance	SubPackageBalance	API Key 额度用量信息
ProductType	String	套餐类型。取值：enterprise（企业版专业套餐）、enterprise-auto（企业版轻享套餐）。示例值：enterprise

TokenPlanListItem

Token Plan 套餐列表项

被如下接口引用：DescribeTokenPlanList。

名称	类型	描述
TeamId	String	套餐 ID。示例值：tp-ent-abcdefgh
ProductType	String	套餐类型。取值：enterprise（企业版专业套餐）、enterprise-auto（企业版轻享套餐）示例值：enterprise
Name	String	套餐名称。最大 128 字符。示例值：生产环境套餐
AppId	String	账号 APP ID。示例值：1300000001
Uin	String	主账号 UIN。示例值：100000000001
Status	String	套餐状态。取值：enable（启用）、disable（停用）。示例值：enable
StopReason	String	套餐关停原因。取值：NORMAL（正常）、ISOLATED（隔离/欠费）、FROZEN（冻结）、EXHAUSTED（额度耗尽）、DESTROYED（已销毁）示例值：none
ApiKeyMax	Integer	可创建 API Key 上限。示例值：0
PrepayResourceID	String	云计费预付费资源包 ID。示例值：prepay-123
Creator	String	创建人。若为子账号创建的套餐，则该值为子账号UIN。示例值：100000000002
CreatedAt	Timestamp ISO8601	创建时间。示例值：2026-04-01T00:00:00Z
UpdatedAt	Timestamp ISO8601	更新时间。示例值：2026-04-01T00:00:00Z
PackageInfo	TokenPlanPackageInfo	套餐包基本信息。
AutoRenewFlag	Integer	是否开启自动续费。取值：0（未开启），1（开启）示例值：1

TokenPlanPackageInfo

主额度包信息

被如下接口引用：DescribeTokenPlan, DescribeTokenPlanList。

名称	类型	描述
TotalQuota	String	总额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：1000000
TotalUsed	String	总已使用额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：100000
TotalCycles	Integer	总周期数。示例值：1
CycleUnit	String	周期单位。取值：month（月）示例值：month
StartTime	Timestamp ISO8601	套餐包生效时间。示例值：2026-04-01T00:00:00Z
ExpireTime	Timestamp ISO8601	套餐包到期时间。示例值：2027-04-01T00:00:00Z
ExclusiveAllocated	String	独占池已分配额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：500000
ExclusiveUsed	String	独占池已用额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：100000
SharedPool	String	共享池总额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：500000
SharedUsed	String	共享已用额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：50000
CycleQuota	String	当期额度。根据套餐类型区分单位：credits（企业版专业套餐），tokens（企业版auto套餐）示例值：1000000
CurrentCycle	Integer	当前周期。示例值：1
RemainCycles	Integer	剩余周期。示例值：0

TokenSummary

主包Token总结

被如下接口引用：DescribeTokenPlan。

名称	类型	描述
CycleSeq	Integer	套餐包当前计费周期序号示例值：1
CycleStartTime	String	套餐包计费周期开始时间（RFC3339）示例值：2026-04-01T00:00:00+08:00
CycleEndTime	String	套餐包当前计费周期结束时间（RFC3339）示例值：2026-05-01T00:00:00+08:00
BillingItems	Array of TokenSummaryBillingItem	按计费项分组的 token 汇总列表

TokenSummaryBillingItem

Token 汇总计费项