/setup-fal.es

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Navegador disponible", "Tener cuenta de GitHub o Google"]
level: "beginner"
tags: ["setup", "fal", "api", "video", "image"]
nonInteractiveMode: deferred

Configuración de la API de fal.ai

Step 0: Verificar el progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-fal` para mostrar el progreso 2. Detectar automáticamente la clave de API existente:

• Ejecutar `uv run python tools/credential_manager.py status`
• Si FAL_KEY ya está configurada, puede ejecutar solo el Step 4 (prueba) y marcarlo como completado
• Si existe una clave en texto plano en `.env`, sugerir la migración al almacén de credenciales

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Obtener una clave de API de fal.ai y guardarla en el Almacén de credenciales para poder usar funciones de IA como generación de video e imagen | | Duración | ~10 minutos | | Requisitos previos | Una cuenta de GitHub o Google, y un navegador disponible | | Nivel de operación | Principalmente ejecución automática por la IA (solo un comando manual en terminal separada para almacenar la clave de API) |

**¿Qué es fal.ai?** Una plataforma que proporciona acceso unificado a motores de IA para generación de video (Kling, Veo, etc.), generación de imágenes, sincronización labial (Fabric), generación de música (Suno) y más. Una sola clave de API le da acceso a múltiples modelos de IA.

**Flujo de la sesión:** 1. Abrir fal.ai en el navegador (la IA abre el navegador automáticamente) 2. Crear una cuenta y obtener la clave de API (solo hacer clic en botones en pantalla) 3. Guardar la clave de API de forma segura en el Almacén de credenciales (ejecutar un comando en terminal separada) 4. Prueba de funcionalidad (la IA lo ejecuta automáticamente)

> **Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continúe" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación antes de la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está preparado/a?",
    "options": [
      {"id": "ready", "label": "¡Preparado/a! Comencemos"},
      {"id": "chrome", "label": "Automatizar operaciones del navegador con /chrome"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "different_lesson", "label": "Quiero ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (chrome -> Después de abrir el navegador en el Step 1, seguir la sección "Automatización con integración Chrome" para la ejecución automática) (check_prereq -> Indicar: "Puede registrarse con una cuenta de GitHub o Google. Si puede iniciar sesión en el navegador, está listo/a.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Abrir fal.ai en el navegador y crear una cuenta

**Lo que hace la IA:** 1. Detectar automáticamente el SO (Mac / Windows / Linux) 2. Ejecutar el siguiente comando para abrir el navegador automáticamente:

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

**Después de que se abra el navegador, mostrar la siguiente AskQuestion:**

{
  "title": "Step 1: Crear una cuenta de fal.ai",
  "questions": [{
    "id": "account_status",
    "prompt": "¿Se abrió el navegador? Siga estos pasos para crear su cuenta:\n\n1. Haga clic en 'Sign Up' o 'Login' en la parte superior derecha\n2. Autentíquese con su cuenta de GitHub o Google\n3. Cuando se muestre el panel de control, habrá terminado\n\n¿Ha iniciado sesión?",
    "options": [
      {"id": "logged_in", "label": "¡He iniciado sesión!"},
      {"id": "browser_not_open", "label": "El navegador no se abrió"},
      {"id": "signup_issue", "label": "No puedo registrarme"},
      {"id": "already_have_account", "label": "Ya tengo una cuenta"}
    ]
  }]
}

(logged_in -> Ir al Step 2) (browser_not_open -> Indicar: "Abra esta URL directamente en su navegador: https://fal.ai") (signup_issue -> Indicar: "Intente autenticarse con su cuenta de GitHub. Si falla, intente con su cuenta de Google.") (already_have_account -> Ir al Step 2)

---

Automatización con integración Chrome (modo `/chrome`)

**Requisito previo:** La extensión "Claude in Chrome" (v1.0.36+) debe estar instalada en Chrome, y debe haber iniciado con `claude --chrome` o ejecutado `/chrome` en la sesión.

**Lo que la IA ejecuta automáticamente con la integración Chrome:** 1. Abrir https://fal.ai en el navegador 2. Usar la integración Chrome para realizar las siguientes operaciones en orden:

• Hacer clic en el botón "Sign Up" o "Login"
• Autenticarse con cuenta de GitHub o Google (esperar la acción del usuario)
• Después de iniciar sesión, navegar a https://fal.ai/dashboard/keys
• Hacer clic en el botón "Create Key" o "Add Key"

3. Una vez que se muestre la clave de API, indicar al usuario "Copie la clave de API" 4. Ir al Step 3

**Nota:** No leer el valor de la clave de API desde la pantalla del navegador. El usuario la copia manualmente.

Si la integración Chrome no está disponible, siga los pasos a continuación manualmente.

---

Step 2: Obtener su clave de API

**Lo que hace la IA:** 1. Abrir la página de administración de claves de API en el navegador:

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

**Después de que se abra el navegador, mostrar la siguiente AskQuestion:**

{
  "title": "Step 2: Obtener su clave de API",
  "questions": [{
    "id": "key_status",
    "prompt": "¿Se abrió la página de administración de claves de API? Siga estos pasos para obtener su clave de API:\n\n1. Haga clic en el botón 'Create Key' o 'Add Key'\n2. Copie la clave de API mostrada\n   (La clave puede mostrarse sol