How do I install the Fal Platform skill?

Run npx skillmds@latest add luokai0/fal-platform in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fal Platform safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fal Platform?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fal Platform free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fal Platform?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fal Platform by luokai0 — Agent Skill

Name: Fal Platform
Rating: 4.2 (5 reviews)
Author: luokai0

File contents

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

---name: fal-platformdescription: 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.---# fal.ai PlatformPlatform 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```bash# Interactive setupbash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key# Set key directlybash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key "your_key_here"# Show current configbash /mnt/skills/user/fal-platform/scripts/setup.sh --show-config```This adds FAL_KEY to your `.env` file for persistent use.## Model PricingGet pricing for any model:```bash# Single model pricingbash /mnt/skills/user/fal-platform/scripts/pricing.sh --model "fal-ai/flux/dev"# Multiple modelsbash /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 categorybash /mnt/skills/user/fal-platform/scripts/pricing.sh --category "text-to-image"```**Output:**```fal-ai/flux/dev Price: $0.025 per image Unit: imagefal-ai/kling-video/v2/master/text-to-video Price: $0.50 per second Unit: video_second```## Usage TrackingCheck your usage and spending:```bash# Current period usagebash /mnt/skills/user/fal-platform/scripts/usage.sh# Filter by modelbash /mnt/skills/user/fal-platform/scripts/usage.sh --model "fal-ai/flux/dev"# Date rangebash /mnt/skills/user/fal-platform/scripts/usage.sh --start "2024-01-01" --end "2024-01-31"# Specific timeframebash /mnt/skills/user/fal-platform/scripts/usage.sh --timeframe "day"```**Timeframes:** `minute`, `hour`, `day`, `week`, `month`## Estimate CostEstimate costs before running:```bash# 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 unitsbash /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 ManagementList and manage requests:```bash# List recent requestsbash /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:```bash--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 operationRun: bash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key```### Permission Denied```Error: API key doesn't have permission for this operationSome operations require admin API keys. Check your key permissions at:https://fal.ai/dashboard/keys```

Frequently asked questions

Fal Platform