fal

At a glance

Set these per environment. See Connect an integration.

Variable	Required	Description
`FAL_KEY`	Yes	fal API key (sent as ‘Authorization: Key <FAL_KEY>’) Docs.

Create a fal account: Sign up at https://fal.ai - new accounts get free credits to try models before adding billing.
Create an API key: Open https://fal.ai/dashboard/keys, create a key, and copy it immediately - it is only shown once.
Store the key: Add it to your .env file as FAL_KEY=… - requests authenticate with the header ‘Authorization: Key <FAL_KEY>’.
Pick a model and verify: Browse https://fal.ai/models and copy a model endpoint ID (e.g. fal-ai/flux/schnell). Pass its segments as app_owner=fal-ai, app_id=flux, app_variant=schnell to the Run Model tool with a small input payload.

Each model has its own input schema - check the model’s API tab on fal.ai/models for required fields
Use the queue tools (submit → status → result) for slow models like video generation; synchronous fal.run requests can time out
Queue status/result/cancel URLs use the base app ID without the variant segment (fal returns ready-made status_url and response_url in the submit response)
Model runs are billed per inference - check the model page for pricing

Provider API reference: https://fal.ai/docs

Tool	Access	Description
Run Model	Write	Run a fal model synchronously and wait for the result (best for fast models; billed per run). The model endpoint ID is split into owner / app / variant segments, e.g. fal-ai/flux/schnell
Submit Queue Request	Write	Submit a request to the fal queue and return immediately with a request_id (billed per run)
Get Queue Status	Read	Check the status of a queued request (IN_QUEUE, IN_PROGRESS, or COMPLETED). Use the base app ID without the variant segment, matching the status_url returned at submit time
Get Queue Result	Read	Fetch the result of a completed queue request. Use the base app ID without the variant segment, matching the response_url returned at submit time
Cancel Queue Request	Write	Cancel a queued request that has not started running yet

Run the fal-ai/flux/schnell model on fal with a prompt I provide and show me the resulting image URL.
Submit a request to a fal model via the queue, then poll its status and fetch the result when it completes.