You can wire the fal node into an AI agent as a tool provider: the agent calls the operations you allow. See Agent tools.
Credentials
Connect fal under Credentials in the node settings. See Connecting credentials for the general flow. Enter the values manually when creating the credential. Get your credentials here.Operations
Keys
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Create API Key | create_key | Create a new API key for the account. | |
| Delete API Key | delete_key | Delete an API key by its ID. | |
| List API Keys | list_keys | List all API keys for the account. |
Model run
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Cancel Request | cancel_request | Cancel a queued or in-progress request. | |
| Get Request Result | get_result | Fetch the completed result payload of a queued request. | |
| Get Request Status | get_status | Poll the status of a queued request. | |
| Run Model (Sync) | run_model | Run a model endpoint synchronously and get the result inline. | |
| Submit to Queue | submit_queue | Submit an async request to the fal queue (best for long-running jobs). |
Platform
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Get Usage | get_usage | Retrieve granular usage line items for the account. | |
| List Requests by Endpoint | list_requests | List recent requests for a specific model endpoint. | |
| Search Models | search_models | Search and list available model endpoints. |
Storage
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Initiate File Upload | initiate_upload | Initiate a file upload to fal’s CDN; returns a presigned upload URL. |
Other
| Operation | ID | Description | Trigger |
|---|---|---|---|
| On Job Completed | on_job_completed | Fire the workflow when a queued fal job completes (success or error). | Yes |