Lấy mức sử dụng API key

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

{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5-mini",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "model_vendor": "OpenAI",
      "scene": "chat",
      "usage_unit": "per_token",
      "usage_quantity": 1500,
      "usage_quantity_decimal": "1500",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "total_tokens": 1500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "cache_write_tokens_5m": 0,
      "cache_write_tokens_1h": 0,
      "cost": 0.0012,
      "cost_decimal": "0.0012",
      "created_at": "2026-07-08T03:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

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ộ chi tiết thực thi của provider.

Tham số truy vấn

Tham số	Kiểu	Mặc định / giới hạn	Mô tả
`page`	integer	mặc định `1`, tối thiểu `1`	Số trang bắt đầu từ 1
`limit`	integer	mặc định `50`, tối thiểu `1`, tối đa `100`	Kích thước mỗi trang
`model`	string	độ dài tối đa `100`	Tên model được yêu cầu
`modelVendor`	string	độ dài tối đa `100`	Nhà cung cấp model công khai
`scene`	enum	-	`chat`, `image`, `audio`, `video`, `embedding`, `rerank`, `translation`, `music`, `3d`, `realtime`
`startDate`	string	-	Cận dưới bao gồm; chấp nhận RFC3339 có múi giờ hoặc `YYYY-MM-DD`
`endDate`	string	-	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 startDate và endDate, thì startDate phải nhỏ hơn hoặc bằng endDate.

Lưu ý

Các trường tiền tệ chỉ hỗ trợ USD. Dữ liệu nhập CNY đã bị ngừng hỗ trợ và trả về 400 currency_retired.
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.
Mỗi dòng usage cũng có thể bao gồm billing_transaction_id sau khi request gốc đã được settlement xong. Hãy dùng giá trị này cùng với request_id để đối soát ở cấp request.
Metadata routing nội bộ và kênh vật lý sẽ tiếp tục bị ẩn.

Ví dụ

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&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.

Ví dụ phản hồi

{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5-mini",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "model_vendor": "OpenAI",
      "scene": "chat",
      "usage_unit": "per_token",
      "usage_quantity": 1500,
      "usage_quantity_decimal": "1500",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "total_tokens": 1500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "cache_write_tokens_5m": 0,
      "cache_write_tokens_1h": 0,
      "cost": 0.0012,
      "cost_decimal": "0.0012",
      "created_at": "2026-07-08T03:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

Các trường quan trọng

object

Tóm tắt khóa API với các trường giống như phản hồi liệt kê, tạo và cập nhật.

array

Các dòng sử dụng đã phân trang.

object

Siêu dữ liệu phân trang gồm page, limit, total và totalPages.

object

Tổng số liệu tổng hợp theo các bộ lọc đã chọn.

object

Phân tích tổng hợp theo các bộ lọc đã chọn.

string | null

Mã định danh yêu cầu công khai để hỗ trợ và đối soát.

string | null

ID giao dịch thanh toán đã quyết toán khi có.

string

Tên mô hình công khai được yêu cầu.

string

Mô hình công khai logic dùng cho báo cáo.

string | null

Nhà cung cấp mô hình công khai.

string | null

Ngữ cảnh yêu cầu công khai.

string

Đơn vị sử dụng tính phí, chẳng hạn per_token.

number

Lượng sử dụng dưới dạng số JSON để hiển thị.

string

Lượng sử dụng chính xác dưới dạng chuỗi thập phân.

number

Số token prompt.

number

Số token hoàn thành.

number

Tổng số token.

number

Số token đọc bộ nhớ đệm.

number

Tổng số token ghi bộ nhớ đệm.

number

Số token ghi bộ nhớ đệm 5 phút.

number

Số token ghi bộ nhớ đệm 1 giờ.

number

Chi phí bằng USD dưới dạng số JSON để hiển thị.

string

Chi phí chính xác bằng USD dưới dạng chuỗi thập phân.

string

Dấu thời gian ISO của dòng sử dụng.

number

Tổng số yêu cầu.

number

Tổng chi phí bằng USD dưới dạng số JSON để hiển thị.

string

Tổng chi phí chính xác bằng USD dưới dạng chuỗi thập phân.

number

Tổng số token prompt.

number

Tổng số token hoàn thành.

number

Tổng số token.

array

Lượng sử dụng được nhóm theo đơn vị sử dụng.

array

Phân tích theo mô hình công khai được yêu cầu.

array

Phân tích theo mô hình công khai logic.

array

Phân tích theo nhà cung cấp mô hình công khai.

array

Phân tích theo ngữ cảnh yêu cầu công khai.

array

Xu hướng chi phí hằng ngày.

Cốt lõi

Văn bản

Tệp và lô

Hình ảnh

Âm thanh & thời gian thực

Âm nhạc

Video & tư liệu

Worlds

3D

Tác vụ bất đồng bộ

Gemini gốc

Quản lý

Lấy mức sử dụng API key

Tổng quan

Tham số truy vấn

Lưu ý

Ví dụ

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

Ví dụ phản hồi

Các trường quan trọng

​Tổng quan

​Tham số truy vấn

​Lưu ý

​Ví dụ

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

​Ví dụ phản hồi

​Các trường quan trọng

Tổng quan

Tham số truy vấn

Lưu ý

Ví dụ

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

Ví dụ phản hồi

Các trường quan trọng