> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymet.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# fal connector

> Let the agent find and run fal's image, video and audio models through your fal API key.

The fal connector lets the agent find and run fal's image, video and audio models. Use it to generate the visuals and media your design needs.

![The Connect Polymet to fal dialog with the API key field and the Save key button](https://mintcdn.com/polymet/TfIzLh80_L4bW9xQ/images/docs/connectors/fal-api-key.png?fit=max\&auto=format\&n=TfIzLh80_L4bW9xQ\&q=85\&s=3ce76b45c4bca702e80859db09a815dd)

## What the agent can do

* Search fal's models and read their inputs, docs and pricing
* Run a model, or submit a longer job and collect the result
* Upload a file for a model to use
* Cancel a job it started

## What it costs

Generations spend your fal credits. They are billed by fal, not by Polymet. You limit or revoke a key in fal's own dashboard.

## Connect

fal connects with an API key.

1. Create a key on [fal's keys page](https://fal.ai/dashboard/keys).
2. In Polymet, click **Agent connectors** in the generation input.
3. Find **fal** and click **Connect**.
4. Paste the key into **API key** and click **Save key**.

The card then shows the key's last four characters.

## Try it

```text theme={null}
Use fal to generate a wide hero photo of a sunlit ceramics studio and put
it on the landing page.
```

```text theme={null}
Check what a five-second product video would cost on fal before you
generate it, and tell me which model you would use.
```

Asking for the price first is a good habit with media models. The agent can look it up before it spends anything.

## Related

* [Agent connectors](https://docs.polymet.ai/connectors/agent-connectors.md) — approving calls, accept-all and its limits, disconnecting
* [Replicate connector](https://docs.polymet.ai/connectors/replicate.md) — another catalog of media and language models
* [Prompt the agent](https://docs.polymet.ai/canvas/prompt.md) — the images Polymet generates without a connector


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.