fal.ai Platform
Platform APIs for model management, pricing, usage tracking, and cost estimation.
Scripts
Script Purpose
setup.sh
Setup FAL_KEY and configuration
pricing.sh
Get model pricing information
usage.sh
Check usage and billing
estimate-cost.sh
Estimate costs for operations
requests.sh
List and manage requests
Setup & Configuration
Add FAL_KEY
Interactive setup
bash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key
Set key directly
bash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key "your_key_here"
Show current config
bash /mnt/skills/user/fal-platform/scripts/setup.sh --show-config
This adds FAL_KEY to your .env file for persistent use.
Model Pricing
Get pricing for any model:
Single model pricing
bash /mnt/skills/user/fal-platform/scripts/pricing.sh --model "fal-ai/flux/dev"
Multiple models
bash /mnt/skills/user/fal-platform/scripts/pricing.sh --model "fal-ai/flux/dev,fal-ai/kling-video/v2/master/text-to-video"
All pricing for a category
bash /mnt/skills/user/fal-platform/scripts/pricing.sh --category "text-to-image"
Output:
fal-ai/flux/dev Price: $0.025 per image Unit: image
fal-ai/kling-video/v2/master/text-to-video Price: $0.50 per second Unit: video_second
Usage Tracking
Check your usage and spending:
Current period usage
bash /mnt/skills/user/fal-platform/scripts/usage.sh
Filter by model
bash /mnt/skills/user/fal-platform/scripts/usage.sh --model "fal-ai/flux/dev"
Date range
bash /mnt/skills/user/fal-platform/scripts/usage.sh --start "2024-01-01" --end "2024-01-31"
Specific timeframe
bash /mnt/skills/user/fal-platform/scripts/usage.sh --timeframe "day"
Timeframes: minute , hour , day , week , month
Estimate Cost
Estimate costs before running:
Estimate by API calls (historical pricing)
bash /mnt/skills/user/fal-platform/scripts/estimate-cost.sh
--model "fal-ai/flux/dev"
--calls 100
Estimate by units
bash /mnt/skills/user/fal-platform/scripts/estimate-cost.sh
--model "fal-ai/kling-video/v2/master/text-to-video"
--units 60
--type "unit_price"
Output:
Cost Estimate for fal-ai/flux/dev Quantity: 100 calls Estimated Cost: $2.50
Request Management
List and manage requests:
List recent requests
bash /mnt/skills/user/fal-platform/scripts/requests.sh --model "fal-ai/flux/dev" --limit 10
Delete request payloads (cleanup)
bash /mnt/skills/user/fal-platform/scripts/requests.sh --delete "request_id_here"
API Endpoints Reference
Operation Endpoint Method
Model Search GET /models
GET
Pricing GET /models/pricing
GET
Usage GET /models/usage
GET
List Requests GET /models/requests/by-endpoint
GET
Delete Payloads DELETE /models/requests/{id}/payloads
DELETE
Base URL: https://api.fal.ai/v1
Common Flags (All Scripts)
All scripts support these common flags:
--add-fal-key [KEY] # Add/update FAL_KEY in .env --help, -h # Show help --json # Output raw JSON --quiet, -q # Suppress status messages
Troubleshooting
API Key Required
Error: FAL_KEY required for this operation
Run: bash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key
Permission Denied
Error: API key doesn't have permission for this operation
Some operations require admin API keys. Check your key permissions at: https://fal.ai/dashboard/keys