TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Quản lý

Lấy dữ liệu thanh toán API Key

Trả về breakdown billing tổng hợp cho một API key người dùng.

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

Tổng Quan

Endpoint này trả về các tổng hợp billing theo mức tiêu thụ cho API key đã chọn, bao gồm tổng chi phí, tổng số request, usage theo đơn vị tính phí, các breakdown by_model, by_logical_model, by_model_vendor và by_scene, cùng xu hướng chi phí theo ngày.

Ghi Chú

  • Các trường tiền tệ chỉ hỗ trợ USD.

  • Nạp tiền, hóa đơn và các bản ghi tài chính ở cấp tổ chức sẽ không được đưa vào.

Ví Dụ

Hỗ trợ cùng bộ lọc mô hình, nhà cung cấp, ngữ cảnh và ngày như mức sử dụng khóa API. Trả về tổng hợp 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-31" \
  -H "Authorization: Bearer mt-your-management-token"

Yêu Cầu / Phản Hồi

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

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-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",
    "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 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.
summaryobject
Tổng số liệu tổng hợp theo các bộ lọc đã chọn.
breakdownsobject
Phân tích tổng hợp theo các bộ lọc đã chọn.
summary.total_requestsnumber
Tổng số 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ố token prompt.
summary.total_completion_tokensnumber
Tổng số token hoàn thành.
summary.total_tokensnumber
Tổng số token.
summary.usage_unit_breakdownarray
Lượng sử dụng được nhóm theo đơn vị sử dụng.
breakdowns.by_modelarray
Phân tích theo mô hình công khai được yêu cầu.
breakdowns.by_logical_modelarray
Phân tích theo mô hình công khai logic.
breakdowns.by_model_vendorarray
Phân tích theo nhà cung cấp mô hình công khai.
breakdowns.by_scenearray
Phân tích theo ngữ cảnh 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
endDate?string

Phản hồi

application/json

application/json

application/json

application/json

application/json

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

Trước