fal-platform

📁 fal-ai-community/skills 📅 Jan 27, 2026
46
总安装量
46
周安装量
#4640
全站排名
安装命令
npx skills add https://github.com/fal-ai-community/skills --skill fal-platform

Agent 安装分布

claude-code 40
gemini-cli 29
opencode 27
codex 26
cursor 21
antigravity 20

Skill 文档

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.1/pro"

# 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.1/pro
  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.1/pro" \
  --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