TokenLab Management API bổ sung tính năng tra cứu số dư tổ chức

Management API của TokenLab hiện đã hỗ trợ tra cứu số dư trực tiếp, cho phép các nhóm truy vấn tổng số dư hiện tại của tổ chức thông qua management token thay vì phải kiểm tra thủ công trên bảng điều khiển. Điều này giúp giải quyết một khoảng trống phổ biến đối với các nhóm đang vận hành các quy trình kiểm tra ngân sách tự động, cảnh báo nạp tiền hoặc các quy trình làm việc bị giới hạn bởi mức sử dụng.

Những điểm chính

• Management API hiện đã cung cấp một endpoint số dư, trả về tổng số dư hiện tại của tổ chức bạn.
• Endpoint này tách biệt với các API key suy luận mô hình (model inference API keys) được sử dụng để gọi Claude Sonnet 5, GPT-5.5, Gemini 3.5 Flash và các mô hình khác.
• Tính năng tra cứu số dư dành cho việc kiểm tra ngân sách, cảnh báo nạp tiền, tạm dừng hoặc tiếp tục các quy trình làm việc tự động và cung cấp dữ liệu cho các bảng điều khiển tài chính.
• Endpoint này kết hợp tốt với endpoint sử dụng API key hiện có để xây dựng bức tranh chi tiêu toàn diện.

Tại sao tính năng này lại cần thiết?

Trước bản cập nhật này, việc kiểm tra số dư của tổ chức đồng nghĩa với việc đăng nhập vào bảng điều khiển TokenLab và xem trên trang thanh toán. Điều đó ổn nếu bạn chỉ kiểm tra mỗi ngày một lần, nhưng sẽ trở nên bất tiện ngay khi bạn muốn tự động hóa bất kỳ quy trình nào.

Các nhóm đang chạy khối lượng công việc sản xuất trên các mô hình như DeepSeek V4 Pro, Qwen3.7 Plus hoặc Kimi K2.7 Code thường muốn có một tập lệnh kiểm tra số dư trước khi bắt đầu một công việc lớn, hoặc một trình giám sát sẽ gửi cảnh báo khi số dư giảm xuống dưới một ngưỡng nhất định. Nếu không có endpoint truy vấn số dư, các lựa chọn duy nhất là kiểm tra thủ công hoặc cào dữ liệu từ bảng điều khiển, cả hai đều không phải là cách bạn muốn thực hiện trong môi trường sản xuất.

Việc tra cứu số dư thông qua Management API sẽ khắc phục điều này. Giờ đây, cùng một quy trình tự động kích hoạt hàng loạt công việc tạo video trên Kling 3.0 hoặc Seedance có thể kiểm tra số dư khả dụng trước và quyết định xem có nên tiếp tục hay không.

Management Token so với Model Inference API Key

Điều này cần được làm rõ, vì hai loại thông tin xác thực phục vụ các mục đích khác nhau và việc nhầm lẫn chúng sẽ dẫn đến các lỗi khó hiểu.

Model inference API key là những gì bạn sử dụng để gọi trực tiếp các mô hình. Nếu bạn đang gửi yêu cầu hoàn thành trò chuyện (chat completion) tới GPT-5.5, tạo hình ảnh với GPT Image 2 hoặc Nano Banana Pro, hoặc kết xuất video với Veo 3 hoặc PixVerse V6, bạn đang xác thực bằng inference key. Các khóa này được giới hạn trong việc thực hiện các lệnh gọi mô hình và trả về kết quả mô hình. Chúng không cho phép bạn truy cập vào dữ liệu cấp tài khoản như số dư hoặc tóm tắt mức sử dụng.

Management token là một loại thông tin xác thực riêng biệt được xây dựng cho các hoạt động tài khoản. Chúng cho phép bạn truy vấn các thông tin về tổ chức của mình nói chung: số dư, mức sử dụng trên các API key và các dữ liệu cấp tài khoản khác. Management token không gọi trực tiếp bất kỳ mô hình nào. Đây là thông tin xác thực bạn sử dụng cho khía cạnh kế toán khi vận hành tài khoản trên TokenLab, không phải khía cạnh tạo nội dung.

Việc giữ tách biệt các loại khóa này rất quan trọng vì một lý do thực tế: nó cho phép bạn cung cấp management token cho quy trình tài chính hoặc vận hành mà không cần cấp cho quy trình đó khả năng tiêu tốn ngân sách mô hình của bạn. Ngược lại, một dịch vụ chỉ cần gọi GLM-5.2 hoặc DeepSeek V4 Flash thì không cần bất kỳ quyền truy cập nào vào số dư hoặc lịch sử chi tiêu của bạn, vì vậy nó chỉ nên giữ inference key.

Cách thức hoạt động của tra cứu số dư

Endpoint mới trả về tổng số dư hiện tại của tổ chức bạn dưới dạng phản hồi đơn giản. Bạn gọi nó bằng management token và nó sẽ cho bạn biết tình trạng hiện tại.

Dưới đây là ví dụ tối thiểu sử dụng các giá trị giữ chỗ:

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

Phản hồi sẽ cung cấp cho bạn số dư hiện tại của tổ chức. Từ đó, mô hình thông thường là:

1. Gọi endpoint số dư theo lịch trình hoặc ngay trước khi một công việc tốn kém bắt đầu.
2. So sánh giá trị trả về với ngưỡng bạn đã xác định.
3. Kích hoạt bất kỳ hành động nào phù hợp: gửi cảnh báo, tạm dừng hàng đợi, chặn các yêu cầu công việc mới hoặc chỉ ghi nhật ký để xem sau.

Vì đây là một thao tác đọc đơn giản, việc gọi thường xuyên rất tiết kiệm chi phí. Các nhóm chạy các quy trình khối lượng lớn trên các mô hình như DeepSeek V4 Pro hoặc Claude Sonnet 5 có thể kiểm tra số dư trước mỗi lô lớn mà không gây ra chi phí vận hành đáng kể.

Chi tiết đầy đủ về endpoint có trong tài liệu tham khảo về số dư Management API.

Tính năng này phù hợp ở đâu: Kiểm tra ngân sách, Cảnh báo và Bảng điều khiển

Các trường hợp sử dụng phổ biến nhất mà các nhóm yêu cầu bao gồm bốn kịch bản:

Trường hợp sử dụng	Mô tả
Kiểm tra ngân sách trước khi làm việc	Tập lệnh kiểm tra số dư trước khi gửi một công việc hàng loạt lớn đến mô hình như Kling 3.0 hoặc Veo 3, bỏ qua công việc nếu số dư quá thấp
Cảnh báo nạp tiền	Kiểm tra theo lịch trình so sánh số dư với giá trị tối thiểu, gửi cảnh báo qua Slack hoặc email khi vượt ngưỡng
Tạm dừng và tiếp tục quy trình làm việc	Tự động hóa tạm dừng quy trình gọi Qwen3.7 Plus hoặc GLM-5.2 khi số dư giảm, tiếp tục khi đã nạp tiền
Bảng điều khiển tài chính	Số dư được lấy theo lịch trình và hiển thị cùng với dữ liệu sử dụng để báo cáo

Nếu bạn đang thiết lập tính năng này lần đầu tiên, một danh sách kiểm tra ngắn sẽ giúp việc triển khai gọn gàng hơn:

• Tạo hoặc xác nhận management token của bạn có phạm vi quyền phù hợp để truy cập số dư
• Lưu trữ management token tách biệt với bất kỳ inference API key nào
• Đặt khoảng thời gian thăm dò hợp lý (mỗi công việc, hàng giờ hoặc hàng ngày, tùy thuộc vào trường hợp sử dụng của bạn)
• Quyết định ngưỡng cảnh báo trước, không phải sau khi số dư đã cạn kiệt
• Kết hợp tra cứu số dư với endpoint sử dụng API key nếu bạn muốn có bảng phân tích chi tiêu đầy đủ cùng với số dư

Đối với các nhóm muốn có dữ liệu chi tiêu lịch sử thay vì chỉ là con số dư trực tiếp, bài viết về xuất dữ liệu sử dụng trên bảng điều khiển sẽ hướng dẫn cách lấy dữ liệu đó để báo cáo.

Bắt đầu

Nếu bạn đã sử dụng Management API để báo cáo mức sử dụng, việc thêm kiểm tra số dư rất dễ dàng: cùng một mô hình xác thực, thêm một endpoint mới để gọi. Nếu bạn chưa thiết lập management token, hãy tạo một mã từ cài đặt tài khoản của bạn và giữ nó tách biệt với bất kỳ inference API key nào bạn sử dụng để gọi mô hình.

Câu hỏi thường gặp

Tra cứu số dư có yêu cầu API key đặc biệt không? Không cần loại khóa đặc biệt nào ngoài management token tiêu chuẩn. Đây là thông tin xác thực khác với inference API key được sử dụng để gọi mô hình, nhưng không cần cấu hình bổ sung nào ngoài việc có management token hợp lệ.

Tôi có thể sử dụng tính năng này để tự động dừng công việc khi hết số dư không? Có. Đó là một trong những trường hợp sử dụng chính. Kiểm tra số dư trước hoặc trong khi làm việc, và nếu nó giảm xuống dưới ngưỡng của bạn, hãy tạm dừng quy trình làm việc, dừng hàng đợi hoặc chặn các yêu cầu mới cho đến khi số dư được khôi phục.

Đây có phải là endpoint mức sử dụng không? Không. Tra cứu số dư trả về tổng số dư hiện tại của bạn. Endpoint sử dụng API key trả về dữ liệu sử dụng được phân tách theo từng khóa. Hầu hết các bảng điều khiển tài chính đều sử dụng cả hai cùng nhau.

Nguồn và độ mới

Bài viết này phản ánh endpoint số dư của Management API được ghi nhận vào ngày 2026-07-07. Hành vi của endpoint và định dạng phản hồi có thể thay đổi; hãy kiểm tra tài liệu chính thức về endpoint số dư để có thông tin tham khảo hiện tại.

---

Sẵn sàng tích hợp kiểm tra số dư vào quy trình làm việc của bạn? Hãy đăng nhập vào TokenLab, tạo management token và bắt đầu truy vấn số dư tổ chức của bạn ngay hôm nay.

Đọc thêm và bước tiếp theo

Tra cứu số dư tổ chức hoạt động cùng với các công cụ báo cáo khác đã có sẵn trong TokenLab Management API. Để xem xét kỹ hơn cách dữ liệu chi tiêu có thể được lấy và đánh giá thường xuyên, hãy xem TokenLab Usage Exports Make AI API Spend Easier to Review. Nếu bạn đang lập kế hoạch chi tiêu trước khi ra mắt, AI API Cost Calculator Guide: Estimate Spend Before You Ship sẽ hướng dẫn cách ước tính chi phí trước khi gửi yêu cầu. Và để biết bối cảnh về cách các nhà cung cấp so sánh với nhau, AI API Pricing Comparison 2026: The Real Cost of GPT-5.5, Claude Sonnet 5, and Gemini 3.5 Flash sẽ phân tích mức giá hiện tại trên các mô hình chính.

Như thường lệ, tính khả dụng và giá cả của mô hình thay đổi thường xuyên, vì vậy hãy xác nhận chi tiết hiện tại trước khi dựa vào chúng cho việc sử dụng sản xuất khối lượng lớn. Sẵn sàng tự mình thử nghiệm tra cứu số dư? Tạo API key và bắt đầu thử nghiệm ngay hôm nay.