API Key で使用量と残高を確認する

MuskAI では、既存の API Key を使って、その Key の使用量と利用可能な残高を確認できます。Profile 専用 Key を別途作成する必要はありません。

この照会はモデルリクエストを発生させず、モデル利用料金もかかりません。プロジェクトごとに API Key を分けると、使用量の集計や問題の調査が簡単になります。

クイック照会

YOUR_API_KEY を MuskAI のユーザー画面で作成した API Key に置き換えてください。

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

API Key を環境変数に保存することもできます。

export MUSKAI_API_KEY="YOUR_API_KEY"

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY"

:::tip API エンドポイント API Key ページに表示される推奨 API アドレスが例と異なる場合は、ユーザー画面のアドレスを使用してください。照会パスは常に /v1/usage です。 :::

レスポンス項目

レスポンスは API Key の課金方式と制限によって異なります。

項目	説明
`mode`	ウォレットまたはサブスクリプションでは `unrestricted`、Key 固有のクォータやレート制限がある場合は `quota_limited`
`balance` / `remaining`	ウォレット残高、サブスクリプション残量、または Key の残量
`quota`	`limit`、`used`、`remaining`、`unit` を含む金額クォータ
`request_quota`	リクエスト回数の上限、使用済み回数、残り回数
`rate_limits`	5 時間、1 日、7 日の制限とリセット時刻
`usage.today`	この Key の本日のリクエスト数、Token 数、費用
`usage.total`	この Key の累計リクエスト数、Token 数、費用
`daily_usage`	指定日数分の日別使用量
`model_stats`	指定した期間のモデル別使用量

ウォレットモードの簡略レスポンス例：

{
  "mode": "unrestricted",
  "isValid": true,
  "balance": 18.52,
  "remaining": 18.52,
  "unit": "USD",
  "usage": {
    "today": {
      "requests": 12,
      "input_tokens": 42000,
      "output_tokens": 3500,
      "actual_cost": 0.42
    },
    "total": {
      "requests": 186,
      "actual_cost": 7.81
    }
  }
}

スクリプトで値を取得する

次の例では jq が必要です。

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY" |
  jq '{
    remaining: (.balance // .remaining // .quota.remaining // .request_quota.remaining),
    unit: (.unit // .quota.unit // .request_quota.unit),
    today: .usage.today,
    total: .usage.total
  }'

残高または残りクォータだけを取得する例：

REMAINING=$(curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY" |
  jq -r '.balance // .remaining // .quota.remaining // .request_quota.remaining')

echo "Remaining: $REMAINING"

日別使用量とモデル別統計

curl -sS \
  "https://api.muskapi.cc/v1/usage?days=30&timezone=Asia%2FShanghai&start_date=2026-07-01&end_date=2026-07-18" \
  -H "Authorization: Bearer $MUSKAI_API_KEY"

パラメータ：

days：daily_usage に返す日数。1～90 日を指定できます。
timezone：日付境界に使用するタイムゾーン。例：Asia/Shanghai。
start_date、end_date：model_stats の期間。形式は YYYY-MM-DD です。

日付を指定しない場合、モデル統計は直近 30 日が対象です。

Web から照会する

コマンドラインを使わない場合は、API Key 使用量照会ページを開き、API Key を貼り付けると、残高、クォータ、日別使用量、モデル別統計を確認できます。

照会範囲

使用量は認証に使った API Key のみが対象です。アカウント内のすべての Key は自動集計されません。
ウォレット残高はユーザーアカウントで共有されるため、同じユーザーのウォレットモード Key には同じ残高が表示されます。
プロジェクト別の使用量が必要な場合は、プロジェクトごとに異なる API Key を使用してください。
クォータを使い切った Key や期限切れ Key でも、自身の使用量を照会できます。無効化、削除、または無効な Key は認証エラーになります。

セキュリティ上の注意

API Key は Authorization ヘッダーだけで送信し、URL パラメータには含めないでください。
完全な API Key をリポジトリ、ログ、スクリーンショット、サポートチケットに記載しないでください。
サーバースクリプトでは環境変数またはシークレット管理サービスを使用してください。
Key の漏えいが疑われる場合は、すぐに無効化または削除し、新しい Key を作成してください。

API Key が送信されていない場合の代表的なエラー：

{
  "code": "API_KEY_REQUIRED",
  "message": "API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"
}

リクエストヘッダーが次の形式になっていることを確認してください。

Authorization: Bearer YOUR_API_KEY

クイック照会​

レスポンス項目​

スクリプトで値を取得する​

日別使用量とモデル別統計​

Web から照会する​

照会範囲​

セキュリティ上の注意​