> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/find-your-roboflow-api-key.md).

# Roboflow API キーを見つける

**APIキーは次の場所で確認できます:** [**app.roboflow.com/settings/api**](https://app.roboflow.com/settings/api)

***

APIキーには2種類あります:

* **プライベートAPIキー**: Roboflow API と [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted)
* **パブリック / 公開可能なAPIキー**: 使用先は `inference.js` 、JavaScriptの推論SDKです

APIキーはワークスペース単位で設定されるため、あるワークスペースのプライベートプロジェクトにアクセスするには、そのワークスペースに関連付けられたAPIキーを使用する必要があります。

<figure><img src="/files/191197b881cb108d788b16edf5bf5a697b08485b" alt=""><figcaption></figcaption></figure>

「Generate New Key」をクリックして新しいキーを発行するか、すでに作成済みのキーをコピーしてください。

{% hint style="success" %}
プライベートAPIキーは必ず秘密にしてください。パスワードと同じように扱ってください。このキーを持つ人に、あなたのワークスペースのデータやモデルへのアクセス権が付与されます。
{% endhint %}

誤って、ワークスペースへのアクセス権限がない相手にキーを公開してしまった場合は、「Roll API Key」をクリックしてください。これにより以前のAPIキーは無効化され、新しいキーが作成されます。

### 複数のAPIキー

Enterpriseプランのワークスペースでは複数のAPIキーを作成でき、環境を分離したり、全体の本番ワークフローを中断せずに特定のデプロイや担当者のアクセス権を即座に取り消したりできます。

<figure><img src="/files/88b6b82e77e1b7cc6459b05af52ece190d0164ce" alt=""><figcaption><p>Enterpriseワークスペース向けの複数APIキーオプション</p></figcaption></figure>

さらに、 [スコープ付き API キー](/reference/ja/ren-zheng/authentication/scoped-api-keys.md) をEnterpriseのお客様向けのアドオンとして提供しています。

### デフォルトAPIキー

ワークスペースに複数のキーがある場合でも、コードスニペットや一般的なワークスペース操作（例: モデル評価結果の表示）には、そのうち1つが引き続き使用されます。どのキーを使うかを選ぶには、キーを作成するとき、または既存のキーを編集するときに「このワークスペースのデフォルトAPIキーに設定」にチェックを入れてください。そのキーにはキー一覧で「Default」バッジが表示されます。デフォルトを選択するには、Advanced API Keys機能が必要です。

デフォルトキーには、これらの操作に必要な権限が付与されている必要があります: `workspace:read`, `project:read`, `version:read`, `image:read`、そして `model:infer`。Roboflowがこれらを自動で追加し、キーがデフォルトの間はロックします。チェックを外しても、これらの権限はキーに残りますが、その後で削除できます。フォルダスコープのキーをデフォルトにすることはできません。

どのキーもデフォルトに設定されていない場合、アプリはこれらの権限を持つ、最も古い有効なワークスペースキーを代わりに使用し、そのキーには「In Use」バッジが表示されます。ワークスペースの操作や課金対象の使用がどのキーで実行されているか分かるように、キーを無効化または取り消す前にバッジを確認してください。

必要な権限を持つキーがない場合、キー一覧に警告が表示されます。フルアクセスのキーを作成するか、既存のキーをデフォルトに設定するまで、アプリが代行して実行する操作は失敗します。これには、モデルの実行、Workflowの実行とプレビュー、自動ラベル、モデル評価、データセットのエクスポートが含まれます。

## Roboflow Inferenceでキーを使用する

APIキーを使うと、Roboflowで学習したモデル、Roboflow Universe上の公開モデル、ホスティングされた推論APIにアクセスできます。使用時にキーを渡す方法はいくつかあります [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted).

### 環境変数

推奨方法は `ROBOFLOW_API_KEY` を環境に設定することです。ほとんどのターミナルでは:

```bash
export ROBOFLOW_API_KEY=YOUR_API_KEY
```

そのターミナルセッションで実行したコマンドはすべて、そのキーにアクセスできます。ほかの変数については [環境変数](/reference/ja/environment-variables.md) を参照してください。CLIとSDKが読み取る他の変数が記載されています。

### Python

PythonからInferenceを使用する場合、キーはキーワード引数として渡せます:

```python
from inference import get_model

model = get_model(model_id="...", api_key="YOUR_API_KEY")
```

{% hint style="success" %}
キーが環境に設定されている場合は、引数として渡す必要はありません: `model = get_model(model_id="...")`.
{% endhint %}

### HTTPリクエストのペイロード

サーバーを直接呼び出す場合は、ルートに応じて、キーをURLパラメータとして渡すか、リクエストペイロードの一部として渡してください:

```python
import requests

my_api_key = "YOUR_API_KEY"

url = f"http://localhost:9001/soccer-players-5fuqs/1?api_key={my_api_key}"
response = requests.post(url)

url = "http://localhost:9001/infer/object_detection"
payload = {
    "api_key": my_api_key,
    "model_id": "soccer-players-5fuqs/1",
}
response = requests.post(url, json=payload)
```

### Docker

Inference ServerをDockerコンテナでローカル実行する場合は、 `docker run` コマンドでキーを指定してください:

```bash
docker run -it --rm --network=host -e ROBOFLOW_API_KEY=YOUR_API_KEY roboflow/roboflow-inference-server-cpu:latest
```

そのサーバーに送信されるリクエストでは `api_key` を省略できます。

{% hint style="warning" %}
セルフホスト型サーバーは、デフォルトではAPIキーを必要としません。コンテナ内でキーを設定しても、誰がサーバーを呼び出せるかは制限されません。認証を強制するには、 [セルフホスト型サーバーの保護](https://docs.roboflow.com/deployment/self-hosted/inference-server/configuration/security) を参照してください。
{% endhint %}