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