fal-ailisted
Install: claude install-skill trku052-png/social-media-youtube-skills
# fal.ai
## Overview
fal.ai hosts 1,000+ generative models (image, video, audio, LLM) behind one API: pick an endpoint ID, send `input`, get JSON back with URLs to the generated media. There are no GPUs to manage and billing is per use. Calls go through a durable queue, so long jobs survive retries; `subscribe` hides the queue behind one awaited call, while `queue.submit` plus a webhook suits production pipelines. Result shapes differ per model, so check the model's API page (open it from fal.ai/models and choose the API tab) before reading fields.
## Instructions
### Install and authenticate
```bash
npm install @fal-ai/client # Node 18+, browsers, React Native
pip install fal-client # Python 3.8+
export FAL_KEY="fal_live_key_from_dashboard" # create at fal.ai/dashboard/keys
```
Both clients read `FAL_KEY` from the environment. Never ship the key to a browser: in front-end code route requests through a server proxy (`@fal-ai/server-proxy` for Next.js) and set `fal.config({ proxyUrl: "/api/fal/proxy" })`.
### Quick start
The JavaScript client exports a named `fal` object. `import * as fal from "@fal-ai/client"` does not work (`fal.subscribe` is undefined).
```typescript
import { fal } from "@fal-ai/client";
const result = await fal.subscribe("fal-ai/flux/schnell", {
input: {
prompt: "A futuristic city at night, neon lights, cyberpunk style",
image_size: "landscape_4_3",
num_images: 1,
},
logs: true,
onQueueUpdate: (update) => {
i