環境変数

Roboflow CLI と Python SDK が読み取る環境変数。

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

セルフホスト型の Inference サーバー は、別の、はるかに多い変数セットで構成されます。参照: 推論サーバーの環境変数.

ROBOFLOW_API_KEY

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

• CLI - すべてのコマンドは、次の場合にこれをフォールバックとして使用します --api-key / -k が渡されない場合。

• Python SDK - roboflow.Roboflow() （引数なしで）呼び出した場合や、ほとんどのアダプター関数は、明示的なキーが指定されないとこれを読み取ります。

export ROBOFLOW_API_KEY=rf_xxxxx

import roboflow

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

キーは次で見つけられます: Roboflow の Web アプリの「Settings → API Key」.

ROBOFLOW_CONFIG_DIR

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

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。環境変数の方法は、対話型プロンプトもディスク上の状態も不要で、シークレットストアでキーをローテーションするときもきれいに切り替わります。

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