Công tơ

Tài nguyên API

Tạo một Công tơ

1

Basic Information

Meter Name

string

bắt buộc

Tên mô tả cho meter (ví dụ: “API Requests”, “Token Usage”).

Event Name

string

bắt buộc

Tên sự kiện chính xác cần khớp (phân biệt chữ hoa chữ thường). Ví dụ: api.call, image.generated.

2

Aggregation

Aggregation Type

string

bắt buộc

Chọn cách các sự kiện được tổng hợp:

• Count: Tổng số sự kiện (lệnh gọi API, lượt tải lên)
• Sum: Tổng các giá trị số (token, byte)
• Max: Giá trị cao nhất trong kỳ (số người dùng cao nhất)
• Last: Giá trị gần đây nhất

Over Property

string

Khóa metadata cần tổng hợp (bắt buộc đối với Sum, Max và Last). Ví dụ: tokens, bytes, duration_ms.

Measurement Unit

string

bắt buộc

Nhãn đơn vị dùng cho hóa đơn và báo cáo. Ví dụ: calls, tokens, GB, hours.

3

Filtering (Optional)

Thêm điều kiện để lọc các sự kiện được tính:

• Logic AND: Tất cả các điều kiện phải khớp
• Logic OR: Bất kỳ điều kiện nào cũng có thể khớp

Các toán tử so sánh hiện có: bằng, khác, lớn hơn, lớn hơn hoặc bằng, nhỏ hơn, nhỏ hơn hoặc bằng, chứa, không chứa.Bật tính năng lọc, chọn logic, sau đó thêm điều kiện với khóa thuộc tính, toán tử so sánh và giá trị.

4

Create

Xem lại cấu hình và nhấp vào Create Meter.

Xem Phân tích

• Overview: Tổng mức sử dụng và xu hướng sử dụng theo thời gian
• Events: Các sự kiện riêng lẻ đã nhận và metadata của chúng
• Customers: Tổng mức sử dụng và các khoản phí theo từng khách hàng

Thanh toán bằng tín chỉ thay vì tiền tệ

Khi nào nên dùng khấu trừ theo tín chỉ

Cấu hình đồng hồ để khấu trừ tín chỉ

1

Create a Credit Entitlement

Trước tiên, hãy tạo credit entitlement trong Products → Credits. Xác định đơn vị (ví dụ: “API Calls”, “Tokens”), độ chính xác và các cài đặt vòng đời (hết hạn, chuyển tiếp, overage).Xem Hướng dẫn Thanh toán theo tín chỉ để biết hướng dẫn chi tiết.

2

Create or Edit a Usage-Based Product

Vào sản phẩm tính phí theo mức sử dụng và mở phần cấu hình Meter.

3

Add a Meter

Nhấp nút + để đính kèm một đồng hồ. Cấu hình tên sự kiện, kiểu tổng hợp và đơn vị đo như thường lệ.

4

Enable 'Bill Usage in Credits'

Bật Bill usage in Credits trong cấu hình meter để hiển thị các cài đặt credit:

Credit Entitlement

string

bắt buộc

Chọn credit entitlement mà meter này sẽ trừ vào.

Meter units per credit

number

bắt buộc

Số đơn vị sử dụng cần thiết để khấu trừ 1 tín chỉ. Ví dụ:

• 1 = mỗi sự kiện đồng hồ khấu trừ 1 tín chỉ
• 100 = 100 sự kiện đồng hồ khấu trừ 1 tín chỉ
• 1000 = 1.000 cuộc gọi API tiêu thụ 1 tín chỉ

5

Free Threshold and Credits

Free Threshold áp dụng cho các meter được tính phí bằng tiền, không áp dụng cho các meter được tính phí bằng credit. Khi meter tính phí bằng credit, mọi đơn vị đều được tính vào khoản khấu trừ credit.Ví dụ: Với meter-units-per-credit là 1, khách hàng thực hiện 2,500 lệnh gọi API sẽ bị khấu trừ 2,500 credit.

Cách khấu trừ tín chỉ hoạt động

1. Sự kiện được gửi đến — Ứng dụng của bạn gửi các sự kiện sử dụng thông qua Event Ingestion API.
2. Meter tổng hợp — Các sự kiện được tổng hợp theo cấu hình meter của bạn (Count, Sum, Max, Last).
3. Background worker xử lý — Mỗi phút, một worker lấy các sự kiện mới kể từ checkpoint gần nhất.
4. Credit được khấu trừ — Mức sử dụng đã tổng hợp được chuyển đổi thành credit bằng rate meter_units_per_credit và được khấu trừ theo thứ tự FIFO (các khoản cấp credit hết hạn sớm nhất được sử dụng trước).
5. Overage được theo dõi — Nếu số dư chạm mức 0, mức sử dụng tiếp theo sẽ được ghi nhận là overage và được xử lý theo hành vi đã cấu hình (được miễn khi reset, tính phí ở hóa đơn tiếp theo hoặc chuyển tiếp dưới dạng thâm hụt). Dodo Payments không chặn mức sử dụng khi số dư cạn kiệt. Để dừng quyền truy cập khi số dư bằng 0, hãy kiểm tra số dư trong ứng dụng của bạn.

Nhiều đồng hồ, một pool tín chỉ

• text.generation — 1 credit cho mỗi 1.000 token
• image.generation — 10 credit cho mỗi hình ảnh

Khắc phục sự cố

Bước tiếp theo