AI API 使用量追跡:ヘッダーで支出を監視
すべてのレスポンスに残高が表示されるため、約 50 行で AI API の使用量追跡ツールを構築できます。このガイドでは、リクエストごとのコストのログ記録、残高エンドポイントの読み取り、クレジットが尽きる前のアラート設定の方法を示します。


主要ポイント
- すべてのレスポンスには、残りのクレジットを示す X-Balance-USD ヘッダーが含まれます。
- GET /v1/balance と credit_grants エンドポイントは、必要に応じて残高を返します。
- 1 回あたりのコストは(入力 x 0.15 + 出力 x 0.50)/ 1,000,000 ドルです。
- CSV にログを記録し、残高が閾値を下回った場合にアラートを発生させます。
数値の由来
前払いクレジットは、プロバイダーが累積合計をすでに管理しているため、コスト追跡が簡単になります。次の 3 か所で取得できます。
- API 呼び出し時の
X-Balance-USDレスポンスヘッダー。リクエスト後の残高が表示されます。 GET /v1/balanceは、単純な残高照会です。GET /v1/dashboard/billing/credit_grantsは、ダッシュボードやラッパーなどのツールがすでに呼び出し方を知っている OpenAI 互換のエンドポイントです。
それらに加え、各 completion にはプロンプトと completion のトークン数を含む usage オブジェクトが返されます。トークン数を価格(入力 1M トークンあたり $0.15、出力 1M トークンあたり $0.50)と組み合わせて、任意のリクエストのコストを自分で計算し、残高の減少と比較できます。両者は一致すべきです。一致しない場合は、調査すべき点が見つかったことになります。詳細なパラメータ情報は docs にあります。
1 つのリクエストでヘッダーを読み取る
curl では、-i を追加してヘッダーを確認します。
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
Python では、OpenAI SDK は with_raw_response を通じて生レスポンスを公開し、ヘッダーと解析済みオブジェクトの両方を取得できます。
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)すべての呼び出しを記録する小さなロガー
呼び出しを 1 つの関数でラップし、そのたびに CSV 行を書き込みます。行には、時刻、リクエスト ID、トークン数、計算されたコスト、残高が含まれます。
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
tag 引数がログを有用にする鍵です。"summaries" や "chat" などの機能名を渡すと、後でタグごとにコストを合計して、製品のどの部分にお金が使われているかを確認できます。リクエスト ID は、請求について問い合わせる必要がある場合や問題を報告する際に、正確な呼び出しを識別するため役立ちます。
計算の妥当性確認
入力トークン 2,400、出力トークン 600 の呼び出しを考えます。
- 入力: 2,400 x 0.15 / 1,000,000 = $0.00036
- 出力: 600 x 0.50 / 1,000,000 = $0.00030
- 合計: $0.00066
それら 1,000 回の呼び出しで $0.66 かかります。CSV で残高が計算されたコストの合計よりも大幅に減少している場合は、ログに残されていないリトライ、同じキーを使用するバックグラウンドジョブ、または開いたままにしているストリームを確認してください。失敗または拒否されたリクエストには課金されないため、エラーは残高に影響すべきではありません。小さな丸め誤差を平均化するため、1 回だけでなく多くの呼び出しの合計を比較してください。
ストリーミング呼び出しと使用状況
stream: true を使用すると、使用量データはストリームの最後に届きます。最終チャンクから収集し、ストリームが閉じた後にログに記録してください。
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
残高のみが必要な場合は、ストリーム終了後に GET /v1/balance を呼び出してください。これは軽量なリクエストであり、cron ジョブからの定期的なチェックとしても機能します。
機能別の支出合計
CSV は読み込まなければ意味がありません。この短いスクリプトはタグごとにコストを合計し、追加パッケージなしで最新の残高を表示します。
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
毎日実行し、出力をチームチャネルに貼り付けてください。目立たなかった支出が議論可能な数値になり、他の機能の 10 倍のコストがかかる機能が一目で浮き彫りになります。大まかな予算のためには、日次の合計に 30 を掛け、20 パーセントの余裕を加算してください。
低残高アラートの追加
日中のクレジット切れは製品をオフラインにするため、早めにアラートを出してください。15 分ごとに実行される cron ジョブで十分です。
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
解析コードを書く前に、生 JSON を 1 回出力して確認してください。実際のフィールド名を確認するには 10 秒かかり、記事から推測するとアラートが静かに失敗する可能性があります。少なくとも通常の日次支出をカバーする閾値を選択してください。CSV が示します:昨日のコストを合計し、それを最小値として使用してください。
アラートが発生したら、チャージしてください。$20 から $500 の任意の整数金額が有効で、$50 で +5%、$100 で +10%、$200 で +15% のクレジットが追加され、クレジットは期限切れになりません。トラッカー用のキーをまず取得するには、API キーページ を使用してください。
支出を予測可能にする習慣
- 環境ごとに 1 つのキーを使用し、テストトラフィックが本番の数字に隠れないようにしてください。
- 長文の回答が不要なエンドポイントで
max_tokensに上限を設定してください。デフォルトではオプションのため、無制限の回答が可能です。 - チャット履歴を削減してください。入力トークンは出力より安価ですが、長い履歴が毎ターン繰り返されると累積します。
- タグごとの週次合計を確認し、請求額の半分を超えるタグを探してください。
もう 1 つの習慣:ログに記録された各行にリクエスト ID を保存してください。1 か月後に数値がおかしい場合、平均値で議論するのではなく、特定の呼び出しに一致させることができます。失敗したリクエストには課金されないため、エラーのリトライにはコストが加算されませんが、成功した応答後のリトライには加算されるため、リトライロジックが実際の失敗でのみ発生することを確認してください。成功したリクエストをループで再送信するバグは、トークン課金 API で請求書が予想外に高額になる最も一般的な原因です。
その他のガイド
質問と回答
残高ヘッダーはすべてのレスポンスに表示されますか?
X-Balance-USD ヘッダーは、この API のレスポンスヘッダーに含まれています。生レスポンスから読み取り、値がない場合は不明として扱ってください。
リクエストごとにログを残さずにコストを取得できますか?
はい。スケジュールに従って GET /v1/balance をポーリングし、読み取り値の差を計算してください。
失敗したリクエストは残高に影響しますか?
いいえ。失敗または拒否されたリクエストは課金されません。
既存のOpenAIダッシュボードツールはどのエンドポイントを使用すべきですか?
多くのツールがすでにサポートしているOpenAIスタイルのGET /v1/dashboard/billing/credit_grantsルートを使用してください。