fallisted

# fal.ai fal hosts ~1,400 media models behind one REST API and one key. This skill wraps it in a single script, plus the model knowledge and pipeline patterns needed to go from a request to a finished file. ``` scripts/fal.sh every API call (run, batch, upload, models, schema, pricing, usage) scripts/compose.sh local ffmpeg assembly — concat, music bed, vertical, captions references/API.md the verified REST surface; read when debugging or going off-script references/MODELS.md which model for which job (verified 2026-08-07) references/RECIPES.md end-to-end pipelines: UGC ad, explainer, commercial, character consistency references/PROMPTING.md how to write image/video prompts that don't look AI-generated ``` Set `F=~/.claude/skills/fal/scripts/fal.sh` and `C=~/.claude/skills/fal/scripts/compose.sh` at the start of a session. Requires `jq`; `compose.sh` requires `ffmpeg`. ## Before anything else ```bash $F setup # prompts for the key, writes ~/.config/fal/credentials (mode 600) ``` Key from https://fal.ai/dashboard/keys. `FAL_KEY` in the environment also works. **Never echo the key.** ## The five rules 1. **Never guess a model's parameters.** `$F schema <endpoint>` first. Input keys vary wildly (`image_url` vs `image_urls` vs `reference_image_urls`) and a wrong key is a 422. 2. **Never guess an endpoint id.** `$F models "<query>"` — the catalog changes weekly and hardcoded lists rot. `references/MODELS.md` is a starting point, not the truth.