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

Tổng quan

Endpoint này trả về chi tiết mức sử dụng theo API key mà không làm lộ metadata routing vật lý.

Tham số query

Tham sốKiểuMặc định / giới hạnMô tả
pageintegermặc định 1, tối thiểu 1Số trang bắt đầu từ 1
limitintegermặc định 50, tối thiểu 1, tối đa 100Kích thước mỗi trang
logicalModelstringđộ dài tối đa 100Tên model logic được yêu cầu
modelVendorstringđộ dài tối đa 100Nhà cung cấp model công khai
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform hoặc byok
startDatestring-Cận dưới bao gồm; chấp nhận RFC3339 có múi giờ hoặc YYYY-MM-DD
endDatestring-Cận trên bao gồm; chấp nhận RFC3339 có múi giờ hoặc YYYY-MM-DD
Nếu truyền đồng thời startDateendDate, thì startDate phải nhỏ hơn hoặc bằng endDate.

Lưu ý

  • Phản hồi có phân trang.
  • Phản hồi chỉ bao gồm các trường chi phí và báo cáo công khai.
  • Metadata routing nội bộ và kênh vật lý sẽ tiếp tục bị ẩn.
  • Tất cả các trường tiền tệ vẫn có sẵn ở USD và nay còn có thêm bản hiển thị RMB như cost_cny, total_cost_cnycost_cny trong từng breakdown.
  • api_key.exchange_rate là tỷ giá USD→CNY dùng cho mọi giá trị *_cny trong response đó.

Ví dụ

curl "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

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.