Keys / fal

FAL_KEY

The fal API key your app runs hosted image, video and audio models with. Keys belong to the account or team, not to a person.

Expires
you choose, from 1 hour to 1 year, or never
API
create, list and revoke, with a FULL key

Get it

Create one on fal.ai/dashboard/keys. The steps aren't recorded yet.

Set it

FAL_KEY=...

The JavaScript client (@fal-ai/client) and the Python client (fal-client) read it from this variable when you don't pass a key. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. Create a new key with the same preset or permissions and the same allowed models. Neither can change after creation.
  2. Deploy it everywhere that reads FAL_KEY.
  3. Check that requests succeed with the new key, then revoke the old one. Revoking stops it at once and can't be undone.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16