Runpodテンプレート内で環境変数を設定する方法

環境変数をRunpodテンプレート内で設定する方法

Hugging Face

Hugging Face APIトークンを取得して使用する手順。

1. Hugging Faceにログインします。
2. プロフィール写真（右上隅）をクリックします。
3. 「アクセス トークン」を選択します。
4. 「新しいトークンの作成」をクリックします。
5. 名前を付けて、読み取りアクセスを割り当てます。
6. トークンを安全に保存し、環境変数で設定します。

あわせて読みたい

HuggingFaceでのトークンの種類と発行方法 HuggingFaceでのトークン発行 https://huggingface.co/settings/tokens 「Write」権限（読み込みだけなら「Read」でも可）のトークンを発行   コピーしておく モデルの…

CivitAI

CivitAIからダウンロードAPI用APIトークンを取得して使用する手順。

1. CivitAIにログインします。
2. 「アカウント管理」ページに移動します。
3. 下部近くにある「API キー」セクションまでスクロールします。
4. 新しいキーを作成するには、「+ API キーを追加」ボタンをクリックします。
5. API キーに名前を付けて、「保存」をクリックします。
6. この API キーを環境変数に設定して、このテンプレートで使用します。

環境変数を設定する

テンプレートをデプロイする前に、[テンプレートの編集]ボタンを使用して環境変数を更新します。

例① Hugging Face トークンを設定する場合

• Key: HF_TOKEN
• Value: hf_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
    Hugging Faceのアクセストークンそのものを記入。

例② パスを指定する場合

• Key: MODEL_PATH
• Value: /content/ComfyUI/models/checkpoints/
   その環境内でモデルを保存するパスを指定。

例③ APIキーを設定する場合

• Key: OPENAI_API_KEY
• Value: sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXX

ポイント

• Value欄には、秘密情報や実際の値を入れる
  （空欄だとその環境変数は無効になる）
• Keyはプログラム側で参照される名前
  → スクリプトで os.environ["HF_TOKEN"] のように使われる。

テンプレートのデプロイ

1. [デプロイ] をクリックします。

1. セットアップが完了するまで待ちます。
   ※初期セットアップには、ネットワーク速度や選択したモデルによって通常 5～30 分かかります。
2. 初期セットアップ完了後は、ネットワークボリュームから展開することで、将来のデプロイが高速になります。

よく使う環境変数（Flux / ComfyUI系テンプレート）

• HF_TOKEN
  Hugging Face からモデルを自動DLしたい場合に必須。
  Value：自分の Hugging Face アクセストークン
• PUBLIC_KEY
  Pod に SSH で入る場合に設定（普段 ComfyUIだけ使うなら不要）。
  Value：自分の id_rsa.pub などの公開鍵文字列
• VENV_PATH
  Python仮想環境のパス。テンプレート側で自動的に設定されていることが多いので 触らなくても大丈夫。
  Value例：/workspace/venv
• MODEL_PATH（あれば）
  ComfyUI のチェックポイントや LoRA を保存するパス。
  Value例：/workspace/ComfyUI/models/checkpoints/
• その他 (WANDB_API_KEY など)
  学習やログ連携をする時だけ設定。