火山引擎赠送的token如何查询？

Question

如何查询火山引擎赠送的Token余额及使用情况？在控制台哪个页面查看？API是否支持查询？赠送Token与付费资源的优先级如何区分？部分用户反馈无法准确识别赠送额度剩余量，是否存在延迟或统计口径差异？请结合账单中心、费用明细及资源包管理等模块说明具体查询路径和常见误区。

Answer 1

如何查询火山引擎赠送的Token余额及使用情况

1. 初步认知：什么是火山引擎赠送Token？

火山引擎为新注册用户或参与特定活动的用户提供一定额度的免费资源，通常以“赠送Token”形式体现。这些Token可用于调用AI模型服务（如语音识别、图像处理、大模型推理等），其本质是平台提供的信用额度。

赠送Token与付费资源并行存在，但使用优先级和结算逻辑不同，需通过控制台或API进行精细化管理。

2. 控制台查询路径详解

用户可通过以下层级路径在火山引擎控制台查看赠送Token的余额与使用情况：

1. 登录火山引擎控制台
2. 进入【费用中心】→【资源包管理】
3. 选择对应产品线（如“机器学习平台”、“语音技术”等）
4. 查看资源包列表中标识为“赠送”的条目，包含总额、已用、剩余量及有效期

模块	功能说明	是否支持赠送Token展示
资源包管理	集中管理各类预购/赠送资源	✅ 支持
账单中心	按月汇总消费明细	⚠️ 间接反映（需结合标签）
费用明细	逐条记录资源消耗流水	✅ 支持（带“优惠抵扣”字段）
用量统计	按产品维度展示调用量	✅ 支持（可筛选计费类型）

3. API 查询能力支持情况

火山引擎开放了费用相关OpenAPI，允许程序化获取资源使用状态：

GET /api/v1/bill/resourcePackage/query
Headers:
  X-Volc-AccessKey: your_access_key
  X-Volc-SecurityToken: your_security_token

Response 示例：
{
  "ResourcePackages": [
    {
      "Type": "Free",
      "Name": "LLM Inference Token",
      "TotalAmount": 1000000,
      "UsedAmount": 328756,
      "RemainingAmount": 671244,
      "EffectiveTime": "2024-01-01T00:00:00Z",
      "ExpiredTime": "2024-12-31T23:59:59Z"
    }
  ]
}

开发者可集成该接口至内部监控系统，实现自动化预警与额度追踪。

4. 赠送Token与付费资源的使用优先级机制

根据火山引擎资源调度策略，资源消耗遵循如下优先顺序：

1. 优先使用有效期临近的赠送Token（防浪费原则）
2. 其次消耗其他未过期赠送额度
3. 最后从付费账户或资源包中扣除

此逻辑确保用户最大化利用免费资源，降低实际支出成本。

5. 数据延迟与统计口径差异分析

部分用户反馈赠送额度显示不准，常见原因包括：

• 数据采集延迟：实时调用与账单系统同步存在5~15分钟延迟
• 多区域聚合问题：跨Region调用可能未及时归集到主账单视图
• 缓存机制影响：前端页面默认缓存30分钟数据，建议手动刷新
• 统计粒度不一致：API返回秒级数据，而控制台按小时聚合

graph TD
    A[用户发起API调用] --> B{是否存在有效赠送Token?}
    B -->|是| C[优先抵扣赠送额度]
    B -->|否| D[从付费资源包或账户余额扣除]
    C --> E[生成费用明细记录]
    D --> E
    E --> F[异步写入账单数据库]
    F --> G[次日生成正式账单]
    G --> H[控制台可视化展示]

6. 常见误区与最佳实践

实践中常见的误解与应对策略如下：

误区	真相	解决方案
认为赠送额度会自动延续	所有赠送均有明确有效期	设置到期前提醒任务
误将总调用量当作已扣费量	需区分“免费抵扣”与“现金支付”	在费用明细中过滤“优惠类型”
仅依赖首页仪表盘判断余额	首页数据可能滞后	定期访问资源包管理页+调用API核对
忽略子账号资源隔离	主账号无法直接查看全部子账号使用情况	启用统一账单并配置权限策略