fal-ai

Generate images with fal.ai models through an interactive TUI with fuzzy model search.

Updated Nov 7, 2024
One-click install
npx skills add https://github.com/jeremysball/dotfiles --skill fal-ai-jeremysball
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fal-ai
Source: https://github.com/jeremysball/dotfiles/tree/main/.pi/skills-archive/fal-ai
Command: npx skills add https://github.com/jeremysball/dotfiles --skill fal-ai-jeremysball

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fal-client, pillow, httpx.

What problem does it solve? Choosing the right fal.ai image model and configuring generation settings manually is tedious, and accidental API calls waste money. This Skill provides a guided interactive flow for model selection, settings configuration, and cost estimation before any image is generated. ## Core Features & Use Cases - Interactive Model Selection: Fuzzy search across Recraft, Flux, and Imagen models with keyword matching (logo, cheap, art, vector) and a Serper search fallback for unknown models. - Mandatory Confirmation Gate: Displays exact prompt, model, settings, and estimated cost, requiring explicit "Y" approval before any generation executes. - Usage & Pricing Tracking: Checks fal.ai API usage costs with an admin key and caches live pricing from fal.ai for 24 hours. - Use Case: A designer needs a scalable SVG logo. They select the vector use case, the Skill maps it to recraft-vector, shows the $0.08 estimated cost, and generates only after explicit confirmation. ## Quick Start Ask the assistant to generate a logo image with fal.ai and follow the interactive prompts to pick a model and confirm the settings.

Frequently Asked Questions about fal-ai

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images with fal.ai from the command line?

Run generate_image.py with uv, passing a prompt, output path, and model flag such as -m recraft-v4. The script requires the FAL_KEY environment variable and supports aspect ratio, custom dimensions, seed, and multiple images.

Which fal.ai model should I use for logos and design work?

Recraft-v4 is the recommended model for logos, banners, and design assets at roughly $0.04 per image. For scalable SVG vector output, use recraft-vector, and for the highest design quality use recraft-v4-pro.

What is the cheapest fal.ai model for quick prototypes?

Flux2-klein is the cheapest option at about $0.01 per image with sub-second generation. Fast-lightning-sdxl is another ultra-fast budget option for rapid iteration on game assets and prototypes.

How do I check fal.ai API usage and costs?

Run generate_image.py with the --usage flag, optionally adding --usage-days to set the date range. This requires the FAL_KEY_ADMIN environment variable with an admin key from the fal.ai dashboard, since the usage API rejects regular keys.

Can I use a fal.ai model that is not in the preset list?

Yes, pass any endpoint directly with the --endpoint flag, such as fal-ai/custom/model. The Skill also offers a Serper search fallback to look up unfamiliar models on fal.ai before generating.

Why does the skill refuse to generate an image immediately?

The Skill enforces a mandatory confirmation step showing the exact prompt, model, settings, and estimated cost. Generation only proceeds after you explicitly type Y or yes, preventing accidental API charges.