TokenLab
API 키 받기
문서API 레퍼런스통합

관리

API 키 청구 조회

사용자 API 키의 집계된 청구 내역을 반환합니다.

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

개요

이 엔드포인트는 선택한 API 키의 소비 기준 청구 집계를 반환합니다. 총 비용, 총 요청 수, 과금 단위별 사용량, by_model, by_logical_model, by_model_vendor, by_scene 내역과 일별 비용 추세가 포함됩니다.

주의 사항

  • 금액 필드는 USD만 지원합니다.

  • 충전, 인보이스 등 조직 수준의 재무 기록은 포함되지 않습니다.

예시

API 키 사용량과 동일한 모델, 모델 공급자, 장면, 날짜 필터를 지원합니다. 페이지 구분 없이 합계를 반환합니다.

요청

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"

요청 / 응답

이 페이지는 OpenAPI 스키마와 복사 가능한 요청 예제를 제공합니다. 관리 요청은 Management Token을 사용해 터미널이나 클라이언트에서 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.

응답 예시

응답

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"
      }
    ]
  }
}

주요 필드

api_keyobject
목록/생성/업데이트 응답과 동일한 필드를 사용하는 API 키 요약입니다.
summaryobject
선택한 필터의 집계 합계입니다.
breakdownsobject
선택한 필터의 집계 내역입니다.
summary.total_requestsnumber
전체 요청 수입니다.
summary.total_costnumber
표시용 JSON 숫자로 반환되는 USD 총비용입니다.
summary.total_cost_decimalstring
10진 문자열로 반환되는 정확한 USD 총비용입니다.
summary.total_prompt_tokensnumber
전체 프롬프트 token 수입니다.
summary.total_completion_tokensnumber
전체 완성 token 수입니다.
summary.total_tokensnumber
전체 token 수입니다.
summary.usage_unit_breakdownarray
사용 단위별로 그룹화한 사용량입니다.
breakdowns.by_modelarray
요청한 공개 모델별 내역입니다.
breakdowns.by_logical_modelarray
논리 공개 모델별 내역입니다.
breakdowns.by_model_vendorarray
공개 모델 공급업체별 내역입니다.
breakdowns.by_scenearray
공개 요청 시나리오별 내역입니다.
breakdowns.daily_costarray
일별 비용 추이입니다.

인증

ManagementTokenAuth
AuthorizationBearer <token>

관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.

위치: header

경로 매개변수

keyId*string

쿼리 매개변수

model?string

요청된 모델 이름으로 필터링. 최대 길이 100.

길이length <= 100
modelVendor?string

공개 모델 제공자로 필터링. 최대 길이 100.

길이length <= 100
scene?string

공개 요청 장면(scene)으로 필터링.

허용 값

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

응답

application/json

application/json

application/json

application/json

application/json

API 키 사용량 조회

이전