コンテンツにスキップ
無料で登録
API リファレンス

1 つの API Key のリクエストログを取得する

1 つの BetterToken API Key の最新リクエストログを最大 1,000 件取得します。時刻、リクエスト ID、Token 数、記録ごとの通貨と請求額の読み方を説明します。

GET https://bettertoken.ai/api/log/token を使うと、1 つの BetterToken API Key の最近のリクエストログを取得できます。

リクエストを送信する

モデルの呼び出しに使う sk-... で始まる BetterToken API Key を使用します。次のコマンドを実行する前に、ローカル環境変数 BETTERTOKEN_API_KEY に設定してください。

認証には Authorization: Bearer <API_KEY> を使います。パラメータとリクエスト本文は不要です。完全な URL に /v1 は含まれません。

ターミナルウィンドウ
curl -sS 'https://bettertoken.ai/api/log/token' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

成功時のレスポンス

成功時は success が true になり、data にこの Key のログ配列が返されます。新しく書き込まれた記録が先に並び、最大 1,000 件が返されます。

この API にはページネーション、時刻フィルター、リクエスト ID フィルターはありません。

例にはよく使うフィールドのみを示しています。数値は説明用です。

{
"success": true,
"message": "",
"data": [
{
"created_at": 1795046400,
"type": 2,
"model_name": "gpt-6.2-sol",
"request_id": "example-request-id",
"prompt_tokens": 120,
"completion_tokens": 48,
"quota": 600,
"recorded_amount": "0.0012",
"currency": "USD"
}
]
}

ログの読み方

フィールド意味
created_at秒単位の Unix タイムスタンプ。
model_nameモデル ID。
request_idこのフィールドがある場合、モデルへのリクエストと記録を照合できます。
prompt_tokens記録された入力 Token 数。API と課金方式によって異なります。
completion_tokens記録された出力 Token 数。API と課金方式によって異なります。
type2 は消費の記録を示します。
quota記録された利用枠の値。内部の利用枠単位です。
recorded_amount10 進数の文字列で表した金額。課金時の換算係数が保存された消費の記録に返されます。
currency金額の通貨。例:USD。

金額の扱い

recorded_amount がない場合、料金をゼロとみなさないでください。currency ごとに分けて合計してください。

関連する照会

この Key の累積使用量と残りの利用枠は、API Key の利用枠を確認するを参照してください。アカウント全体の履歴は BetterToken Workspace で確認できます。