Agent skill
fal-platform
fal.ai Platform APIs for model management, pricing, usage tracking, and cost estimation. Use when user asks "show pricing", "check usage", "estimate cost", "setup fal", "add API key", or platform management tasks.
Install this agent skill to your Project
npx add-skill https://github.com/fal-ai-community/skills/tree/main/skills/claude.ai/fal-platform
Metadata
Additional technical details for this skill
- author
- fal-ai
- version
- 1.0.0
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
fal-ai-community/skills
fal-image-edit
Edit images using AI on fal.ai. Style transfer, object removal, background changes, and more. Use when the user requests "Edit image", "Remove object", "Change background", "Apply style", or similar image editing tasks.
fal-ai-community/skills
fal-lip-sync
Create talking head videos, lip sync audio to video, and animate portraits with expressions. Use when the user requests "Talking head", "Lip sync", "Make this person talk", "Animate portrait", "Live portrait", "Avatar video".
fal-ai-community/skills
fal-workflow
Generate production-ready fal.ai workflow JSON files. Use when user requests "create workflow", "chain models", "multi-step generation", "image to video pipeline", or complex AI generation pipelines.
fal-ai-community/skills
fal-restore
Restore and fix image quality — deblur, denoise, dehaze, fix faces, restore documents. Use when the user requests "Fix blurry image", "Remove noise", "Fix face", "Restore photo", "Enhance document", "Deblur", "Denoise".
fal-ai-community/skills
fal-vision
Analyze images using AI — segment objects, detect objects, extract text (OCR), describe images, ask questions about images. Use when the user requests "Segment image", "Detect objects", "OCR", "Extract text from image", "Describe image", "What's in this image", "Image analysis".
fal-ai-community/skills
fal-tryon
Virtual try-on — see how clothes look on a person. Use when the user requests "Try on clothes", "Virtual try-on", "How does this look on me", "Fashion try-on", "Garment transfer".
Didn't find tool you were looking for?