SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

Fal.ai API

Give your agents access to Fal.ai API. Bring your own Fal.ai key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for freeGet a demo
Fal.ai logoFal.ai
Instant

Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools.

13 Tools
COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Fal.ai without a separate account or API key for each one. New accounts start with $2 of free credit.

No Fal.ai account or key

Your agent calls Fal.ai through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

Images from $0.003; videos from $0.04 per second or $0.19 per clip; $2 max per job., paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Fal.ai with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Fal.ai API to your AI assistant

Use Fal.ai from the AI assistant you already work in. Connect Composio once, then paste the prompt.

  1. 1

    Open the Connectors menu

    Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
    Add Composio to Claude
  2. 2

    Add the Composio MCP server

    Name it Composio, paste the MCP server URL and click Add.
    https://connect.composio.dev/mcp
  3. 3

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  4. 4

    Paste the prompt

    Start a new chat and paste the prompt. Claude runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
    Install in ChatGPT
  2. 2

    Authorize in your browser

    Connect the plugin, then sign in to Composio to approve the connection.
  3. 3

    Turn on Composio in your chat

    In a new chat, click +, then More, and select Composio.
  4. 4

    Paste the prompt

    Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
    Install in Cursor
  2. 2

    Paste the prompt

    Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
  1. 1

    Add the Composio plugin

    Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
    Add to Grok Bot
  2. 2

    Authenticate

    Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
  3. 3

    Paste the prompt

    Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
  1. 1

    Paste the setup prompt

    Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
    Set up Composio from composio.dev/hermes
  2. 2

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  3. 3

    Paste the prompt

    Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chat

Paste this prompt

Use Fal.ai through Composio Instant to create a watercolor illustration of a small red fox sitting under a cherry blossom tree. Return the finished image URL.

What success looks like

FAL_AI_SUBMIT_ASYNC_JOB

Your assistant runs Fal.ai and replies with the finished image URL for a watercolor illustration of a small red fox sitting under a cherry blossom tree.

Runs on Composio Instant
SDK

Use the Fal.ai API in your code

Call Fal.ai from your own agent with the Composio SDK. Four steps and one tool call.

  1. 1

    Set up Composio

    Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
    export COMPOSIO_API_KEY="your_composio_api_key"
  2. 2

    Install the SDK

    The Python SDK needs Python 3.11 through 3.15.
    pip install composio
  3. 3

    Run the call

    Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
    FAL_AI_SUBMIT_ASYNC_JOB
  4. 4

    Read the response

    When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
agent.py
from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["fal_ai"],
    instant={
        "toolkits": {"enable": ["fal_ai"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "FAL_AI_SUBMIT_ASYNC_JOB",
    arguments={
        "input": {
            "prompt": "A small red fox sitting under a cherry blossom tree, watercolor illustration",
        },
        "model_id": "fal-ai/flux/schnell",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)
TOOLS

Available Fal.ai API tools

2 Fal.ai tools run on Instant, priced per call with no Fal.ai key. Tools marked Your key need your own Fal.ai account.

ActionTool slugWhat it doesAvailability
Submit GenerationFAL_AI_SUBMIT_ASYNC_JOBStart image, text-to-video, image-to-video, or 3D generation.
InstantImages from $0.003; videos from $0.04 per second or $0.19 per clip; $2 max per job.
Get ResultFAL_AI_GET_QUEUE_REQUEST_RESULTRetrieve the final output from a completed generation job.
Instant$0 per request
Run ModelFAL_AI_RUN_MODEL_SYNCRun a fal.ai model and return its model-specific output.Your key
Upload InputFAL_AI_UPLOAD_FILEUpload media and get an access URL for use as a model input.Your key

Instant prices are Fal.ai's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Fal.ai API use cases and example prompts

Copy a prompt into your agent. Each one uses Fal.ai with apps you connect through Composio.

  • Create launch campaign visuals

    Use Fal.ai to generate a square launch image for Acme's new project management app, with a clean workspace scene and room for a headline. Save the finished image in my Acme Launch Assets folder in Google Drive, then post its link in Slack's #marketing channel.

    Apps used: Fal.ai, Google Drive, Slack

  • Add a visual to the product guide

    Use Fal.ai to generate a wide hero image for my onboarding guide about setting up Acme's team dashboard. Add the finished image URL and a one-sentence caption to the guide's page in my Product Handbook in Notion.

    Apps used: Fal.ai, Notion

  • Track campaign image concepts

    Use Fal.ai to generate an image for each concept in my Launch Concepts sheet in Google Sheets. Add each finished image URL to its matching row, then post a link to the updated sheet in Slack's #campaigns channel.

    Apps used: Fal.ai, Google Sheets, Slack

  • Prepare a webinar announcement

    Use Fal.ai to generate a banner image for Acme's webinar on improving customer onboarding. Draft a Gmail announcement for my marketing team that includes the finished image URL and leaves the send date for me to fill in.

    Apps used: Fal.ai, Gmail

TROUBLESHOOTING

Fal.ai API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Start with Fal.ai.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Fal.ai tool your agent needs.Free to start.

Start building