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ả (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 (cuộc gọi API, tải lên)
• Sum: Cộng các giá trị số (tokens, bytes)
• Max: Giá trị lớn nhất trong kỳ (người dùng đỉnh)
• Last: Giá trị gần nhất

​

Over Property

string

Khóa metadata để tổng hợp (bắt buộc cho tất cả loại ngoại trừ Count). Ví dụ: tokens, bytes, duration_ms

​

Measurement Unit

string

bắt buộc

Nhãn đơn vị cho hóa đơn. 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

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

4

Create

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

​

Xem Phân tích

• Tổng quan: Tổng mức sử dụng và biểu đồ mức sử dụng
• Sự kiện: Các sự kiện riêng lẻ đã nhận
• Khách hàng: Mức sử dụng và 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

Đầu tiên, tạo một tín chỉ 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 kỳ sau, vượt hạn).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 tùy chọn Bill usage in Credits trong cấu hình đồng hồ. Điều này sẽ hiển thị các cài đặt tín chỉ:

​

Credit Entitlement

string

bắt buộc

Chọn quyền tín dụng mà đồng hồ này sẽ khấu trừ.

​

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

Set the Free Threshold

Ngưỡng miễn phí vẫn có hiệu lực — các sự kiện nằm dưới ngưỡng này sẽ không khấu trừ tín chỉ.Ví dụ: Với ngưỡng miễn phí là 1.000 và số đơn vị đồng hồ trên mỗi tín chỉ là 1:

• Khách hàng sử dụng 2.500 cuộc gọi API
• 1.000 đầu tiên miễn phí
• 1.500 còn lại khấu trừ 1.500 tín chỉ khỏi số dư của họ

​

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

1. Sự kiện đến - Ứng dụng của bạn gửi sự kiện sử dụng qua Event Ingestion API
2. Đồng hồ tổng hợp - Các sự kiện được tổng hợp theo cấu hình đồng hồ của bạn (Count, Sum, Max, Last)
3. Worker nền xử lý - Mỗi phút, một worker lấy các sự kiện mới kể từ checkpoint trước đó
4. Tín chỉ được khấu trừ - Lượng sử dụng tổng hợp được chuyển đổi sang tín chỉ theo tỷ lệ meter_units_per_credit và khấu trừ theo thứ tự FIFO (quyền cấp cũ nhất bị tiêu thụ trước)
5. Theo dõi vượt hạn - Nếu số dư về 0 và vượt hạn được bật, việc sử dụng vẫn tiếp tục và vượt hạn được xử lý theo hành vi đã cấu hình (xóa khi đặt lại, tính phí ở hóa đơn tiếp theo hoặc chuyển làm thâm hụt)

​

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

• text.generation - 1 tín chỉ cho mỗi 1.000 token
• image.generation - 10 tín chỉ cho mỗi hình ảnh

​

Khắc phục sự cố

​

Bước tiếp theo