Skip to main content
This guide takes you from sign-in to a downloaded generation. It takes about five minutes.

​
Before you start

You need a fal account with fal Agent access. Self-serve accounts get access with a fal Agent Pro or fal Agent Max credit tier. Enterprise accounts get access through their agreement. See Access and pricing for details.
1

Open fal Agent

Go to fal.ai/agent and sign in with Google, GitHub, or SSO. If your account does not have access yet, the page shows the available credit tiers. You can type your first prompt before you subscribe. The agent picks it up after activation.
2

Describe what you want

Type a request in the composer. Be specific about the subject, the format, and the number of outputs. For example:
Press Enter to send. Shift+Enter adds a new line.
3

Attach a reference

Drag an image, a video, or a document into the chat, or click the attachment button. The agent uses attachments as references, edit sources, or context. See Composer and references for the supported file types and limits.
4

Review the plan

For a multi-step request, the agent shows a plan card before it runs anything. Read the steps and the model chips. You can rename a step, reorder steps, pin a different model, or add an approval checkpoint. Click Run plan when the plan looks right. Simple requests run directly without a plan card.
5

Watch the generations land

Each run appears as a cell in the chat and in the media rail on the right. In-flight cells show a cancel button. When a run finishes, hover the cell for Retry and Download. Failed runs show a short explanation, and the agent repairs the input and retries when it can.
6

Iterate

Type @ to open the palette. Pick a previous output under Generations, or pin a model under Models. The agent keeps the chat context, so you can say “make the second one warmer” without repeating the prompt.
7

Download or export

Click Download on a cell to save one file. Ask the agent to “export everything as a zip” to get one archive with a folder per batch and a manifest. See Export.

​
Next steps

Chat interface

Sidebar, media rail, history, shortcuts, and notifications

Models and generation

How the agent chooses models and repairs failed runs

Projects

Group chats and media under a shared memory

Spending caps

Confirm expensive runs before they start