TokenLab

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-token

Management 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

EndpointPhương thứcMục đích
/v1/management/balanceGETLấy số dư Workspace
/v1/management/api-keysGETLiệt kê các API key
/v1/management/api-keysPOSTTạo một API key
/v1/management/api-keys/{keyId}PATCHThay đổ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}/usageGETLấy các bản ghi mức sử dụng riêng lẻ
/v1/management/api-keys/{keyId}/billingGETLấ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: null nghĩa là không giới hạn. 0 ngăn key phát sinh chi tiêu.
  • Các số tiền sử dụng USD. Việc gửi CNY sẽ trả về 400 currency_retired.
  • Trạng thái inactive có thể được bật lại. Sử dụng revoked để 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áicodeÝ nghĩa
400validation_errorMột trường hoặc tham số truy vấn không hợp lệ
400invalid_model_accessMột mô hình trong models không được cho phép bởi chính sách mô hình của Workspace
400currency_retiredlimitCurrency là CNY; hãy sử dụng USD
401invalid_management_tokenToken bị thiếu, không đúng định dạng hoặc đã bị thu hồi
403organization_inactiveWorkspace hiện không hoạt động
404not_foundAPI key không tồn tại trong Workspace này
409api_key_revokedKey đã bị thu hồi không thể bật lại; hãy tạo một key mới
429report_busyCó 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"

Tiếp theo

Trên trang này