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 と課金方式によって異なります。 |
type | 2 は消費の記録を示します。 |
quota | 記録された利用枠の値。内部の利用枠単位です。 |
recorded_amount | 10 進数の文字列で表した金額。課金時の換算係数が保存された消費の記録に返されます。 |
currency | 金額の通貨。例:USD。 |
金額の扱い
recorded_amount がない場合、料金をゼロとみなさないでください。currency ごとに分けて合計してください。
関連する照会
この Key の累積使用量と残りの利用枠は、API Key の利用枠を確認するを参照してください。アカウント全体の履歴は BetterToken Workspace で確認できます。

