Khởi động nhanh
Bắt đầu trong 2 phút với việc theo dõi token tự động.
Tài liệu tham khảo API - Nhập sự kiện
Tài liệu API đầy đủ cho việc nhập sự kiện sử dụng.
Tài liệu tham khảo API - Đồng hồ
Tìm hiểu cách tạo và cấu hình đồng hồ cho việc thanh toán.
Hướng dẫn thanh toán dựa trên mức sử dụng
Hướng dẫn toàn diện về thanh toán dựa trên mức sử dụng với đồng hồ.
Hoàn hảo cho các ứng dụng SaaS, chatbot AI, công cụ tạo nội dung và bất kỳ ứng dụng nào sử dụng LLM cần thanh toán dựa trên mức sử dụng.
Khởi động nhanh
Bắt đầu với việc theo dõi token LLM tự động chỉ trong 2 phút:1
Cài đặt SDK
Cài đặt Dodo Payments Ingestion Blueprints:
2
Lấy khóa API của bạn
Bạn sẽ cần hai khóa API:
- Khóa API Dodo Payments: Lấy từ Bảng điều khiển Dodo Payments
- Khóa API Nhà cung cấp LLM: Từ AI SDK, OpenAI, Anthropic, Groq, v.v.
3
Tạo một đồng hồ trong Dodo Payments
Trước khi theo dõi mức sử dụng, hãy tạo một đồng hồ trong bảng điều khiển Dodo Payments của bạn:Để biết hướng dẫn chi tiết, xem Hướng dẫn thanh toán dựa trên mức sử dụng.
- Đăng nhập vào Bảng điều khiển Dodo Payments
- Đi tới Sản phẩm → Đồng hồ
- Nhấp vào “Tạo đồng hồ”
- Cấu hình đồng hồ của bạn:
- Tên đồng hồ: Chọn một tên mô tả (ví dụ: “Sử dụng token LLM”)
- Tên sự kiện: Đặt một định danh sự kiện duy nhất (ví dụ,
llm.chat_completion) - Loại tổng hợp: Chọn
sumđể cộng dồn số lượng token - Theo thuộc tính: Chọn những gì để theo dõi:
inputTokens- Theo dõi token đầu vào/lời nhắcoutputTokens- Theo dõi token đầu ra/hoàn thành (bao gồm token lý do khi có thể)totalTokens- Theo dõi tổng hợp token đầu vào + đầu ra
Tên Sự kiện bạn đặt ở đây phải khớp chính xác với những gì bạn truyền cho SDK (phân biệt chữ hoa chữ thường).
4
Theo dõi việc sử dụng token
Bọc client LLM của bạn và bắt đầu theo dõi tự động:
Thế là xong! Mỗi cuộc gọi API bây giờ tự động theo dõi việc sử dụng token và gửi sự kiện đến Dodo Payments để thanh toán.
Cấu hình
Cấu hình Trình theo dõi
Tạo một trình theo dõi một lần tại khởi động ứng dụng với các tham số yêu cầu sau:Khóa API Dodo Payments của bạn. Lấy từ trang Khóa API.
Chế độ môi trường cho trình theo dõi.
test_mode- Sử dụng cho phát triển và thử nghiệmlive_mode- Sử dụng cho sản xuất
Tên sự kiện kích hoạt đồng hồ của bạn. Phải khớp chính xác với những gì bạn đã cấu hình trong đồng hồ Dodo Payments của bạn (phân biệt chữ hoa chữ thường).
Tên sự kiện này liên kết việc sử dụng bạn theo dõi với đồng hồ đúng cho các phép tính thanh toán.
Cấu hình Bọc
Khi bọc client LLM của bạn, cung cấp các tham số sau:Thể hiện client LLM của bạn (OpenAI, Anthropic, Groq, v.v.).
Định danh khách hàng duy nhất cho việc thanh toán. Điều này nên khớp với ID khách hàng của bạn trong Dodo Payments.
Dữ liệu bổ sung tùy chọn để đính kèm vào sự kiện theo dõi. Hữu ích cho việc lọc và phân tích.
Ví dụ Cấu hình Hoàn chỉnh
Theo dõi tự động: SDK tự động theo dõi việc sử dụng token trong nền mà không làm thay đổi phản hồi. Mã của bạn vẫn sạch sẽ và giống như khi sử dụng các SDK của nhà cung cấp gốc.
Các Nhà cung cấp Hỗ trợ
LLM Blueprint hoạt động liền mạch với tất cả các nhà cung cấp và tổng hợp LLM lớn:AI SDK (Vercel)
AI SDK (Vercel)
Theo dõi việc sử dụng với Vercel AI SDK cho hỗ trợ LLM toàn cầu.Chỉ số theo dõi:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Tên mô hình
Khi sử dụng các mô hình có khả năng lý do thông qua AI SDK (như Gemini 2.5 Flash của Google với chế độ suy nghĩ), các token lý do sẽ tự động được bao gồm trong số lượng
outputTokens để thanh toán chính xác.OpenRouter
OpenRouter
Theo dõi việc sử dụng token trên hơn 200 mô hình thông qua API thống nhất của OpenRouter.Chỉ số theo dõi:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Tên mô hình
OpenAI
OpenAI
Theo dõi việc sử dụng token từ các mô hình GPT của OpenAI một cách tự động.Chỉ số theo dõi:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Tên mô hình
Anthropic Claude
Anthropic Claude
Theo dõi việc sử dụng token từ các mô hình Claude của Anthropic.Chỉ số theo dõi:
input_tokens→inputTokensoutput_tokens→outputTokens- Tính toán
totalTokens - Tên mô hình
Groq
Groq
Theo dõi việc suy diễn LLM siêu nhanh với Groq.Chỉ số theo dõi:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Tên mô hình
Google Gemini
Google Gemini
Theo dõi việc sử dụng token từ các mô hình Gemini của Google thông qua Google GenAI SDK.Chỉ số theo dõi:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Phiên bản mô hình
Chế độ Suy nghĩ Gemini: Khi sử dụng các mô hình Gemini với khả năng suy nghĩ/lý do (như Gemini 2.5 Pro), SDK tự động bao gồm
thoughtsTokenCount (token lý do) trong outputTokens để phản ánh chính xác toàn bộ chi phí tính toán.Sử dụng Nâng cao
Nhiều Nhà cung cấp
Theo dõi việc sử dụng trên các nhà cung cấp LLM khác nhau với các trình theo dõi riêng biệt:Tích hợp API Express.js
Ví dụ hoàn chỉnh về việc tích hợp theo dõi LLM vào một API Express.js:Những gì được theo dõi
Mỗi cuộc gọi API LLM tự động gửi một sự kiện sử dụng đến Dodo Payments với cấu trúc sau:Các Trường Sự kiện
Định danh duy nhất cho sự kiện cụ thể này. Tự động được tạo bởi SDK.Định dạng:
llm_[timestamp]_[random]ID khách hàng bạn đã cung cấp khi bọc client. Sử dụng cho việc thanh toán.
Tên sự kiện kích hoạt đồng hồ của bạn. Khớp với cấu hình trình theo dõi của bạn.
Thời gian ISO 8601 khi sự kiện xảy ra.
Việc sử dụng token và dữ liệu theo dõi bổ sung:
inputTokens- Số lượng token đầu vào/lời nhắc đã sử dụngoutputTokens- Số lượng token đầu ra/hoàn thành đã sử dụng (bao gồm token lý do khi có thể)totalTokens- Tổng số token (đầu vào + đầu ra)model- Mô hình LLM đã sử dụng (ví dụ: “gpt-4”)provider- Nhà cung cấp LLM (nếu được bao gồm trong metadata bọc)- Bất kỳ metadata tùy chỉnh nào bạn đã cung cấp khi bọc client
Token Lý do: Đối với các mô hình có khả năng lý do,
outputTokens tự động bao gồm cả token hoàn thành và token lý do.Đồng hồ Dodo Payments của bạn sử dụng các trường
metadata (đặc biệt là inputTokens, outputTokens hoặc totalTokens) để tính toán việc sử dụng và thanh toán.