/setup-fal

description: "Lesson command"
duration: "約10分"
prerequisites: ["ブラウザが使える", "GitHub または Google アカウントを持っている"]
level: "beginner"
tags: ["setup", "fal", "api", "video", "image"]
nonInteractiveMode: incompatible

fal.ai API セットアップ

Step 0: セットアップ進捗の確認

**AIが自動実行する内容:** 1. `uv run python tools/setup_progress.py show --current setup-fal` を実行して進捗を表示 2. 既存のAPIキーを自動検出:

• `uv run python tools/credential_manager.py status` を実行
• FAL_KEY が設定済みの場合、Step 4（テスト）のみ実行して完了にできる
• `.env` に平文で存在する場合、credential store への移行を提案

このセッションでやること

| 項目 | 内容 | |------|------| | ゴール | fal.ai でAPIキーを取得し、Credential Store に保存して動画・画像生成などのAI機能を使えるようにする | | 所要時間 | 約10分 | | 前提条件 | GitHub または Google アカウントを持っていること、ブラウザが使えること | | 操作レベル | 基本はAI自動実行（APIキー保存時のみ、別ターミナルで手動1コマンド） |

**fal.ai とは:** 動画生成(Kling, Veo等)、画像生成、リップシンク(Fabric)、音楽生成(Suno)などのAIエンジンを統合的に利用できるプラットフォームです。1つのAPIキーで複数のAIモデルにアクセスできます。

**このセッションの流れ:** 1. ブラウザで fal.ai を開く（AIが自動でブラウザを起動） 2. アカウントを作成してAPIキーを取得する（画面上のボタンをクリックするだけ） 3. APIキーを Credential Store に安全に保存する（別ターミナルでコマンド実行） 4. 動作テスト（AIが自動実行）

> **ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。

---

準備チェック

**AskQuestionの設定:**

{
  "title": "セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "chrome", "label": "/chrome でブラウザ操作を自動化する"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (chrome → Step 1 でブラウザを開いた後、「Chrome 統合で自動化する場合」セクションの手順で自動実行する) (check_prereq → 「GitHubアカウントまたはGoogleアカウントがあればサインアップできます。ブラウザでログインできれば準備OKです」と案内) (different_lesson → モジュール一覧を表示)

---

Step 1: ブラウザで fal.ai を開いてアカウントを作成する

**AIが実行すること:** 1. OSを自動判定する（Mac / Windows / Linux） 2. 以下のコマンドを実行してブラウザを自動起動する:

# Mac:
open https://fal.ai
# Windows:
start https://fal.ai
# Linux:
xdg-open https://fal.ai

**ブラウザが開いたら、以下のAskQuestionを表示:**

{
  "title": "Step 1: fal.ai アカウントの作成",
  "questions": [{
    "id": "account_status",
    "prompt": "ブラウザが開きましたか？以下の手順でアカウントを作成してください:\n\n1. 右上の「Sign Up」または「Login」をクリック\n2. GitHub または Google アカウントで認証する\n3. ダッシュボードが表示されたら完了\n\nアカウントにログインできましたか？",
    "options": [
      {"id": "logged_in", "label": "ログインできました！"},
      {"id": "browser_not_open", "label": "ブラウザが開かない"},
      {"id": "signup_issue", "label": "サインアップできない"},
      {"id": "already_have_account", "label": "既にアカウントを持っている"}
    ]
  }]
}

(logged_in → Step 2へ) (browser_not_open → 「ブラウザで直接このURLを開いてください: https://fal.ai」と案内) (signup_issue → 「GitHubアカウントでの認証をお試しください。それでもうまくいかない場合は、Googleアカウントでの認証を試してみてください」と案内) (already_have_account → Step 2へ)

---

Chrome 統合で自動化する場合（`/chrome` モード）

**前提条件:** Chrome に「Claude in Chrome」拡張機能（v1.0.36+）がインストール済みで、`claude --chrome` で起動しているか、セッション内で `/chrome` を実行済みであること。

**AIが Chrome 統合で自動実行する内容:** 1. ブラウザで https://fal.ai を開く 2. Chrome 統合を使って以下の操作を順番に実行する:

• 「Sign Up」または「Login」ボタンをクリック
• GitHub または Google アカウントで認証（ユーザーの操作を待つ）
• ログイン後、https://fal.ai/dashboard/keys に移動
• 「Create Key」または「Add Key」ボタンをクリック

3. APIキーが表示されたことを確認したら、ユーザーに「APIキーをコピーしてください」と案内する 4. Step 3 に進む

**注意:** APIキーの値はブラウザ画面から読み取らないこと。ユーザーが手動でコピーする。

Chrome 統合が利用できない場合は、以下の手順を手動で実行してください。

---

Step 2: APIキーを取得する

**AIが実行すること:** 1. APIキー管理ページをブラウザで開く:

# Mac:
open https://fal.ai/dashboard/keys
# Windows:
start https://fal.ai/dashboard/keys
# Linux:
xdg-open https://fal.ai/dashboard/keys

**ブラウザが開いたら、以下のAskQuestionを表示:**

{
  "title": "Step 2: APIキーの取得",
  "questions": [{
    "id": "key_status",
    "prompt": "APIキー管理ページが開きましたか？以下の手順でAPIキーを取得してください:\n\n1. 「Create Key」または「Add Key」ボタンをクリック\n2. 表示されたAPIキーをコピーする\n   （キーは一度しか表示されない場合があります。必ずコピーしてください）\n\nAPIキーをコピーできましたか？",
    "options": [
      {"id": "copied", "label": "APIキーをコピーしました！"},
      {"id": "page_not_found", "label": "キー管理ページが見つからない"},
      {"id": "no_create_button", "label": "「Create Key」ボタンが見つからない"},
      {"id": "key_already_exists", "label": "既存のキーがある"}
    ]
  }]
}

(copied → Step 3へ) (page_not_found → 「ブラウザで直接このURLを開いてください: https://fal.ai/dashboard/keys ログイン済みであることを確認してください」と案内) (no_create_button → 「ページが完全に読み込まれるまで待ってください。ダッシュボード左側のメニューから「Keys」や「API Keys」を探してみてください」と案内) (key_already_exists → 「既存のキーを使うこともできます。キーの値をコピーできればStep 3に進めます。新しいキーを作成しても構いません」と案内してStep 3へ)

---

Step 3: APIキーを安全に保存する

**セキュリティに関する重要な注意:** APIキーはこのチャットに貼り付けないでください。別のターミナルウィンドウで安全に保存します。

**AIが自動で実行すること:** 1. `keyring` パッケージがインストール済みか確認する

• 未インストールの場合: `uv add keyring` を自動実行する

2. `uv run python tools/credential_manager.py status` を実行して現在の状態を確認する

**ユーザーに案内するメッセージ:**

APIキーをコピーしたら、以下の手順で安全に保存してください:

┌─────────────────────────────────────────────────────────────┐
│ 別のターミナルウィンドウで以下のコマンドを実行してください: │
│                                                             │
│ Cursor: Ctrl+` (バッククォート) で新しいターミナルを開く    │
│ Claude Code: 別のターミナルウィンドウを開く                 │
│                                                             │
│ uv run python tools/credential_manager.py store FAL_KEY            │
│                                                             │
│ → 「Enter value for FAL_KEY:」と表示されます               │
│ → コピーしたAPIキーを貼り付けてEnterを押してください        │
│   （入力した文字は画面に表示されません。これは正常です）    │
│ → 「✅ Stored FAL_KEY」と表示されたら保存完了です           │
└─────────────────────────────────────────────────────────────┘

保存が完了したら、こちらのチャットに戻って「完了」と教えてください。

**なぜ別ウィンドウで実行するのか:** AIのチャットでAPIキーを扱うと、会話ログに値が残ってしまいます。 別ウィンドウで `credential_manager.py` を実行すれば、キーの値はOSの 暗号化ストレージ（macOS Keychain / Windows Credential Locker / Linux SecretService）に 直接保存され、平文ファイルやチャットログに一切残りません。

**AskQuestionの設定:**

{
  "title": "Step 3: APIキーの保存",
  "questions": [{
    "id": "store_status",
    "prompt": "別のターミナルでコマンドを実行できましたか？",
    "options": [
      {"id": "done", "label": "保存しました！"},
      {"id": "terminal_help", "label": "ターミナルの開き方がわからない"},
      {"id": "command_error", "label": "コマンドでエラーが出た"},
      {"id": "security_question", "label": "セキュリティについて質問がある"}
    ]
  }]