provider-fal (fal.ai Image Generation Example)

You can run this example with:

npx promptfoo@latest init --example provider-fal
cd provider-fal

Demonstrates how to evaluate and compare image generation models using promptfoo.

Setup

1. Get your API key from fal.ai dashboard
2. Set environment variable:
   bashCopy

   export FAL_KEY=your-fal-key-here
   

3. Install client:
   bashCopy

   npm install @fal-ai/client
   

4. Run the evaluation:
   bashCopy

   promptfoo eval
   

What This Example Shows

• Model comparison: Two different fal.ai models side-by-side
• Creative prompts: 7 test cases with artistic styles
• Reproducible results: Fixed seeds for consistent outputs
• Configuration options: Different settings per model

Example Output

The evaluation generates a comparison table showing:

• Model performance across different prompts
• Generated images in markdown format
• Execution time and caching behavior

View Results

promptfoo view

Opens the web interface to browse generated images and compare model outputs.

Customize the Example

Edit promptfooconfig.yaml to:

• Try different models from fal.ai/models
• Add your own prompts
• Adjust model parameters
• Add assertions to test output quality
• Route SDK requests through a proxy with config.client.proxyUrl when your environment requires it

Documentation

• promptfoo fal provider
• fal.ai models