---
title: APIキー
description: 個人用Runner APIキーを安全に生成、コピー、識別、および取り消します。
---

APIキーは、プログラムによるRunner アクセスのための個人的なシークレットです。信頼できるアプリケーションに対してのみ1つを作成し、安全に保存し、不要になったら取り消します。

## このガイドの内容

ワンタイム シークレットを作成して保存する方法、既存のキーを公開せずに識別する方法、確認付きでキーを取り消す方法を理解します。

## 利用可能性と前提条件

- **APIキー** は条件付きであり、アカウントで有効になっている場合にのみ表示されます。
- キーは1つのストアではなく、個人アカウントに属します。
- 完全なキーをチャット、エージェント メモリ、スキル、スクリーンショット、ソース管理、または製品ドキュメントに入れないでください。

## エントリパス

**アバター → 設定 → 個人 → APIキー** を選択します。エントリが見つからない場合、機能は現在のアカウントで利用できません。

## コントロール

| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **新しいキーを生成** | 新しい認証情報を作成します。 | ダイアログが開き、オプションの名前フィールドが表示されます。 |
| **名前** | シークレットを公開せずに後でアプリケーションを識別します。 | 名前がキー テーブルに表示されます。空白の場合は無題のキーが作成されます。 |
| **キーを作成** | 認証情報を生成します。 | Runnerが **APIキーが生成されました** を開き、完全なシークレットを1回表示します。 |
| 目のアイコン | 保存する前に、新しく生成された完全な値を確認します。 | ワンタイム値は成功ダイアログで表示またはマスクされます。 |
| コピー アイコン | 新しいキーを正確にコピーします。 | Runnerはそれをクリップボードにコピーし、確認を表示します。 |
| **保存しました** | ワンタイム シークレット ビューを閉じます。 | 完全な値がダイアログから削除され、そこに再度表示することはできません。 |
| 既存キー テーブル | キーを安全に識別します。 | Runnerは名前、プレフィックス、作成日、最後に使用した日を表示し、完全なシークレットは表示しません。 |
| 削除アイコン | 既存のキーを取り消します。 | 確認により、取り消しは元に戻せないことが説明されます。 |
| **取り消す** | 選択したキーを無効にします。 | 成功後、キーはリストから削除され、認証に使用できなくなります。 |

## キーを生成して保存

1. **個人 → APIキー** を開きます。
2. **新しいキーを生成** を選択します。
3. アプリケーションまたは環境など、説明的な名前を入力します。シークレットを名前に入れないでください。
4. **キーを作成** を選択します。
5. **APIキーが生成されました** で、必要な場合のみキーを公開し、コピーを選択します。
6. 信頼できるシークレット マネージャーに保存します。
7. **保存しました** を選択する前に、保存された値を確認します。
8. テーブル プレフィックスを使用して、完全な値を公開せずに後でキーを識別します。

Runnerは、完全なキーが再度表示されないことを警告します。ダイアログを保存せずに閉じた場合は、そのキーを取り消し、シークレットを回復しようとするのではなく、置き換えを作成してください。

## キーを取り消す

1. 名前とプレフィックスで目的のキーを照合します。
2. その削除アイコンを選択します。
3. **取り消す** 確認を確認します。
4. 依存するアプリケーションが使用を停止する準備ができている場合にのみ、**取り消す** を選択します。
5. **APIキーが取り消されました** を確認し、アプリケーションから古いシークレットを削除します。

取り消しは破壊的であり、元に戻すことはできません。アクセスが再度必要な場合は、新しいキーを作成します。

## 状態と制限

- **APIキーはまだありません** は通常の空の状態です。
- 新しいキーの完全な値は、成功ダイアログにのみ表示されます。
- 既存の行は、回復可能なキーではなく、プレフィックスと使用日を表示します。
- **最後に使用した** の下の **なし** は、Runnerがそのキーのリクエストを記録していないことを意味します。
- 作成ボタンと取り消しボタンは進行状況を表示し、繰り返し送信しないでください。

## トラブルシューティング

- APIキーが見つからない場合は、コピーされた直接リンクを使用しないでください。機能はこのアカウントで無効になっています。
- クリップボード コピーが失敗した場合は、新しい値を公開し、安全なシークレット マネージャーに手動でコピーしてから、再度非表示にします。
- 完全なキーを失った場合は、その行を取り消し、置き換えを生成します。
- 取り消し後にアプリケーションが機能しなくなった場合は、新しく作成されたキーで更新してください。古いキーは復元できません。
- 間違ったキーが選択された場合は、確認をキャンセルし、名前とプレフィックスを再度比較してください。

## 関連ガイド

- [セキュリティとセッション](./security-and-sessions)
- [個人設定とワークスペース](./personal-settings-and-workspaces)
- [メモリ安全性](../agent/memory)