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

# FlatKeyコンソールでAPIキーを作成・管理する

> コンソールでFlatkey APIキーを作成、命名、失効させる方法をご説明します。環境ごとに複数のキーを管理し、インテグレーションのセキュリティを維持しましょう。

Flatkey APIキーは、`https://router.flatkey.ai/v1` へのすべてのリクエストを認証します。キーはコンソールの **Keys** セクションで作成・管理します。環境、アプリケーション、またはチームメンバーごとに1つずつ、複数のキーを作成できます。キーが漏洩した場合は、即座に失効させることができます。

## キーの作成

<Steps>
  <Step title="Keysページを開く">
    [console.flatkey.ai](https://console.flatkey.ai) にログインし、左サイドバーの **Keys** をクリックします。
  </Step>

  <Step title="「Create Key」をクリックする">
    キーのわかりやすい名前を入力します。`production-api`、`staging-test`、`john-dev` のような意味のある名前を選んでください。この名前はあなただけに表示されます。
  </Step>

  <Step title="シークレットをコピーして保存する">
    完全なキー（`sk-fk-` で始まる）は **一度だけ** 表示されます。すぐにコピーして、シークレットマネージャー、パスワードマネージャー、または環境変数に保存してください。ダイアログを閉じた後は再取得できません。
  </Step>
</Steps>

<Warning>
  APIキーを紛失した場合は、新しいキーを作成する必要があります。作成後にシークレットを再表示する方法はありません。古いキーは失効させるまで引き続き機能します。
</Warning>

## ベストプラクティス

* **環境ごとに1つのキー**: 開発、ステージング、本番環境ごとに別々のキーを使用します。キーが漏洩しても、そのキーのみを失効させることができ、他の環境に影響しません。
* **わかりやすい名前**: 環境と用途を含めてください（例: `prod-customer-chatbot`、`dev-local`）。
* **環境変数を使用する**: ソースコードにキーをハードコードしないでください。変数名には `FLATKEY_API_KEY` を使用します。
* **定期的にローテーションする**: 特に本番ワークロードでは、定期的にキーを失効させて新しいものに置き換えてください。

## キーの確認

**Keys** ページには、アクティブなすべてのキーが以下の情報とともに一覧表示されます：

* キー名
* 作成日
* 最終使用日時
* マスクされたキープレフィックス（例: `sk-fk-****abcd`）

作成後は完全なキーの値は確認できず、プレフィックスのみ表示されます。

## キーの失効

キーを失効させるには、Keysページでキーの横にある **Delete**（ゴミ箱）アイコンをクリックします。失効は即時に反映されます。そのキーを使用したリクエストはすぐに `401 Unauthorized` レスポンスを受け取ります。ソフトデリートや猶予期間はありません。

<Tip>
  本番環境で使用しているキーを失効させる前に、まず新しいキーをアプリケーションにデプロイしてください。新しいキーが有効になる前に古いキーを失効させると、ダウンタイムが発生します。
</Tip>

## キーの権限

すべてのキーは同じアカウント残高を共有し、デフォルトですべてのモデルにアクセスできます。特定のモデルへのアクセスを制限したり、利用上限を設定したりする必要がある場合は、コンソールの **Groups** を使用してルーティングとアクセスポリシーを適用してください。