TokenLab

Quản lý

Lấy thông tin thanh toán API Key

Trả về bảng phân tích thanh toán tổng hợp cho một API key của người dùng.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

Tổng quan

Trả về tổng chi tiêu, số lượng yêu cầu, mức sử dụng có thể tính phí và chi phí được nhóm theo model, nhà cung cấp model, scene và ngày.

Lưu ý

  • Các trường tiền tệ chỉ tính bằng USD.

  • Không bao gồm các khoản nạp tiền vào Workspace và hóa đơn.

  • endDate chỉ bao gồm ngày có nghĩa là 00:00 UTC vào đầu ngày đó. Để bao gồm trọn vẹn một ngày, hãy sử dụng ngày tiếp theo hoặc thời gian theo định dạng RFC3339.

  • Mã lỗi 429 với mã report_busy nghĩa là hàng đợi báo cáo đã đầy. Hãy thử lại sau số giây được chỉ định trong Retry-After.

Ví dụ

Hỗ trợ các bộ lọc về model, nhà cung cấp model, scene và ngày tương tự như sử dụng API key. Trả về tổng số mà không phân trang.

Yêu cầu

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
  -H "Authorization: Bearer mt-your-management-token"

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

Trang này cung cấp lược đồ OpenAPI và các ví dụ yêu cầu có thể sao chép. Hãy gửi các yêu cầu quản lý từ terminal hoặc client của bạn bằng Management Token; việc gửi trực tiếp không khả dụng trên trang này.

Ví dụ phản hồi

Phản hồi

200 OK
{
  "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.6-luna",
      "claude-sonnet-4-6"
    ],
    "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",
    "delivery_policy": null
  },
  "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.6-luna",
        "logical_model": "gpt-5.6-luna",
        "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.6-luna",
        "logical_model": "gpt-5.6-luna",
        "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

api_keyobject
Tóm tắt API key sử dụng các trường tương tự như các phản hồi liệt kê/tạo/cập nhật.
summaryobject
Tổng hợp các giá trị cho các bộ lọc đã chọn.
breakdownsobject
Phân tích tổng hợp cho các bộ lọc đã chọn.
summary.total_requestsnumber
Tổng số lượng yêu cầu.
summary.total_costnumber
Tổng chi phí bằng USD dưới dạng số JSON để hiển thị.
summary.total_cost_decimalstring
Tổng chi phí chính xác bằng USD dưới dạng chuỗi thập phân.
summary.total_prompt_tokensnumber
Tổng số prompt token.
summary.total_completion_tokensnumber
Tổng số completion token.
summary.total_tokensnumber
Tổng số token.
summary.usage_unit_breakdownarray
Số lượng sử dụng được nhóm theo đơn vị sử dụng.
breakdowns.by_modelarray
Phân tích theo model công khai được yêu cầu.
breakdowns.by_logical_modelarray
Phân tích theo model công khai logic.
breakdowns.by_model_vendorarray
Phân tích theo nhà cung cấp model công khai.
breakdowns.by_scenearray
Phân tích theo scene yêu cầu công khai.
breakdowns.daily_costarray
Xu hướng chi phí hàng ngày.

Xác thực

ManagementTokenAuth
AuthorizationBearer <token>

Xác thực bằng Token quản lý. Tạo hoặc quản lý Token quản lý trong Dashboard > API > Management Tokens.

Vị trí: header

Tham số đường dẫn

keyId*string

Tham số truy vấn

model?string

Lọc theo tên model được yêu cầu. Độ dài tối đa 100.

Độ dàilength <= 100
modelVendor?string

Lọc theo nhà cung cấp model công khai. Độ dài tối đa 100.

Độ dàilength <= 100
scene?string

Lọc theo ngữ cảnh yêu cầu công khai.

Giá trị hợp lệ

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string

Giới hạn dưới, bao gồm cả giá trị này. Chấp nhận định dạng RFC3339 kèm múi giờ (ví dụ 2026-03-28T00:00:00+08:00) hoặc YYYY-MM-DD, nghĩa là 00:00 UTC.

endDate?string

Giới hạn trên, bao gồm cả giá trị này. Chấp nhận định dạng RFC3339 kèm múi giờ (ví dụ 2026-03-28T23:59:59+08:00) hoặc YYYY-MM-DD, nghĩa là 00:00 UTC vào đầu ngày đó. Để bao gồm cả ngày, hãy truyền ngày tiếp theo hoặc thời gian RFC3339 vào cuối ngày.

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json