> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 数据摄取蓝图
> 适用于常见用例的现成事件摄取模式及示例代码。
数据摄取蓝图是用于跟踪常见场景中使用情况的预构建模式。与其从头开始确定事件结构和计量配置，不如从经过验证的蓝图开始，并根据您的需求进行自定义。
## 什么是蓝图？
每个蓝图包括：
* **事件结构建议**：最佳事件命名和元数据设计
* **计量配置**：建议的聚合类型和过滤器
* **示例代码**：多种语言的工作实现示例
* **最佳实践**：关于准确性、性能和成本优化的提示
蓝图可节省数小时的设置时间，帮助您避免常见陷阱。先从蓝图开始，然后根据您的具体需求进行调整。
## 为什么使用蓝图？
让使用情况跟踪在几分钟内生效，而不是几小时。复制经验证的模式，而不是从零开始设计。
通过经过测试的事件结构、适当的元数据和最佳聚合选择来避免常见错误。
示例代码基于真实世界的实现。只需添加您的 API 密钥即可使用。
## 可用蓝图
选择与您的用例匹配的蓝图：
跟踪 OpenAI、Anthropic、Groq、Gemini、Vercel AI SDK 等的 AI 令牌使用情况。
**适合**：AI 聊天机器人、代码生成器、内容创作工具、AI 驱动的应用程序。
**您将跟踪的内容**：输入令牌、输出令牌、模型使用情况、请求次数。
在网关级别对 API 请求进行计量，并支持端点过滤和速率限制。
**适合**：REST API、GraphQL 服务、Webhook 提供商、API 优先平台。
**您将跟踪的内容**：请求次数、端点使用情况、HTTP 方法、响应时间。
跟踪云存储服务的文件上传、存储消耗和带宽情况。
**适合**：文件托管、媒体平台、备份服务、文档管理。
**您将跟踪的内容**：存储的字节数、文件上传、下载、存储快照。
衡量视频、音频和实时数据交付的流媒体带宽。
**适合**：视频流、音频平台、直播、实时数据馈送。
**您将跟踪的内容**：使用的带宽、流持续时间、质量级别、并发流数量。
按计算资源、无服务器函数和长时间运行作业的经过时间计费。
**适合**：无服务器平台、容器托管、计算实例、批处理。
**您将跟踪的内容**：执行时间、计算小时数、函数调用次数、作业持续时间。
## 如何使用蓝图
选择最适合您计费场景的蓝图。每个蓝图页面都包含详细的实现指南。
了解推荐的事件命名和元数据设计。根据您的用例复制事件结构。
按照蓝图的计量配置说明操作。使用建议的聚合类型和过滤器。
复制适用于您语言/框架的示例代码。将占位符值替换为您真实的 API 密钥和客户 ID。
发送测试事件，确认它们以正确的聚合方式出现在您的计量仪表板中。
根据您的具体需求调整蓝图——添加自定义元数据、调整过滤器或修改定价。
## 蓝图比较
不确定哪个蓝图适合您的需求？以下是快速比较：
| 用例 | 蓝图 | 聚合 | 常见元数据 |
| -------- | ------ | -------- | ------------------------------------ |
| 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 |
## 自定义实现
没有看到适合您确切用例的蓝图？没问题：
1. **从最接近的蓝图开始**：选择与您的需求最相似的蓝图
2. **调整事件结构**：修改元数据字段以匹配您的要求
3. **调整计量配置**：根据需要更改聚合类型或过滤器
4. **彻底测试**：使用示例使用情况验证计费计算
所有蓝图都是起点。欢迎随意混合不同蓝图的概念或创建完全自定义的实现。
## 需要帮助吗？
如果您不确定使用哪个蓝图或需要帮助进行自定义：
按照我们的端到端教程构建一个带有使用计费的 AI 图像生成器。
全面指南，涵盖基于使用的计费实施的所有方面。