> 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 キーを見つける

Roboflow API と Roboflow Inference で認証するための API キーを見つける

APIキーは次の場所にあります： [app.roboflow.com/settings/api](https://app.roboflow.com/settings/api)の Settings（設定）にある「API Keys」です。

キーには2種類あります。

* プライベートAPIキー：次のサービスで使用する認証情報です。 [REST API](https://docs.roboflow.com/reference/ja/platform/rest-api.md), [Python SDK](https://docs.roboflow.com/reference/ja/platform/python-sdk.md), [CLI](https://docs.roboflow.com/reference/ja/platform/cli.md) および [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted)で使用します。パスワードと同じように扱ってください。ワークスペースのデータやモデルへのアクセスを許可します。
* 公開可能キー：ブラウザーやエッジコード（ `rf_<workspaceId>` 形式のシークレットではないキーです。たとえば `inference.js`などで使用します。推論の実行とモデルのダウンロードのみが可能です。詳しくは [公開可能キー](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/manage-api-keys.md#the-publishable-key).

キーはワークスペースに属します。ワークスペースのプライベートプロジェクトにアクセスするには、そのワークスペースのキーを使用してください。

<figure><img src="https://1568109427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-ee9c711746c549f84e164db9d4d68158b4a01050%2Fimage-a4b3fa.png?alt=media" alt=""><figcaption></figcaption></figure>

「Generate New Key」をクリックしてキーを作成するか、既存のキーをコピーします。キーの命名、ローテーション、保護、取り消しについては、 [ダッシュボードでのAPIキーの管理](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/manage-api-keys-in-the-dashboard.md)をご覧ください。キーが漏えいした場合は、 [APIキーのローテーション](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/rotate-api-keys.md).

## 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
```

そのターミナルセッションで実行するコマンドから、キーにアクセスできるようになります。CLIとSDKが読み取るその他の変数については、 [環境変数](https://docs.roboflow.com/reference/ja/environment-variables.md) をご覧ください。

### 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リクエスト

サーバーを直接呼び出す場合は、キーを `Authorization: Bearer` ヘッダーとして送信します。このヘッダーを使うと、キーがURL、アクセスログ、ブラウザーの履歴に残らず、すべてのルートで同じ方法を使えます。

```python
import requests

my_api_key = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {my_api_key}"}

url = "http://localhost:9001/soccer-players-5fuqs/1"
response = requests.post(url, headers=headers)

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

セルフホストサーバーは、Inference 1.5.0以降でこのヘッダーを読み取ります。ホスト型APIでも受け付けます。

キーをURLパラメーター（`?api_key=...`）または `api_key` フィールドとしてリクエストのペイロードに渡す方法は、従来の方式です。すべてのサーバーバージョンで引き続き動作しますが、新しいコードでは推奨されません。

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

複数の方法でキーを指定した場合、クエリパラメーターがヘッダーより優先され、ヘッダーが本文のフィールドより優先されます。

Python SDKを使用する場合は、自分でヘッダーを作成するのではなく、クライアントでトランスポートを一度設定します。詳しくは [APIキーの受け渡し方法](https://docs.roboflow.com/reference/ja/inference/inference-sdk/configuration.md#api-key-transport).

### 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 %}
