Lấy mức sử dụng theo mô hình

GET /api/open/v1/usage/models

Tham số yêu cầu

Tham số	Vị trí	Kiểu	Bắt buộc	Mặc định	Mô tả
start_timestamp	query	integer	Không	Xem bên dưới	Thời gian bắt đầu (bao gồm), giây unix
end_timestamp	query	integer	Không	Xem bên dưới	Thời gian kết thúc (bao gồm), giây unix
limit	query	integer	Không	10	Số mô hình trả về, từ 1 đến 100; ngoài khoảng này trả về 400

Quy tắc khoảng thời gian:

• Bỏ trống cả hai: 30 ngày gần nhất.
• Chỉ có start_timestamp: 30 ngày tính về sau, tối đa đến thời điểm hiện tại.
• Chỉ có end_timestamp: 30 ngày tính về trước.
• Khoảng thời gian tối đa 366 ngày.

Ví dụ yêu cầu

curl "https://www.routeapi.ai/api/open/v1/usage/models?start_timestamp=1726400000&end_timestamp=1729000000&limit=10" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

Ví dụ phản hồi

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "model_name": "gpt-4o",
        "prompt_tokens": 120000,
        "completion_tokens": 30000,
        "total_tokens": 150000,
        "amount": 3.20
      }
    ],
    "start_timestamp": 1726400000,
    "end_timestamp": 1729000000
  }
}

Trường phản hồi

Trường	Kiểu	Mô tả
items[].model_name	string	Tên mô hình
items[].prompt_tokens	integer	Tổng token đầu vào của mô hình trong khoảng thời gian
items[].completion_tokens	integer	Tổng token đầu ra của mô hình trong khoảng thời gian
items[].total_tokens	integer	Tổng token đầu vào và đầu ra
items[].amount	number	Số tiền mô hình đã tiêu thụ, theo tiền tệ của trang, hai chữ số thập phân
start_timestamp	integer	Thời gian bắt đầu thực tế
end_timestamp	integer	Thời gian kết thúc thực tế

Lỗi

HTTP	code	Tình huống
400	invalid_request	limit không phải số nguyên từ 1 đến 100, timestamp âm, hoặc khoảng thời gian không hợp lệ
429	—	Vượt giới hạn truy vấn theo người dùng (mặc định 30/phút); body có thể trống

Các mã lỗi chung khác xem tại Lỗi API nền tảng.

Lưu ý

• Kết quả sắp xếp theo total_tokens giảm dần; nếu bằng nhau thì theo tên mô hình tăng dần, thứ tự ổn định.
• Chỉ tính log tiêu thụ (tính phí), không bao gồm yêu cầu thất bại.
• Số token là số đếm thô, không phải đơn vị triệu.
• Số tiền dùng tiền tệ hiển thị của trang, xem Lấy số dư.
• amount của mỗi dòng được làm tròn riêng, nên tổng các dòng có thể lệch tới 0,01.
• Endpoint này dùng chung giới hạn truy vấn theo người dùng (mặc định 30/phút) với Mức sử dụng, Log của tài khoản, Xuất log và Mức sử dụng theo Key. Xem Giới hạn tần suất.