管理
APIキーの請求情報を取得
ユーザーAPIキーの集計された請求内訳を返します。
概要
モデル、モデルメーカー、シーン、日付ごとにグループ化された、総支出、リクエスト数、課金対象の使用量、およびコストを返します。
注意事項
-
金額フィールドは米ドル(USD)のみです。
-
ワークスペースのチャージ(トップアップ)や請求書は含まれません。
-
日付のみの
endDateは、その日の開始時刻である UTC 00:00 を意味します。一日全体を含めるには、翌日の日付または RFC3339 形式の時刻を使用してください。 -
report_busyコードを伴う429エラーは、レポートキューが満杯であることを意味します。Retry-After秒後に再試行してください。
例
APIキーの使用状況を取得と同じモデル、モデルベンダー、シーン、日付のフィルタをサポートしています。ページネーションなしで合計を返します。
リクエスト
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"リクエスト / レスポンス
このページでは、OpenAPIスキーマとコピー可能なリクエスト例を提供しています。管理リクエストはターミナルまたはクライアントから 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.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"
}
]
}
}重要なフィールド
認証
ManagementTokenAuth 管理トークン認証。Dashboard > API > Management Tokensで管理トークンを作成または管理します。
場所: header
パスパラメータ
クエリパラメータ
リクエストされたモデル名によるフィルタリング。最大長100。
length <= 100公開モデルベンダーによるフィルタリング。最大長100。
length <= 100公開リクエストシーンによるフィルタリング。
指定できる値
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
下限値(境界値を含む)。タイムゾーン付きのRFC3339(例:2026-03-28T00:00:00+08:00)またはYYYY-MM-DD(UTCの00:00を意味する)を受け付けます。
上限値(境界値を含む)。タイムゾーン付きのRFC3339(例:2026-03-28T23:59:59+08:00)またはYYYY-MM-DD(その日の開始時のUTC 00:00を意味する)を受け付けます。一日全体を含めるには、翌日の日付またはその日の終わりのRFC3339時刻を渡してください。
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json