Quản lý
API Quản Lý
Kiểm tra số dư Workspace, quản lý API key, và truy xuất mức sử dụng cùng thông tin thanh toán
Sử dụng Management API từ backend hoặc quy trình tự động hóa của riêng bạn để quản lý TokenLab Workspace. API này sử dụng management token, vì vậy chương trình không cần API key thông thường.
Tạo management token trong Dashboard → API → Management Tokens:
Authorization: Bearer mt-your-management-tokenManagement token và API key có vai trò khác nhau. Chỉ sử dụng mt-... với /v1/management/*. Sử dụng sk-... với các API mô hình chẳng hạn như /v1/responses.
Endpoints
| Endpoint | Phương thức | Mục đích |
|---|---|---|
/v1/management/balance | GET | Lấy số dư Workspace |
/v1/management/api-keys | GET | Liệt kê các API key |
/v1/management/api-keys | POST | Tạo một API key |
/v1/management/api-keys/{keyId} | PATCH | Thay đổi tên, giới hạn, mô hình, thời hạn hết hạn hoặc trạng thái |
/v1/management/api-keys/{keyId}/usage | GET | Lấy các bản ghi mức sử dụng riêng lẻ |
/v1/management/api-keys/{keyId}/billing | GET | Lấy thông tin tóm tắt thanh toán |
API Keys
- Khóa bí mật đầy đủ của key mới chỉ xuất hiện trong phản hồi tạo.
models: []không áp dụng hạn chế mô hình nào ở cấp độ key.limitAmount: nullnghĩa là không giới hạn.0ngăn key phát sinh chi tiêu.- Các số tiền sử dụng USD. Việc gửi
CNYsẽ trả về400 currency_retired. - Trạng thái
inactivecó thể được bật lại. Sử dụngrevokedđể hủy bỏ vĩnh viễn một key.
Mức sử dụng và Thanh toán
/usage trả về các bản ghi được phân trang và hỗ trợ lọc theo mô hình, nhà sản xuất mô hình, scene và ngày tháng. Các bản ghi đã thanh toán có thể bao gồm billing_transaction_id; hãy lưu giá trị này cùng với request_id khi bạn cần đối soát một khoản phí với một request.
/billing trả về tổng số được nhóm theo mô hình, nhà sản xuất mô hình, scene và ngày tháng. Nó không bao gồm các khoản nạp tiền vào Workspace hoặc hóa đơn.
Một endDate chỉ có ngày như 2026-07-31 nghĩa là 00:00 UTC vào thời điểm bắt đầu ngày đó. Để bao gồm toàn bộ ngày, hãy truyền ngày tiếp theo hoặc thời gian theo chuẩn RFC3339 như 2026-07-31T23:59:59Z.
Lỗi
Các lỗi sử dụng đối tượng error tiêu chuẩn. Hãy xử lý chúng theo trạng thái và code.
| Trạng thái | code | Ý nghĩa |
|---|---|---|
| 400 | validation_error | Một trường hoặc tham số truy vấn không hợp lệ |
| 400 | invalid_model_access | Một mô hình trong models không được cho phép bởi chính sách mô hình của Workspace |
| 400 | currency_retired | limitCurrency là CNY; hãy sử dụng USD |
| 401 | invalid_management_token | Token bị thiếu, không đúng định dạng hoặc đã bị thu hồi |
| 403 | organization_inactive | Workspace hiện không hoạt động |
| 404 | not_found | API key không tồn tại trong Workspace này |
| 409 | api_key_revoked | Key đã bị thu hồi không thể bật lại; hãy tạo một key mới |
| 429 | report_busy | Có quá nhiều báo cáo mức sử dụng hoặc thanh toán đang chạy. Hãy thử lại sau số giây trong Retry-After |
Ví dụ
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"