> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capriole.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Capriole AI で API キーを管理し、使用量を追跡する

> Capriole AI API キーの作成、命名、無効化、削除を行い、リクエストをフィルタして、キャッシュ、課金、残りのトークンを理解します。

Capriole AI の API ページは、キー管理と使用量の会計を 1 か所にまとめています。名前付きキーの作成、無効化または削除、時間・キー・モデル・ステータスによるリクエストのフィルタ、生のトークン使用量と残高から差し引かれる課金トークンの比較ができます。

API アクセスには、有効な Premium メンバーシップまたは対象となる Team アクセスが必要です。個人 Premium は月額 USD 8 で、対応する Premium モデル群の無制限 Browser Chat に加え、500 万の課金 API トークンを含みます。そのため、同じアカウントで日常チャット、アプリケーション コード、コーディング エージェントを、別々のプロバイダー キーや請求ページなしでカバーできます。

## 名前付き API キーを作成する

<Steps>
  <Step title="API ページを開く">
    [Capriole AI API](https://capriole.ai?view=api) を開き、サインインします。API アクセスのあるアカウントでは、**API keys**、**Playground**、**Usage** が表示されます。
  </Step>

  <Step title="キーを作成して名前を付ける">
    **Create key** を選びます。**Name (Optional)** フィールドで、`local-codex`、`support-agent`、`test-script` のように、使うクライアントを識別できます。

    長期間使うクライアントや Team メンバーには、別々の名前付きキーを使ってください。リクエストの帰属が分かりやすくなり、すべての資格情報を置き換えずに 1 つのクライアントだけを取り消せます。
  </Step>

  <Step title="シークレットをすぐにコピーする">
    **Create** を選び、**Secret key** ダイアログから値をコピーしてください。Capriole は作成直後にだけ完全なシークレットを表示します。キー一覧では、後からマスクされた値が表示されます。

    <Warning>
      シークレットをソース管理、スクリーンショット、サポート メッセージ、クライアント側アプリケーション コードに置かないでください。完全な値を失った場合は、代わりのキーを作成してください。
    </Warning>
  </Step>

  <Step title="テスト リクエストを 1 回送る">
    [API クイックスタート](/ja/quickstart) または [OpenAI と Anthropic の SDK ガイド](/ja/guides/openai-anthropic-sdks) に従ってください。リクエスト完了後に **Usage** に戻ります。

    モデル応答も有用ですが、使用量の行のほうがより強い確認です。想定したキーとモデルで Capriole がリクエストを受け取ったことが分かります。
  </Step>
</Steps>

## 現在の残高を読む

**Usage** セクションは、現在の included クォータと購入したオンデマンド トークンを分けて表示します。

| 要約                  | 意味                                              |
| ------------------- | ----------------------------------------------- |
| **Included usage**  | 現在のメンバーシップ クォータ、請求サイクル、使用済みトークン、残りの割合           |
| **On-demand usage** | 購入したトップアップ トークン、使用量、残りの残高                       |
| **Total requests**  | 選択した使用量フィルタ内の成功リクエストと失敗リクエスト                    |
| **Charged tokens**  | フィルタした成功使用量で差し引かれたクォータ。合計トークンとキャッシュ トークンもあわせて表示 |

**Time** フィルタはリクエスト分析と行を変えます。請求サイクルは変わらず、選択した期間向けにクォータ要約を再計算することもありません。

キャッシュ入力の計算式と丸め規則は、[Capriole AI の課金トークンの説明](/ja/articles/charged-tokens) を読んでください。

## リクエスト履歴をフィルタする

フィルタは、一度に 1 つの質問に答えるために使ってください。

| フィルタ       | 選べる値                                      | 向いている用途                   |
| ---------- | ----------------------------------------- | ------------------------- |
| **Time**   | Last 24 hours、7 days、30 days、または all time | デプロイや直近のテストを切り出す          |
| **Key**    | すべてのキー、または 1 つの名前付きキー                     | どのクライアントがトラフィックを送ったかを確認する |
| **Model**  | 表示中の使用量履歴に含まれるモデル                         | モデル ルート間のトラフィックを比較する      |
| **Status** | All status、success、または error              | 完了した呼び出しと失敗を分ける           |
| **Member** | owner と admin 向けの Team メンバー               | 人ごとに Team トラフィックを確認する     |

各リクエスト行には、時刻、キー、モデル、入力トークン、キャッシュ トークン、出力トークン、課金トークン、合計トークン、レイテンシ、ステータス、エラー メッセージが表示されることがあります。上流応答または失敗リクエストが提供しない指標は、利用できない場合があります。

## クライアントが意図したキーを使ったことを確認する

テスト リクエストを送ったあと:

1. **Time** を **Last 24 hours** に設定します。
2. クライアントが使った名前付き **Key** を選びます。
3. 複数モデルがある場合は、想定する **Model** を選びます。
4. **Status** を **Success** に設定します。
5. 新しい行の時刻とトークン活動が想定どおりであることを確認します。

この確認は、よくあるセットアップミスを見つけます。コーディング ツールは、Capriole 設定が有効でなくても、組み込みまたはフォールバック プロバイダー経由で応答を出せます。一致する Capriole 使用量行があれば、その曖昧さはなくなります。

## キーを無効化、再有効化、または削除する

| 操作         | 結果                         | 元に戻せますか？        |
| ---------- | -------------------------- | --------------- |
| Deactivate | そのキーを使う新しいリクエストは認証されなくなります | はい。キーを再びオンにできます |
| Reactivate | 既存のキーで再び認証できます             | はい              |
| Delete     | キーは完全に削除されます               | いいえ             |

クライアントを調査しているとき、またはトラフィックを一時停止するときは無効化を使ってください。置き換えたあと、または資格情報が露出した可能性があるときは、キーを削除してください。

一覧の **Created** と **Last used** は、使われていないキーの特定に役立ちます。表示ステータスが **Inactive** の場合、再有効化するまでキーは取り消されています。

## Team の可視性

Team の owner と admin は、メンバーごとに使用量をフィルタし、リクエストまたは課金トークンをメンバー間で比較できます。通常の Team メンバーは、そのメンバーに許可された使用量だけを見ます。Team のトップアップと Team 全体の制御も、対象となる Team ロールに限定されます。

使用量フィルタは、Capriole の内部プロバイダー ルート、上流コスト、フォールバック診断は公開しません。API アクセス管理に必要な、顧客向けモデル、リクエスト結果、トークン会計を報告します。

## ここから続ける

初期の互換性テストには [1 つのキーでコーディング エージェントを使う](/ja/guides/one-api-key-coding-agents) を使うか、クライアント固有の設定には維持されている [統合ガイド](/ja/integrations/codex) を開いてください。[日付付き API コスト比較](/ja/articles/ai-api-cost-comparison) は、Capriole のクォータ単位がプロバイダーの入力・出力価格とどう違うかを説明します。

[制限付きの無料 Browser Chat で GPT-5.6 Thinking、Claude Fable 5、または Gemini 3.1 Pro を試す](https://capriole.ai)。キーを作成し、含まれる月次 API 残高を使うときは Premium にアップグレードしてください。

**事実確認日：** 2026-08-10。