Truy vấn log sử dụng

Endpoint này trả về lịch sử tiêu thụ (model, số token, quota đã trừ) để bạn tự đối chiếu chi phí trong hệ thống của mình. Chỉ cần API key, không cần đăng nhập.

Endpoint

GET https://cheapkeyai.shop/v1/usage/logs

Yêu cầu

Tên	Vị trí	Bắt buộc	Mô tả
Authorization	header	Có	`Bearer sk-your-api-key-here`
scope	query	Không	`key` (mặc định) chỉ lấy log của key đang gọi; `account` lấy log của mọi key trong tài khoản
model_name	query	Không	Lọc theo đúng tên model, ví dụ `gpt-5.6-sol`
start_timestamp	query	Không	Mốc đầu, Unix seconds
end_timestamp	query	Không	Mốc cuối, Unix seconds
page	query	Không	Trang, mặc định `1`
page_size	query	Không	Số dòng mỗi trang, mặc định `20`, tối đa `100`

Ví dụ

curl https://cheapkeyai.shop/v1/usage/logs \
  -H "Authorization: Bearer sk-your-api-key-here"

curl "https://cheapkeyai.shop/v1/usage/logs?scope=account&model_name=gpt-5.6-sol&page=1&page_size=50" \
  -H "Authorization: Bearer sk-your-api-key-here"

Phản hồi 200

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "created_at": 1786452872,
        "model_name": "gpt-5.6-sol",
        "quota": 1234,
        "prompt_tokens": 100,
        "completion_tokens": 20,
        "use_time": 9,
        "is_stream": true,
        "token_name": "my-app-key",
        "group": "default"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "scope": "key"
  }
}

Giải thích các trường

Trường	Ý nghĩa
created_at	Thời điểm phát sinh, Unix seconds
model_name	Model đã gọi
quota	Quota bị trừ cho lượt gọi này
prompt_tokens	Token đầu vào
completion_tokens	Token đầu ra
use_time	Thời gian xử lý, giây
is_stream	Có dùng streaming hay không
token_name	Tên API key đã gọi
group	Group đã dùng cho lượt gọi
total	Tổng số dòng khớp điều kiện lọc
scope	Phạm vi đang áp dụng: `key` hoặc `account`

Endpoint

Yêu cầu

Ví dụ

Phản hồi 200

Giải thích các trường

Bài cùng nhóm · API tham khảo