A specialized auditing tool for reconciling Fal.ai API consumption with internal user billing records to ensure financial accuracy and detect usage anomalies.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fal-consumption-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install fal-consumption-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Fal Consumption Audit?
The Fal Consumption Audit skill is a professional-grade financial reconciliation tool designed for platforms utilizing Fal.ai services. As a core part of the Openclaw Skills ecosystem, it provides a three-tier data validation process that compares official Fal.ai billing data, internal system task records, and user transaction ledgers. This ensures that every API call is correctly billed and that platform costs align with revenue.
By automating the detection of discrepancies, this skill helps developers maintain system integrity and prevents revenue leakage. It provides clear visibility into model-specific costs, user-level consumption, and account balances, making it an essential utility for anyone managing high-volume AI generation services.
Fal Consumption Audit Use Cases
- Reconciling official Fal.ai platform costs with internal system records to identify overspending.
- Detecting billing errors where users are charged for failed or non-existent API tasks.
- Finding unpaid API usage scenarios where Fal.ai costs were incurred but no user points were deducted.
- Monitoring multiple Fal.ai accounts to prevent service interruptions due to low balances.
- Auditing specific high-usage users to ensure their consumption patterns match historical averages.
How Fal Consumption Audit Works
- The skill queries the Fal Platform API using model usage endpoints to retrieve the actual USD cost and quantity per model.
- It extracts internal task data from the fal_tasks table, mapping tasks to specific API keys and user IDs.
- Consumption data is aggregated by user to calculate total charged points versus the actual Fal.ai production cost.
- A cross-reference check is performed against the user points detail and financial transaction tables to verify cash and credit consistency.
- Anomaly detection rules are applied to generate a prioritized report highlighting high-severity discrepancies and balance warnings.
Fal Consumption Audit Setup
To deploy this skill within your Openclaw Skills environment, ensure your database contains the required ts_ tables and execute the following commands:
# Navigate to the script directory
cd translate_api/app/coze/
# Run a full audit for the current day
python fal_balance.py audit
# Run audit for a specific date range
python fal_balance.py audit --start 2026-02-01 --end 2026-02-06
# Target specific Fal accounts for auditing
python fal_balance.py audit --ids 5 12
Fal Consumption Audit Data Schema & Taxonomy
The skill organizes data across four primary dimensions for deep auditing:
| Source | Key Fields | Purpose |
|---|---|---|
| FalAccount | api_key, balance, status | Tracks official credentials and current credit levels. |
| FalTasks | user_id, api_key, cost_money, money | Maps internal user tasks to actual API costs and charges. |
| PointsDetail | points, source_type, balance_after | Validates internal credit movements (consume/refund/recharge). |
| FinancialTransactions | money, transaction_type, is_cash | Cross-verifies cash-based billing against API consumption. |
Fal Consumption Audit Advanced Features
- Automated 8-point anomaly detection system ranging from cost deviation (A1) to zero-cost task detection (A7).
- Support for multi-account management, auditing up to 20 Fal.ai keys in a single pass.
- Granular filtering capabilities allowing audits by specific User IDs or Fal Account IDs.
- High-fidelity terminal reporting with tiered visualization of official bills, task records, and billing consistency.
- Pre-integrated hooks for usage timeframe expansion and model-specific cost breakdown.
SKILL.md
Loading
Related Openclaw Skills
Character Creator
An automated workflow for generating comprehensive AI character assets, including descriptions, portraits, and consistent multi-angle reference images.
CDN URL Transfer for Model Registry
A developer tool designed to migrate external media URLs from model configurations to a high-speed private CDN for increased reliability.
SouShen Hunter
A high-performance Bing search engine skill built on Playwright for deep web intelligence and structural element extraction.
Viam CLI Manager
A comprehensive interface for managing Viam robotics infrastructure, from initial CLI installation to advanced fleet and data pipeline automation.
fal-ai Model Documentation Discovery
A specialized automation skill to extract all available model variants and documentation links from any fal.ai model page.
Fashion Studio
An automated end-to-end workflow for creating professional e-commerce fashion photography and detail pages using specialized AI agent sub-delegation.
Featured*
