Skip to main content
Ingestion blueprints 是用于在常见场景中跟踪用量的预构建模式。无需从头设计事件结构和计量器配置，只需从经过验证的蓝图开始，再根据需求进行自定义。

​
什么是蓝图？

每个蓝图包括：
  • 事件结构建议：最佳事件命名和元数据设计
  • 计量配置：建议的聚合类型和过滤器
  • 示例代码：多种语言的工作实现示例
  • 最佳实践：关于准确性、性能和成本优化的提示
蓝图可节省数小时的设置时间，帮助您避免常见陷阱。先从蓝图开始，然后根据您的具体需求进行调整。

​
为什么使用蓝图？

Faster Setup

让使用情况跟踪在几分钟内生效，而不是几小时。复制经验证的模式，而不是从零开始设计。

Best Practices Built In

通过经过测试的事件结构、适当的元数据和最佳聚合选择来避免常见错误。

Production Ready

示例代码基于真实世界的实现。添加您的 API keys，即可开始使用。

​
可用蓝图

选择与您的用例匹配的蓝图：

LLM Blueprint

跟踪 OpenAI、Anthropic、Groq、Gemini、Vercel AI SDK 等的 AI 令牌使用情况。适合：AI 聊天机器人、代码生成器、内容创作工具、AI 驱动的应用程序。您将跟踪的内容：输入令牌、输出令牌、模型使用情况、请求次数。

API Gateway Blueprint

在网关级别对 API 请求进行计量，并支持端点过滤和速率限制。适合：REST API、GraphQL 服务、Webhook 提供商、API 优先平台。您将跟踪的内容：请求次数、端点使用情况、HTTP 方法、响应时间。

Object Storage Blueprint

跟踪云存储服务的文件上传、存储消耗和带宽情况。适合：文件托管、媒体平台、备份服务、文档管理。您将跟踪的内容：存储的字节数、文件上传、下载、存储快照。

Stream Blueprint

衡量视频、音频和实时数据交付的流媒体带宽。适合：视频流、音频平台、直播、实时数据馈送。您将跟踪的内容：使用的带宽、流持续时间、质量级别、并发流数量。

Time Range Blueprint

按计算资源、无服务器函数和长时间运行作业的经过时间计费。适合：无服务器平台、容器托管、计算实例、批处理。您将跟踪的内容：执行时间、计算小时数、函数调用次数、作业持续时间。

​
如何使用蓝图

1

Choose your blueprint

选择最适合您计费场景的蓝图。每个蓝图页面都包含详细的实现指南。
2

Review the event structure

了解推荐的事件命名和元数据设计。根据您的用例复制事件结构。
3

Create the meter

按照蓝图的计量配置说明操作。使用建议的聚合类型和过滤器。
4

Implement event sending

复制适用于您的语言或框架的示例代码。将占位值替换为实际的 API keys 和 customer IDs。
5

Test and verify

发送测试事件，确认它们以正确的聚合方式出现在您的计量仪表板中。
6

Customize as needed

根据您的具体要求调整蓝图：添加自定义 metadata、调整 filters 或修改定价。

​
蓝图比较

不确定哪个蓝图适合您的需求？以下是快速比较：

​
自定义实现

没有看到适合您确切用例的蓝图？没问题：
  1. 从最接近的蓝图开始：选择与您的需求最相似的蓝图。
  2. 调整事件结构：修改 metadata 字段以匹配您的要求。
  3. 调整计量器配置：根据需要更改聚合类型或 filters。
  4. 全面测试：使用示例用量验证计费计算。
所有蓝图都是起点。欢迎随意混合不同蓝图的概念或创建完全自定义的实现。

​
需要帮助吗？

如果您不确定使用哪个蓝图或需要帮助进行自定义：

Complete Tutorial

按照我们的端到端教程构建一个带有使用计费的 AI 图像生成器。

Integration Guide

全面指南，涵盖基于使用的计费实施的所有方面。
最后修改于 2026年9月26日