> 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/environment-variables.md).

# 環境変数

Roboflow の CLI と Python SDK は、少数の環境変数を読み取ります。シェルや CI 環境でそれらを設定しておけば、毎回のコマンドで認証情報や設定を渡す必要がなくなります。

{% hint style="info" %}
セルフホスト型の [Inference サーバー](https://docs.roboflow.com/deployment/self-hosted/self-hosted) は、別の、はるかに多い変数セットで構成されます。参照: [推論サーバーの環境変数](https://docs.roboflow.com/deployment/self-hosted/inference-server/configuration/environment-variables).
{% endhint %}

## `ROBOFLOW_API_KEY`

あなたの Roboflow API キー。次で使用されます:

* **CLI** - すべてのコマンドは、次の場合にこれをフォールバックとして使用します `--api-key` / `-k` が渡されない場合。
* **Python SDK** - `roboflow.Roboflow()` （引数なしで）呼び出した場合や、ほとんどのアダプター関数は、明示的なキーが指定されないとこれを読み取ります。

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

```python
import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY を自動的に取得します
```

キーは次で見つけられます: [Roboflow の Web アプリの「Settings → API Key」](https://app.roboflow.com/settings/api).

## `ROBOFLOW_CONFIG_DIR`

CLI が認証情報と設定されたデフォルトのワークスペースを保存する場所を上書きします。既定値: `~/.config/roboflow/`.

```bash
export ROBOFLOW_CONFIG_DIR=/etc/roboflow
roboflow login
# 認証情報は /etc/roboflow/config.json に保存されます
```

CI、コンテナビルド、または同じマシンで複数の Roboflow アカウントを並行して実行する場合に便利です。

## `API_URL`

SDK と CLI が REST API リクエストを送信するベース URL を上書きします。既定値: `https://api.roboflow.com`.

これを設定する必要はありません。これは、Roboflow 内部でプレプロダクション環境に対するテストを行うために存在します。

## `DEDICATED_DEPLOYMENT_URL`

dedicated-deployments サービスのベース URL を上書きします。既定値: `https://roboflow.cloud`.

これを設定する必要はありません。これは、Roboflow 内部でプレプロダクション環境に対するテストを行うために存在します。

## 優先順位

同じ値を複数の方法で指定できる場合、優先順位は次の順です（高い順）:

1. **明示的なフラグ** - 例: `--api-key` CLI コマンドで、または `api_key` Python 関数の引数として。
2. **環境変数** - 例: `ROBOFLOW_API_KEY`.
3. **ディスク上の設定** - 例: `~/.config/roboflow/config.json` CLI が保存した認証情報に対して。
4. **組み込みのデフォルト** - 次のような機密でない値のみ: `API_URL`.

## CI / エージェント向けの推奨

CI や AI エージェントの文脈では、次を優先してください: `ROBOFLOW_API_KEY` よりも `roboflow login`。環境変数の方法は、対話型プロンプトもディスク上の状態も不要で、シークレットストアでキーをローテーションするときもきれいに切り替わります。

```yaml
# GitHub Actions の例
env:
  ROBOFLOW_API_KEY: ${{ secrets.ROBOFLOW_API_KEY }}
```