本教程提供了用于终端应用程序的示例实现代码。您可以将这段代码修改为适用于特定框架(React、Vue、Angular 等)并根据应用需求自定义用户输入方式。
- 使用 OpenAI 的 DALL-E API 生成图像
- 跟踪每次图像生成以进行计费
- 根据使用情况自动向客户收费
- 处理不同的质量层级(标准与高清)
我们要构建的内容
让我们先了解一下我们的 PixelGen AI 服务:- 服务:使用 OpenAI 的 DALL-E API 进行 AI 图像生成
- 定价模型:按图像计费(每张图像 $0.05)
- 免费层:每位客户每月 10 张免费图像
- 质量选项:标准和高清图像(为简单起见,价格相同)
在开始之前,请确保您具备:
- Dodo Payments 帐户
- 访问 OpenAI 的 API
- 对 TypeScript/Node.js 的基本熟悉度
第一步:创建您的使用计量器
我们将首先在您的 Dodo Payments 仪表板中创建一个计量器,以跟踪我们的服务生成的每张图像。可以将其视为跟踪可计费事件的“计数器”。
1
Open the Meters section
- 登录您的 Dodo Payments 控制台
- 在左侧边栏点击 Meters
- 点击 Create Meter 按钮
2
Fill in the basic meter information
现在我们将输入针对 PixelGen AI 服务的具体设置:Meter 名称:精确复制并粘贴此内容 →
Image Generation Meter描述:复制此内容 → Tracks each AI image generation request made by customers using our DALL-E powered service事件名称:这是关键——请精确复制 → image.generated3
Configure how we count images
设置聚合方式(计量器如何计算事件):聚合类型:从下拉菜单中选择 计数计量单位:输入 →
images我们使用“Count”,因为我们按生成的图像数量计费,而不是按大小或生成时间。每成功生成一张图像 = 1 个计费单位。
4
Add quality filtering

- 启用事件过滤:将其切换为 启用
- 过滤逻辑:选择 OR(表示“如果任一条件满足即计数”)
- 添加第一个条件:
- 属性键:
quality - 比较符:
equals - 值:
standard
- 属性键:
- 点击“Add Condition” 添加第二个条件:
- 属性键:
quality - 比较符:
equals - 值:
hd
- 属性键:
5
Create your meter
- 仔细检查所有设置是否与上述值一致
- 点击 Create Meter
计量器已创建! 您的“Image Generation Meter”现在可以开始统计图像生成次数。接下来,我们将把它连接到一个计费产品。
第二步:创建您的计费产品
现在我们需要创建一个定义我们定价的产品(每张图像 $0.05,包含 10 张免费图像)。这将我们的计量器与实际计费连接起来。1
Navigate to Products
- 在 Dodo Payments 控制台中,点击左侧边栏的 Products
- 点击 Create Product
- 选择 Usage-Based 作为产品类型
2
Enter product details
为我们的 PixelGen AI 服务填写以下精确值:产品名称:复制此内容 →
PixelGen AI - Image Generation描述:复制此内容 → AI-powered image generation service with pay-per-use billing产品图像:上传一张清晰、相关的图像。这些信息将出现在客户发票上,请保持清晰且专业。
3
Connect your meter

0,确保客户仅根据使用量计费,无基础费用。现在,链接您刚刚创建的计量器:- 向下滚动到 关联计量器 部分
- 点击 添加计量器
- 从下拉菜单中选择 “图像生成计量器”(您之前创建的那个)
- 确认它出现在您的产品配置中
您的计量器已成功连接到该产品。
4
Set your pricing
以下是我们定义的商业模式:
每单位价格:输入 →

0.05(即每张图像 $0.05)免费额度:输入 → 10(客户每月可免费生成 10 张图像)5
Save your product
- 检查所有设置:
- 名称:PixelGen AI - Image Generation
- 计量器:Image Generation Meter
- 价格:每张图像 $0.05
- 免费层:10 张图像
- 点击 Save Changes
产品已创建! 您的计费现已配置完成。客户将根据其图像生成使用情况自动收取费用。
第三步:进行测试购买
在我们开始接收使用事件之前,我们需要进行一次测试购买。1
Get your payment link
- 在 Dodo Payments 控制台中转到 Products
- 找到您的“PixelGen AI - Image Generation”产品
- 点击产品旁边的 Share 按钮
- 复制显示的支付链接
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=12
Complete a test purchase
- 在新的浏览器标签页中打开支付链接
- 输入测试支付信息并完成购买。
支付成功后,您将获得一个客户 ID,我们将在应用代码中使用该 ID。
3
Find your customer ID
- 返回到您的 Dodo Payments 仪表板
- 在侧边栏中导航到 销售 → 客户
- 找到您刚创建的客户(使用测试邮箱)
- 复制客户 ID - 它将类似于
cus_abc123def456
保存此客户 ID——我们会把它硬编码在示例应用代码中,以确保事件被正确追踪。
第四步:构建示例应用程序
现在我们已经完成了计费设置并创建了测试客户。让我们构建示例 PixelGen AI 应用程序,该应用程序生成图像并自动跟踪计费使用情况。1
Set up your project
创建一个新目录并初始化项目:
2
Install dependencies
安装我们所需的依赖包:
3
Create the main application
创建一个名为
index.ts 的文件,并复制以下完整应用代码:第五步:测试您的示例应用程序
是时候测试我们的示例 PixelGen AI 服务并查看计费的实际效果了!让我们确保一切正常工作。1
Set up your environment
首先,确保您已经完成所有配置:
- 在您的
pixelgen-ai目录中创建一个.env文件 - 添加您实际的 API 密钥:
- 安装依赖项并运行应用程序:
2
Generate your first test image
当应用启动时,您会看到:尝试这个提示:“一只可爱的机器人在画风景”您应该看到如下输出:
如果看到“Usage event sent successfully”,说明您的计费集成已正常工作!
3
Generate a few more images
让我们再生成 2-3 张图像以测试多个事件。尝试以下提示词:
- “紫色云彩下的山脉日落”
- “维多利亚厨房中的蒸汽朋克咖啡机”
- “一只友好的龙在图书馆里看书”
4
Check your Dodo Payments dashboard
现在我们来验证事件是否已接收:
- 打开您的 Dodo Payments 仪表板
- 转到 使用计费 → *计量器 → 图像生成计量器
- 点击 事件 选项卡
- 您应该看到列出的图像生成事件
- 事件名称:
image.generated - 客户 ID:您的测试客户 ID
您应该能看到每张生成的图像对应一个事件!
5
Verify billing calculations
让我们检查一下用量计数是否正常:

- 在您的计量器中,转到 客户 选项卡
- 找到您的测试客户
- 检查 “消耗单位” 列
6
Test the billing threshold
让我们超过免费额度,看看计费效果:
- 生成 8 张更多图像(以达到总共 12 张)
- 再次检查您的计量器仪表板
- 您现在应该看到:
- 消耗单位:12
- 可计费单位:2(12 - 10 免费)
- 计费金额:$0.10
成功! 您的基于使用量的计费运行正常。客户将根据实际图像生成使用量自动收取费用。
故障排除
常见问题及其解决方案:Events not appearing in dashboard
Events not appearing in dashboard
可能原因:
- 事件名称与计量器配置不完全匹配
- 客户 ID 在您的帐户中不存在
- API 密钥无效或已过期
- 网络连接问题
- 确认事件名称与计量器配置完全一致(区分大小写)
- 检查客户 ID 是否存在于 Dodo Payments 中
- 通过简单 API 调用测试 API 密钥
- 检查网络连接和防火墙设置
恭喜!您构建了 PixelGen AI
您已成功创建了一个用于 AI 图像生成的基于使用计费的代码片段!以下是您完成的内容:Usage Meter
创建了“Image Generation Meter”来追踪每次图像生成事件
Billing Product
配置了每张图像 $0.05,且每月前 10 张图像免费
AI Application
构建了一个使用 OpenAI DALL·E 生成图像的可运行 TypeScript 应用
Automated Billing
集成了实时事件追踪,可自动为客户计费