Skip to main content
Để Sentra viết mã tích hợp cho bạn.
Sử dụng trợ lý AI của chúng tôi trong VS Code, Cursor hoặc Windsurf để tạo mã SDK/API, mã tích hợp LLM Blueprint, webhooks và nhiều nội dung khác — chỉ bằng cách mô tả điều bạn muốn.
Dùng thử Sentra: Tích hợp được hỗ trợ bởi AI →
Trong hướng dẫn này, bạn sẽ xây dựng một ứng dụng trò chuyện AI với tính năng tính phí tự động dựa trên mức sử dụng. Chúng ta sẽ tạo mọi thứ từ đầu: bộ đo tính phí, cấu hình sản phẩm và mã ứng dụng xử lý các cuộc trò chuyện cũng như theo dõi mức sử dụng token theo thời gian thực.
Hướng dẫn này cung cấp một ứng dụng hoàn chỉnh có thể hoạt động ngay, bao gồm cả backend và frontend. Ứng dụng trò chuyện sử dụng Gemini AI của Google và tự động theo dõi mức sử dụng token mà không cần tự đếm thủ công.
Khi hoàn thành hướng dẫn này, bạn sẽ có một ứng dụng trò chuyện hoạt động với các khả năng:
  • Vận hành các cuộc trò chuyện AI bằng Google Gemini (AI SDK)
  • Tự động theo dõi mức sử dụng token (không cần mã thủ công)
  • Tính phí khách hàng dựa trên lượng token thực tế đã sử dụng
  • Bao gồm giao diện trò chuyện đẹp mắt
Bản demo trò chuyện AI

Chúng ta sẽ xây dựng gì

Hãy bắt đầu bằng việc tìm hiểu dịch vụ trò chuyện AI của chúng ta:
  • Dịch vụ: Trò chuyện được hỗ trợ bởi AI sử dụng Google Gemini (AI SDK)
  • Mô hình tính phí: Tính phí theo token ($0.01 cho mỗi 1.000 token)
  • Gói miễn phí: 10.000 token miễn phí cho mỗi khách hàng mỗi tháng
  • Tính năng: Lịch sử trò chuyện, tự động theo dõi token
Trước khi bắt đầu, hãy đảm bảo bạn có:

Bước 1: Tạo Usage Meter

Trước tiên, chúng ta sẽ tạo một meter trong dashboard Dodo Payments để theo dõi mức sử dụng token AI.
Chúng ta sẽ xây dựng: Một meter có tên “AI Token Usage Meter” để cộng tổng tất cả token được sử dụng trong các cuộc trò chuyện.
1

Open the Meters section

  1. Đăng nhập vào dashboard Dodo Payments
  2. Nhấp vào Products trong thanh bên trái
  3. Nhấp vào Meters
  4. Nhấp vào nút Create Meter
Tạo meter
Bạn sẽ thấy một biểu mẫu để cấu hình tính năng theo dõi token.
2

Fill in the basic meter information

Bây giờ, chúng ta sẽ nhập các thông tin cụ thể cho dịch vụ trò chuyện AI:Tên meterAI Token Usage MeterMô tảTracks token consumption from AI chat conversations using AI SDKTên eventai_chat_usage
Tên event ai_chat_usage phải khớp chính xác với giá trị chúng ta sẽ gửi từ mã ứng dụng sau này. Tên event phân biệt chữ hoa chữ thường!
3

Configure how we count tokens

Thiết lập phép tổng hợp (cách meter đếm các event của chúng ta):Loại tổng hợp: Chọn Sum từ menu thả xuốngTổng hợp trên: Nhập Type → totalTokensĐơn vị đo lường: Nhập Type → tokens
Chúng ta sử dụng “Sum” vì muốn cộng tất cả token đã sử dụng trong nhiều tin nhắn trò chuyện. SDK sẽ tự động gửi totalTokens trong mỗi event.
4

Create your meter

  1. Kiểm tra lại để đảm bảo tất cả cài đặt khớp với các giá trị ở trên
  2. Nhấp vào Create Meter
Cấu hình meter
Đã tạo meter! “AI Token Usage Meter” hiện đã sẵn sàng bắt đầu đếm token. Tiếp theo, chúng ta sẽ kết nối meter với một sản phẩm tính phí.

Bước 2: Lấy API Keys

Trước khi xây dựng ứng dụng, hãy thu thập các API key cần thiết.
1

Get Dodo Payments API Key

  1. Trong dashboard Dodo Payments, đi đến DevelopersAPI Keys
  2. Nhấp vào Create API Key
  3. Sao chép API key — key sẽ có dạng test_abc123...
Lưu API key này — sau đó chúng ta sẽ thêm nó vào tệp .env.
2

Get Google AI API Key

  1. Truy cập aistudio.google.com
  2. Nhấp vào Get API Key
  3. Tạo API key mới hoặc sử dụng key hiện có
  4. Sao chép key
Giữ key này an toàn — chúng ta cũng sẽ thêm nó vào tệp .env.

Bước 3: Tạo Billing Product

Bây giờ, chúng ta cần tạo một sản phẩm xác định mức giá ($0.01 cho mỗi 1.000 token với 10.000 token miễn phí). Sản phẩm này kết nối meter với hoạt động tính phí thực tế.
Chúng ta sẽ xây dựng: Một sản phẩm có tên “AI Chat Service”, tính phí dựa trên mức sử dụng token với gói miễn phí hào phóng.
1

Navigate to Products

  1. Trong dashboard Dodo Payments, nhấp vào Products trong thanh bên trái
  2. Nhấp vào Create Product
  3. Chọn Usage-Based làm loại sản phẩm
Điều này cho Dodo Payments biết rằng hoạt động tính phí sẽ dựa trên mức sử dụng meter, không phải gói đăng ký cố định.
2

Enter product details

Điền các thông tin bắt buộc:Tên sản phẩm: → AI Chat ServiceMô tả: → AI-powered chat service with automatic token-based billingẢnh sản phẩm: Tải lên một hình ảnh phù hợp
Các thông tin này sẽ xuất hiện trên hóa đơn khách hàng, vì vậy hãy trình bày rõ ràng và chuyên nghiệp.
3

Connect your meter

Trước khi kết nối meter, hãy đảm bảo bạn đã chọn Usage Based Billing làm loại giá cho sản phẩm.Ngoài ra, đặt Fixed Price thành 0 để đảm bảo khách hàng chỉ bị tính phí dựa trên mức sử dụng, không có phí cơ bản.Bây giờ, hãy liên kết meter vừa tạo:
  1. Cuộn xuống phần Associated Meter
  2. Nhấp vào Add Meters
  3. Từ menu thả xuống, chọn “AI Token Usage Meter” (meter bạn đã tạo trước đó)
  4. Xác nhận meter xuất hiện trong cấu hình sản phẩm
Meter của bạn hiện đã được kết nối thành công với sản phẩm này.
4

Set your pricing

Đây là nơi chúng ta xác định mô hình kinh doanh:Giá mỗi đơn vị: Nhập → 0.00001 (tương đương 0.01chomo^~i1.000tokenhoc0.01 cho mỗi 1.000 token hoặc 0.00001 cho mỗi token)Ngưỡng miễn phí: Nhập → 10000 (khách hàng được miễn phí 10.000 token mỗi tháng)
Giá sản phẩm
Cách tính phí: Nếu khách hàng sử dụng 25.000 token trong một tháng, họ sẽ bị tính phí cho 15.000 token (25.000 - 10.000 token miễn phí) = 15.000 × 0.00001=0.00001 = 0.15
5

Save your product

  1. Xem lại tất cả cài đặt:
    • Tên: AI Chat Service
    • Meter: AI Token Usage Meter
    • Giá: $0.01 cho mỗi 1.000 token
    • Gói miễn phí: 10.000 token
  2. Nhấp vào Save Changes
Đã tạo sản phẩm! Hoạt động tính phí hiện đã được cấu hình. Khách hàng sẽ tự động bị tính phí dựa trên mức sử dụng token.

Bước 4: Thực hiện giao dịch mua thử nghiệm

Trước khi bắt đầu xây dựng ứng dụng, hãy tạo một khách hàng thử nghiệm bằng cách thực hiện giao dịch mua.
1

Get your payment link

  1. Trong dashboard Dodo Payments, đi đến Products
  2. Tìm sản phẩm “AI Chat Service”
  3. Nhấp vào nút Share bên cạnh sản phẩm
  4. Sao chép payment link xuất hiện
2

Complete a test purchase

  1. Mở payment link trong tab trình duyệt mới
  2. Nhập thông tin thanh toán thử nghiệm và hoàn tất giao dịch mua
Sau khi thanh toán thành công, bạn sẽ có customer ID để sử dụng trong mã ứng dụng.
3

Find your customer ID

  1. Quay lại dashboard Dodo Payments
  2. Đi đến Sales -> Customers trong thanh bên trái
  3. Tìm khách hàng vừa tạo (với email thử nghiệm)
  4. Sao chép customer ID — ID sẽ có dạng cus_123
Lưu customer ID này — chúng ta sẽ sử dụng ID khi kiểm thử ứng dụng trò chuyện.

Bước 5: Xây dựng ứng dụng trò chuyện

Bây giờ, chúng ta đã hoàn tất thiết lập tính phí và tạo một khách hàng thử nghiệm. Hãy xây dựng ứng dụng trò chuyện AI với tính năng tự động theo dõi token.
1

Set up your project

Tạo một thư mục mới và khởi tạo project:
2

Install dependencies

Cài đặt các package cần thiết:
3

Configure TypeScript

Tạo tsconfig.json:
tsconfig.json
Cập nhật package.json để thêm module type và các script:
package.json
4

Create project structure

Tạo các thư mục và tệp:
5

Set up environment variables

Tạo tệp .env trong thư mục gốc của project:
.env
Thay các giá trị giữ chỗ bằng API key thực tế của bạn từ Bước 2.
6

Create the backend server

Tạo src/server.ts và sao chép toàn bộ mã server này:
Đây là server trò chuyện AI hoàn chỉnh với tính năng tính phí tích hợp:

Bước 6: Thêm giao diện trò chuyện

Bây giờ, hãy thêm một giao diện trò chuyện đẹp mắt với đầy đủ lịch sử hội thoại! Tạo public/index.html:
public/index.html

Bước 7: Kiểm thử ứng dụng trò chuyện

Đã đến lúc kiểm thử ứng dụng trò chuyện AI và xem hoạt động tính phí! Hãy đảm bảo mọi thứ hoạt động xuyên suốt từ đầu đến cuối.
Nội dung kiểm thử: Chúng ta sẽ trò chuyện với AI, xác minh các event token đến được Dodo Payments và xác nhận các phép tính tính phí là chính xác.
1

Start the server

Trước tiên, hãy đảm bảo mọi thứ đã được thiết lập:
  1. Xác minh tệp .env có đầy đủ API key từ Bước 2
  2. Khởi động development server:
Bạn sẽ thấy:
Server đang chạy! Đã đến lúc trò chuyện.
2

Open the chat interface

  1. Mở trình duyệt
  2. Truy cập http://localhost:3000
  3. Bạn sẽ thấy giao diện trò chuyện đẹp mắt
Hãy cập nhật CUSTOMER_ID trong server.ts bằng customer ID thử nghiệm thực tế từ Bước 4.
3

Have your first conversation

Hãy thử nghiệm! Gửi các tin nhắn sau:
  1. “Trí tuệ nhân tạo là gì?”
  2. “Machine learning hoạt động như thế nào?”
  3. “Bạn có thể giải thích neural network không?”
Theo dõi phần hiển thị mức sử dụng token cập nhật sau mỗi câu trả lời!
Nếu thấy AI trả lời và số lượng token xuất hiện, ứng dụng của bạn đang hoạt động!
4

Check your Dodo Payments dashboard

Bây giờ, hãy xác minh các event đã được nhận:
  1. Mở dashboard Dodo Payments
  2. Đi đến Usage BillingAI Token Usage Meter
  3. Nhấp vào tab Events
  4. Bạn sẽ thấy các event trò chuyện được liệt kê
Điều cần kiểm tra:
  • Tên event: ai_chat_usage
  • Customer ID: ID của khách hàng thử nghiệm
Các event của meter
Bạn sẽ thấy một event cho mỗi tin nhắn đã gửi!
5

Verify token counting

Hãy gửi thêm một số tin nhắn và kiểm tra xem phép tổng hợp token có hoạt động hay không:
  1. Trong meter, đi đến tab Customers
  2. Tìm khách hàng thử nghiệm
  3. Kiểm tra cột “Consumed Units” — cột này sẽ hiển thị tổng số token đã sử dụng
Token của khách hàng trong meter
Meter đang tự động cộng tất cả giá trị totalTokens!
6

Test the free tier

Hãy sử dụng đủ token để vượt qua gói miễn phí:
  1. Thực hiện thêm một số cuộc trò chuyện (mục tiêu tổng cộng khoảng 15.000+ token)
  2. Kiểm tra lại tab Customers trong dashboard của meter
  3. Bây giờ, bạn sẽ thấy:
    • Consumed Units: 15.000+ token
    • Chargeable Units: 5.000 (đã áp dụng 10.000 token miễn phí)
    • Total Price: khoảng $0.05
Kiểm thử gói miễn phí
Thành công! Tính phí dựa trên mức sử dụng đang hoạt động hoàn hảo. Khách hàng sẽ tự động bị tính phí dựa trên lượng token thực tế đã sử dụng.

Khắc phục sự cố

Các vấn đề thường gặp và cách giải quyết:
Nguyên nhân có thể:
  • Tên event không khớp chính xác với cấu hình meter
  • Customer ID không tồn tại trong tài khoản
  • API key không hợp lệ hoặc đã hết hạn
  • Sự cố kết nối mạng
Giải pháp:
  1. Xác minh tên event khớp chính xác với cấu hình meter (phân biệt chữ hoa chữ thường: ai_chat_usage)
  2. Kiểm tra customer ID tồn tại trong dashboard Dodo Payments
  3. Kiểm thử API key bằng một API call đơn giản
  4. Kiểm tra server logs để tìm thông báo lỗi
Nguyên nhân có thể:
  • Model không trả về thông tin mức sử dụng
  • Phiên bản SDK không chính xác
Giải pháp:
  1. Kiểm tra model có trả về usage hay không:
  1. Cập nhật lên Blueprints SDK mới nhất: npm install @dodopayments/ingestion-blueprints@latest
Nguyên nhân có thể:
  • API key không đúng với môi trường
  • Có khoảng trắng hoặc dấu ngoặc kép thừa trong tệp .env
Giải pháp:
  • Đảm bảo key thử nghiệm bắt đầu bằng test_, key live bắt đầu bằng live_
  • Xóa mọi dấu ngoặc kép xung quanh key trong tệp .env
  • Tạo key mới nếu cần
Cần trợ giúp?

Chúc mừng! Bạn đã xây dựng ứng dụng trò chuyện AI

Giờ đây, bạn đã có một ứng dụng trò chuyện AI đầy đủ chức năng với tính năng tự động theo dõi mức sử dụng token và tính phí được hỗ trợ bởi Dodo Payments. 🎉

Tìm hiểu thêm

LLM Blueprint

Tìm hiểu thêm về LLM Ingestion Blueprint

Ingestion Blueprints SDK

Xem repository GitHub để biết thêm ví dụ

Join Community

Nhận trợ giúp và chia sẻ project của bạn trên Discord
Lần sửa đổi cuối 31 tháng 7, 2026