什么是蓝图？
每个蓝图包括：- 事件结构建议：最佳事件命名和元数据设计
- 计量配置：建议的聚合类型和过滤器
- 示例代码：多种语言的工作实现示例
- 最佳实践：关于准确性、性能和成本优化的提示
为什么使用蓝图？
更快的设置
在几分钟内完成使用情况跟踪，而不是几个小时。复制经过验证的模式，而不是从头设计。
内置最佳实践
通过经过测试的事件结构、适当的元数据和最佳聚合选择来避免常见错误。
生产就绪
示例代码基于真实世界的实现。只需添加您的 API 密钥即可开始使用。
可用蓝图
选择与您的用例匹配的蓝图：LLM 蓝图
跟踪 OpenAI、Anthropic、Groq、Gemini、Vercel AI SDK 等的 AI 令牌使用情况。适合：AI 聊天机器人、代码生成器、内容创作工具、AI 驱动的应用程序。您将跟踪：输入令牌、输出令牌、模型使用情况、请求计数。
API 网关蓝图
在网关级别计量 API 请求，支持端点过滤和速率限制。适合：REST API、GraphQL 服务、Webhook 提供商、API 优先平台。您将跟踪：请求计数、端点使用情况、HTTP 方法、响应时间。
对象存储蓝图
跟踪文件上传、存储消耗和云存储服务的带宽。适合：文件托管、媒体平台、备份服务、文档管理。您将跟踪：存储的字节、文件上传、下载、存储快照。
流蓝图
测量视频、音频和实时数据传输的流带宽。适合：视频流、音频平台、直播、实时数据馈送。您将跟踪：消耗的带宽、流持续时间、质量级别、并发流。
时间范围蓝图
按计算资源、无服务器函数和长时间运行的作业的经过时间计费。适合：无服务器平台、容器托管、计算实例、批处理。您将跟踪：执行时间、计算小时、函数调用、作业持续时间。
如何使用蓝图
1
选择您的蓝图
选择最符合您计费场景的蓝图。每个蓝图页面都包含详细的实施指南。
2
审查事件结构
了解推荐的事件命名和元数据设计。复制适合您用例的事件结构。
3
创建计量器
按照蓝图的计量配置说明进行操作。使用建议的聚合类型和过滤器。
4
实现事件发送
复制适合您语言/框架的示例代码。用您的实际 API 密钥和客户 ID 替换占位符值。
5
测试和验证
发送测试事件并验证它们是否在您的计量仪表板中正确聚合。
6
根据需要自定义
根据您的具体要求调整蓝图——添加自定义元数据、调整过滤器或修改定价。
蓝图比较
不确定哪个蓝图适合您的需求？以下是快速比较：| 用例 | 蓝图 | 聚合 | 常见元数据 |
|---|---|---|---|
| AI 聊天应用 | LLM | 总和（令牌） | model, input_tokens, output_tokens |
| REST API | API 网关 | 计数 | endpoint, method, status_code |
| 文件存储 | 对象存储 | 总和（字节） | file_size, file_type, operation |
| 视频平台 | 流 | 总和（带宽） | duration, quality, bitrate |
| 无服务器 | 时间范围 | 总和（持续时间） | function_name, execution_time_ms |
自定义实现
没有看到适合您确切用例的蓝图？没问题：- 从最接近的蓝图开始：选择与您的需求最相似的蓝图
- 调整事件结构：修改元数据字段以匹配您的要求
- 调整计量配置：根据需要更改聚合类型或过滤器
- 彻底测试：使用示例使用情况验证计费计算
所有蓝图都是起点。随意混合不同蓝图的概念或创建完全自定义的实现。