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
list/create/update レスポンスと同じフィールドを持つ API キー概要。
summaryobject
選択したフィルターに基づく集計値。
breakdownsobject
選択したフィルターに基づく内訳。
summary.total_requestsnumber
総リクエスト数。
summary.total_costnumber
表示用に JSON 数値で返される USD の総コスト。
summary.total_cost_decimalstring
10 進文字列で返される USD の正確な総コスト。
summary.total_prompt_tokensnumber
プロンプトトークン総数。
summary.total_completion_tokensnumber
完了トークン総数。
summary.total_tokensnumber
総トークン数。
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

公開リクエストシーンによるフィルタリング。

指定できる値

  • "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 Key の使用量を取得

前へ