Chuyển đến nội dung chính

​
Tổng quan

Endpoint này tạo một API key mới loại type=user trong tổ chức gắn với management token hiện tại.

​
Phần thân yêu cầu

TrườngKiểuMặc định / giới hạnMô tả
namestringbắt buộc, mặc định Default Key, độ dài 1-50Tên hiển thị; server sẽ cắt khoảng trắng ở đầu và cuối
limitAmountnumber | nulltối thiểu 0, tối đa 100000null hoặc bỏ qua = không giới hạn, 0 = quota bằng 0, số dương = trần chi tiêu USD
limitCurrencyenummặc định USDTùy chọn: USD hoặc CNY. Khi đặt là CNY, limitAmount sẽ được hiểu là RMB và được server quy đổi sang USD trước khi lưu
modelsstring[]mặc định []Danh sách cho phép model logic tùy chọn
expiresAtstring | nulldatetime RFC3339null nghĩa là không hết hạn

​
Lưu ý

  • Giá trị đầy đủ của API key chỉ được hiển thị một lần trong phản hồi.
  • models: [] nghĩa là key không có ràng buộc model bổ sung ngoài chính sách của tổ chức.
  • limitAmount: 0 tạo ra một key hợp lệ nhưng chưa thể tiêu quota cho đến khi được cập nhật sau đó.
  • Mặc định, limitAmount được hiểu theo USD. Nếu gửi limitCurrency: "CNY", hạn mức sẽ được hiểu theo RMB và tự động quy đổi sang USD theo tỷ giá hiện tại trước khi lưu.
  • Response sẽ kèm exchange_rate cùng các trường hiển thị RMB là limit_amount_cny và used_amount_cny.

​
Ví dụ

curl -X POST "https://api.lemondata.cc/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "sora-2"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

​
Yêu cầu / Phản hồi

Hãy dùng bảng OpenAPI tương tác phía trên để xem schema chính xác và các trường phản hồi.