エンドポイント

残高とキー情報

GET /credits と GET /key で USD 残高、累計利用額、呼び出したキーのレート制限を取得します。レスポンスの各フィールド、残高が 0 ドルになったときの 402 エラーも説明します。金額はすべて米ドルで返ります。残高の自動確認にも使えます。

アカウントの USD 残高、累計利用額、呼び出したキーのレート制限を取得します。/credits と、その短い別名である /key の 2 つのパスは同じ本文を返します。

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

金額はすべて米ドルです。

リクエスト

パラメーターはありません。API キーで認証します。

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

レスポンス

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

フィールド	説明
`total_credits`	アカウントに追加された USD の累計。チャージ、サブスクリプションに含まれる利用量、ボーナス、プロモーションコードを含みます。
`total_usage`	リクエストで使用した USD の累計。
`balance_usd`	現在利用可能な USD 残高。
`key_id`	このリクエストに使用した API キーの ID。
`rate_limit.requests`	キー独自の毎分リクエスト数の上限。キーがプランの上限を使う場合は `null`。
`rate_limit.interval`	常に `1m`。

払い戻しや手動調整のため、total_credits - total_usage は balance_usd とわずかに異なる場合があります。正式な値は balance_usd です。

例: 使い切る前に停止する

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

残高が $0 になったとき

請求設定で自動チャージを有効にしていない限り、残高を追加するまで有料リクエストは 402 insufficient_balance を返します。/credits、/key、/models の読み取りは引き続き動作します。料金と請求を参照してください。

エラー

ステータス	コード	発生条件
401	`invalid_api_key`	キーがない、または無効。

エラーを参照してください。