V3 API Pricing & Billing Validator for Openclaw

A specialized utility for validating and testing API pricing structures and actual credit consumption for V3 models.

hexiaochun
v1.0.0
Feb 9, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install pricing-test

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install pricing-test 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 V3 API Pricing & Billing Validator?

This skill is a technical framework designed to bridge the gap between official API pricing and internal credit systems. It focuses on the V3 API architecture, ensuring that every model call results in the correct deduction of points based on a predefined exchange rate where 1 USD equals 400 points. By utilizing this tool within Openclaw Skills, developers can verify that video models, image generators, and other LLMs are priced accurately across different durations and resolutions, preventing revenue leakage or overcharging.

The skill provides a structured approach to auditing the billing lifecycle, from the initial fal.ai pricing extraction to the final task execution. It is an essential component for maintainers of Openclaw Skills who need to ensure that the pricing displayed in documentation matches the actual points deducted during runtime.

V3 API Pricing & Billing Validator Use Cases

  • Verifying new model pricing structures before production deployment.
  • Debugging discrepancies between expected costs and actual point deductions in the database.
  • Validating credit conversion logic for high-end video models with variable durations.
  • Performing automated regression testing of the billing system through Openclaw Skills.
  • Auditing Executor configurations for missing PRICE_MAP or get_price methods.

How V3 API Pricing & Billing Validator Works

  1. The skill identifies the official model pricing from external providers such as fal.ai and converts the USD value to internal points.
  2. It inspects the local Executor configuration files to ensure the PRICE_MAP, duration options, and resolution options are correctly defined.
  3. It triggers a simulated API call to the documentation endpoint to verify that the front-facing price description and examples are accurate.
  4. It executes a task creation request to capture and validate the real-time point deduction for a specific model configuration.
  5. It runs batch validation scripts across multiple models to ensure system-wide pricing consistency within the Openclaw Skills framework.

V3 API Pricing & Billing Validator Setup

To set up the pricing validator, navigate to your API directory and ensure your environment variables are configured.

# Navigate to the translate_api directory
cd translate_api

# Run the dedicated pricing test script to verify all models
python3 test_pricing.py

# Manual verification of a specific model's documentation pricing
curl -s 'http://127.0.0.1:8002/api/v3/models/{MODEL_ID}/docs' \
  -H 'Authorization: Bearer {API_KEY}'

V3 API Pricing & Billing Validator Data Schema & Taxonomy

The skill organizes pricing data and validation metadata according to the following schema:

Attribute Description Data Type
PRICE_MAP Mapping of model tiers to internal points Dictionary
price_type Billing method (e.g., duration_price or fixed) String
price_description Human-readable billing explanation String
examples Validated pricing samples for different parameters List
Point Ratio Fixed conversion rate of 1 USD = 400 points Integer

V3 API Pricing & Billing Validator Advanced Features

  • Support for multi-resolution and multi-duration billing logic in video models.
  • Automated detection of video models via keywords to apply duration-based pricing.
  • Integration with Openclaw Skills batch testing pipelines for continuous integration.
  • Fallback mechanism detection to prevent fixed default billing when executors are misconfigured.
  • Direct integration with fal.ai pricing endpoints for real-time comparison.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*