Skip to main content
Use the fal plugin to generate and edit images, video, audio, and 3D assets in ChatGPT and Codex. It connects your fal account and includes skills for model selection, prompting, and media workflows.

​
Setup

  1. Open the fal plugin listing in the shared ChatGPT and Codex plugin directory.
  2. Install the plugin.
  3. Connect your fal account when prompted.
  4. Start a new chat and ask ChatGPT or Codex to use fal.
In Codex CLI, use /plugins to find and install fal, then start a new session. The Codex IDE extension does not support plugins. See OpenAI’s plugin guide for supported apps and installation details. If fal isn’t available in your plugin directory, use the Run MCP setup with a compatible MCP client. To check the connection, ask: “Use fal to search for image generation models. Do not run a model.” The assistant should return model search results.
OAuth uses your personal fal account by default. To change it, open Account settings, open the desired account’s row menu, and choose Use for MCP. Future operations across all your OAuth MCP connections use that account immediately. No reconnect or plugin reinstall is needed. The website’s account switcher is separate.Existing jobs stay on the account that started them. MCP responses show which account was used. If access to the selected account fails, operations stop instead of using personal credits. API-key connections still use their key’s account. Ask your assistant to check pricing before generating.

​
Examples

​
Start with an image

Use fal to create a studio product photo of a ceramic coffee cup on a pale blue background. Choose a model and check its pricing before generating.
To use a specific model, name it in your request.

​
Edit a reference

Use fal to turn this product photo into a summer campaign image. Keep the product shape, label, and colors unchanged.
Provide a public image URL, or attach the image if your app lets the assistant access its bytes. See file uploads for supported inputs.

​
Turn an image into video

Use fal to animate this image into a five-second product video with a slow camera push-in. Keep the product consistent with the source image.
The assistant submits the video to the queue, checks its status, and retrieves the output.

​
Build a set of assets

Use fal to design a coffee brand called Daybreak: a product photo, three social posts, and a short launch video. Keep the palette and packaging consistent across the set.
Use Run MCP to access fal’s tools from other MCP clients. The plugin adds media workflow skills to those tools. For logs, deployments, and serverless debugging, connect the separate Platform MCP.

​
Troubleshooting

  • Your credits are on a team account: open Account settings and choose Use for MCP from the team’s row menu. Switching accounts on the website alone does not change the account used by the plugin.
  • Tools aren’t available: confirm the plugin is installed and its fal connection is authorized, then start a new conversation.
  • An upload fails: the hosted server cannot read local paths. Use a public file URL or upload the file as described in file uploads.
  • A job is still processing or a tool call times out: ask your assistant to check the existing request ID. Submitting again creates another billable job.
  • A model rejects the request: ask your assistant to check the current model schema and the reported input errors before trying again.