Settings Tab
The Settings tab is where you manage your fal.ai API key, verify your connection, send feedback, and control what data is stored locally.
API Key
Section titled “API Key”Paste your fal.ai API key into the key field. The key is validated immediately — you do not need to click a separate “test” button.
Getting an API Key
Section titled “Getting an API Key”- Go to fal.ai/dashboard/keys
- Click Create Key
- Name it (e.g., “modelBridge”)
- Copy the key — it is shown only once
See the API Key Setup guide for full instructions.
Connection Status
Section titled “Connection Status”The Settings tab shows a real-time connection status badge:
| Status | Indicator | Meaning |
|---|---|---|
| Bridge Connected | Green dot with pulse | Key is valid and fal.ai is reachable |
| Invalid API key | Red dot | The API key was rejected by fal.ai — check for typos or generate a new key |
| Not connected | Amber dot | No API key has been provided yet |
When you enter or change the API key, the plugin validates it by making a test request to fal.ai. If the key is valid, all previously gated models are automatically rechecked — models that were blocked due to access restrictions may become available with the new key.
Send Feedback
Section titled “Send Feedback”The Settings tab includes a built-in feedback form for sharing ideas and reporting bugs directly from the plugin.
How It Works
Section titled “How It Works”- Click Send feedback to expand the form
- Select Idea or Bug to set the feedback type
- Write your message
- Optionally attach up to 3 screenshots (5 MB each) — screenshots make it much easier to understand your feedback
- Click Send
The form includes your system context automatically (plugin version, Premiere Pro version, OS, installed model count) to help diagnose issues faster.
What Happens After You Send
Section titled “What Happens After You Send”The Send button shows a shimmer animation while submitting, then turns green with “Sent” on success. The form collapses automatically after sending.
Subscription
Section titled “Subscription”The Subscription section shows your current license status and provides account management actions.
Status badge
Section titled “Status badge”A status badge at the top of the section shows your current subscription state:
| Status | Meaning |
|---|---|
| Active | Subscription is valid and all features are available |
| Trial | Free trial is active — full access until the trial end date |
| Expired | Subscription has ended — the plugin is in read-only mode |
| Grace | Payment failed but LemonSqueezy is retrying — full access continues during the grace period |
| Offline | Unable to verify license — the plugin works offline for up to 7 days after the last successful check |
| Disabled | License has been revoked — read-only mode with a message to contact support |
Subscription details
Section titled “Subscription details”Below the status badge, the section shows your plan (monthly or annual), the number of activated devices out of 2, and when the license was last validated.
Actions
Section titled “Actions”Manage subscription opens the LemonSqueezy customer portal where you can update your payment method, switch plans, download invoices, or cancel.
Release this device frees up one of your 2 activation slots. Use this when moving to a new machine — release on the old device, then activate on the new one.
Developer diagnostics
Section titled “Developer diagnostics”When developer mode is enabled (developerMode: true in user-settings.json), an additional diagnostics section appears with license validation details, cache state, and debug information. This is not visible in normal use.
Agent Mode (Anthropic API Key)
Section titled “Agent Mode (Anthropic API Key)”To use Agent Mode, paste your Anthropic API key in the dedicated field below the fal.ai key section.
- Create an account at console.anthropic.com
- Generate an API key
- Paste it in the Anthropic API key field in Settings
Once a valid key is saved, the Agent tab appears in the plugin. The key is stored locally — it is never sent to modelBridge servers. You pay Anthropic directly at their published rates.
Preferences
Section titled “Preferences”Completion Sound
Section titled “Completion Sound”Toggle the audio chime that plays when a background generation completes. Useful when you’re working on other tasks and want to know when a result is ready.
Show Learning Tips
Section titled “Show Learning Tips”Controls whether contextual Academy links and learning tips appear throughout the plugin — on model cards, in the Generate tab, and alongside parameters. When enabled, you’ll see “Learn about X” links that connect to relevant Academy articles based on the specific model you’re using.
Turn this off if you’re comfortable with generative AI concepts and prefer a cleaner interface. The setting is offered during onboarding and can be changed here at any time. All Academy articles remain accessible at docs.modelbridge.app/academy regardless of this setting.
What Is Stored Locally
Section titled “What Is Stored Locally”Your API key is stored in two places on your machine:
- localStorage — for fast access during the session
- Local settings file — managed by the plugin’s data directory for persistence across sessions
What Is Never Sent
Section titled “What Is Never Sent”- Your API key is never transmitted to modelBridge or any third party
- It is used exclusively for direct communication between your machine and fal.ai’s API
- No usage data, prompts, or generation history leaves your machine (except to fal.ai for generation)
Removing Your API Key
Section titled “Removing Your API Key”To remove your stored API key:
- Click the edit icon on the masked key row
- Use the remove option and confirm
The key is removed from both localStorage and the settings file. You will need to re-enter it to generate content.
Privacy
Section titled “Privacy”modelBridge communicates with only two external services:
| Service | Purpose | Data Sent |
|---|---|---|
| fal.ai | AI generation, schema fetching, pricing | Your API key, prompts, uploaded media |
| LemonSqueezy | License validation at startup | License key + machine identifier only |
Optional error telemetry and behavioral analytics are available but off by default. See Privacy Controls for details on what’s sent and how to opt in.
If you use Agent Mode, conversations are sent to Anthropic via your own API key — not through modelBridge servers.
All user data — settings, generation history, installed models, cost logs, learned constraints — is stored locally on your machine. There is no “modelBridge server” that your data is sent to.
Data Reset
Section titled “Data Reset”The Settings tab includes a reset option to clear all locally stored data. This removes:
- Installed models and their schemas
- Generation history and cost logs
- Learned constraints
- User settings and preferences
The reset requires typing “DELETE” as confirmation to prevent accidental data loss. Your API key must be re-entered after a reset.
See Updating modelBridge for what persists through plugin updates (everything — reset is only for a full clean start).