Fal.ai

Overview

Fal.ai is a generative media platform for developers. In the latest local export of the SquadOS catalog, this integration provides model discovery and pricing, webhook verification keys, and operations to inspect, monitor, or cancel existing queue requests. The export does not include an action that starts inference or uploads files, so this page does not promise agent-driven media generation in the documented state.

• Official website: https://fal.ai/
• Composio documentation: docs.composio.dev/toolkits/fal_ai

Authentication

This tool uses API key (API_KEY) to connect.

You will need the following fields:

Field	Required	Description
api_key	Yes	API key generated in the Fal.ai dashboard, used to authenticate all inference and queue management requests.

How to get credentials

1. Go to fal.ai/login and create an account or log in with GitHub or Google.
2. In the left sidebar of the dashboard, click API Keys (or navigate directly to fal.ai/dashboard/keys).
3. Click Add Key.
4. Give the key a name (e.g., squados) and click Create Key.
5. Copy the generated key and store it in a safe place — it will not be shown again.

Tip

Create a dedicated key for SquadOS. This way you can revoke access for this integration without affecting other tools or projects that use the same Fal.ai account.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Fal.ai.
3. Open the card under Configure tool and select Activate. The integration moves to Active as Awaiting authentication.
4. Open the active integration, select Connect now, and enter the key on the secure page hosted by Composio.
5. After returning to SquadOS, confirm under Accounts that the account is active.
6. Review Edit actions; then add Fal.ai from the agent’s Tools section, choose the account and actions, save, and run a safe test.

Activation, authentication, and agent assignment are separate steps. See the complete contract in Organization Tools.

Available actions

Cancel Queue Request

FAL_AI_CANCEL_QUEUE_REQUEST

Tool to cancel a queued or in-progress request in fal.ai’s queue system. Use when you need to stop a request before it completes. Note that cancellation only succeeds if the request hasn’t started processing; if already completed, returns an error status. Even with successful cancellation, the request may still execute if it was near the front of the queue.

Input parameters

Name	Type	Required	Description
model_id	string	Yes	The model identifier in namespace/name format (e.g., fal-ai/flux, fal-ai/fast-sdxl).
request_id	string	Yes	The unique identifier of the queued request to cancel.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Estimate Pricing

FAL_AI_ESTIMATE_PRICING

Tool to estimate pricing for fal.ai model endpoints. Use when you need to calculate expected costs for API calls or unit-based usage across one or more endpoints.

Input parameters

Name	Type	Required	Description
endpoints	object	Yes	Map of endpoint IDs (e.g., fal-ai/flux/dev) to their quantity specifications. Use call_quantity for historical_api_price or unit_quantity for unit_price.
estimate_type	string ("historical_api_price" | "unit_price")	Yes	Estimation method: historical_api_price for call-based estimates or unit_price for unit-based estimates.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get JWKS for Webhook Verification

FAL_AI_GET_JWKS

Tool to retrieve public keys for webhook signature verification. Returns a JSON Web Key Set containing ED25519 public keys. Use when you need to verify webhook signatures from fal.ai. The keys are cacheable but should be refreshed at least every 24 hours.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Models

FAL_AI_GET_MODELS

Tool to discover and search fal.ai model endpoints. Use when you need to list all models, find specific models by ID, or search by category/query. Supports pagination and optional expansion of OpenAPI schemas.

Input parameters

Name	Type	Required	Description
q	string	No	Free-text search query. Filters models by name, description, or category. Use for broad text-based searches.
limit	integer	No	Maximum number of items to return. Actual maximum depends on query type.
cursor	string	No	Pagination cursor from previous response. Encodes page number for fetching next page.
expand	string	No	Fields to expand in response. Supports openapi-3.0 to include full OpenAPI schema for each model.
status	string ("active" | "deprecated")	No	Filter models by status. Use active for currently supported models or deprecated for outdated ones. Omit to include all statuses.
category	string	No	Filter models by specific category. Use exact category names like text-to-image, image-to-video, etc.
endpoint_id	string	No	Specific endpoint ID(s) to retrieve. Accepts a single string or array of strings (1–50 models). Use to filter models by their unique identifiers.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Model Pricing

FAL_AI_GET_PRICING

Tool to retrieve unit pricing for model endpoints. Returns pricing information including unit price, billing unit, and currency. Use when you need to check costs for specific fal.ai models.

Input parameters

Name	Type	Required	Description
endpoint_id	string	Yes	Filter by specific endpoint ID(s). Accepts 1–50 endpoint IDs. Can be a single endpoint ID string or a list of endpoint IDs. Examples: fal-ai/flux/dev or ['fal-ai/flux/dev', 'fal-ai/flux/pro'].

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Queue Request Result

FAL_AI_GET_QUEUE_REQUEST_RESULT

Tool to retrieve the final result of a completed queue request. Use when you need to get the output of a model request that was submitted to the queue and has finished processing. Only works after request status transitions to COMPLETED.

Input parameters

Name	Type	Required	Description
model_id	string	Yes	The model identifier in namespace/name format (e.g., fal-ai/flux, fal-ai/fast-sdxl).
request_id	string	Yes	The unique identifier of the queued request to retrieve results for.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Check Queue Request Status

FAL_AI_QUEUE_GET_STATUS

Tool to check the status of a queued request in fal.ai. Use when you need to monitor the progress of an async request. Returns different information based on status: queue position when IN_QUEUE, logs when IN_PROGRESS or COMPLETED.

Input parameters

Name	Type	Required	Description
logs	integer	No	Set to 1 to enable log retrieval in the response; disabled by default for performance.
model_id	string	Yes	Model identifier in namespace/name format (e.g., fal-ai/fast-sdxl).
request_id	string	Yes	Unique identifier returned after submitting a request.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Stream Request Status Updates

FAL_AI_QUEUE_GET_STATUS_STREAM

Tool to stream request status updates via SSE. Use when you need real-time updates on a queued request’s processing state.

Input parameters

Name	Type	Required	Description
logs	integer	No	Set to 1 to include detailed logging information in the stream, 0 or omit to exclude logs.
model_id	string	Yes	The model identifier (e.g., fal-ai/fast-lightning-sdxl).
request_id	string	Yes	The unique identifier returned when submitting a request.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Caution

The latest local catalog export, committed on 2026-06-17, ends with the eight actions above. FAL_AI_RUN_MODEL_SYNC, FAL_AI_SUBMIT_ASYNC_JOB, FAL_AI_SUBSCRIBE_ASYNC_JOB, and FAL_AI_UPLOAD_FILE existed in the previous snapshot but are absent from that export and have been removed from this reference. Do not instruct the agent to generate or upload media with those identifiers unless they appear again under Edit actions.

Use the catalog safely

The current actions can discover models and prices, inspect webhook keys, and monitor or cancel existing queue requests. Before configuring an action, open its schema in the agent editor and copy the displayed fields, types, and requirement exactly. The checkout does not contain those complete schemas, and the audit did not query the database or production.

Checking prices does not reserve funds. Cancelling a request may fail after processing starts and does not guarantee a refund. Treat model and request IDs as external data and test only with a controlled account and budget.