Python SDK で認証する

Roboflow API キーを Python SDK に渡す 3 つの方法 - 環境変数、明示的な引数、または対話型ログイン。

Python SDK は API キーを 3 つの方法で受け付けます。実行環境に合うものを選んでください。どれも最終的には同じ Roboflow オブジェクト。

オプション1: 環境変数（スクリプトやエージェントに推奨）

設定 ROBOFLOW_API_KEY シェルまたは CI 環境で:

export ROBOFLOW_API_KEY=rf_xxxxx

import roboflow

rf = roboflow.Roboflow()  # picks up ROBOFLOW_API_KEY

スクリプト、ノートブック、AI コーディングエージェントに最適な方法です。対話型プロンプトもディスク上の状態もありません。

オプション 2: キーを明示的に渡す

import roboflow

rf = roboflow.Roboflow(api_key="rf_xxxxx")

同じプロセス内で複数のワークスペースに対して複数のキーを使う場合に便利です。

オプション3: 対話形式のログイン

import roboflow

roboflow.login()

認証 URL をブラウザで開き、トークンの入力を求め、資格情報を ~/.config/roboflow/config.json。その後の Roboflow() （引数なしの）呼び出しは、そのファイルから読み取ります。

別のアカウントで再認証するか、トークンを更新するには:

roboflow.login(force=True)

CLI の roboflow login 同じディスク上の場所に書き込むため、どちらかのツールが認証されると、もう一方もその資格情報を読み取ります。

API キーの場所

〜で Roboflow Web アプリ、次へ移動します: 設定 → API キー。各ワークスペースには独自のキーがあります。使用するキーによって、コードが認証されるワークスペースが決まります。

〜については スコープ付き API キー （キーを特定のリソースまたは操作に制限する）については、認証セクションを参照してください。

設定の保存場所を上書きする

資格情報を次の場所以外に保存する必要がある場合は ~/.config/roboflow/、 ROBOFLOW_CONFIG_DIR:

export ROBOFLOW_CONFIG_DIR=/etc/roboflow

参照 環境変数 SDK と CLI が参照する変数の完全な一覧については