fal-platform

fal.ai Platform

モデル管理、料金、使用状況の追跡、コスト見積もりのためのプラットフォーム API です。

スクリプト

スクリプト	用途
setup.sh	FAL_KEY と設定をセットアップします
pricing.sh	モデルの料金情報を取得します
usage.sh	使用状況と請求額を確認します
estimate-cost.sh	操作のコストを見積もります
requests.sh	リクエストを一覧表示して管理します

セットアップと設定

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

これにより、継続的に使用できるよう、FAL_KEY が .env ファイルに追加されます。

モデルの料金

任意のモデルの料金を取得します。

# 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"

出力：

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

使用状況の追跡

使用状況と支出を確認します。

# 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"

期間： minute、hour、day、week、month

コストの見積もり

実行前にコストを見積もります。

# 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"

出力：

Cost Estimate for fal-ai/flux/dev
  Quantity: 100 calls
  Estimated Cost: $2.50

リクエストの管理

リクエストを一覧表示して管理します。

# 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 エンドポイントのリファレンス

操作	エンドポイント	メソッド
モデル検索	GET /models	GET
料金	GET /models/pricing	GET
使用状況	GET /models/usage	GET
リクエストの一覧表示	GET /models/requests/by-endpoint	GET
ペイロードの削除	DELETE /models/requests/{id}/payloads	DELETE

ベース URL： https://api.fal.ai/v1

共通フラグ（すべてのスクリプト）

すべてのスクリプトで、次の共通フラグを使用できます。

--add-fal-key [KEY]   # Add/update FAL_KEY in .env
--help, -h            # Show help
--json                # Output raw JSON
--quiet, -q           # Suppress status messages

トラブルシューティング

API キーが必要です

Error: FAL_KEY required for this operation

Run: bash /mnt/skills/user/fal-platform/scripts/setup.sh --add-fal-key

アクセスが拒否されました

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