/price-check

name: price-check
description: "Look up what a generation actually costs right now from the provider live pricing page, record it with its source, and quote a run before spending anything. Triggers on \"/price-check\", \"what will this cost\", \"quote the month\", \"price this video\", \"compare providers\", \"is sound extra\", \"cost estimate\", or before generate-all and any paid generation. Prices expire after 24h; quotes refuse rather than guess, and a quote is never an approval."
argument-hint: "[--model <id>] [--provider <name>] [--compare] [--batch] [--staleness]"
effort: low
user-invocable: true

/socialforge:price-check — What this run will cost, looked up today

Prices here are never remembered. They are looked up, recorded with the URL they came from, and expire after 24 hours.

That is not caution for its own sake. On 2026-07-31 a major video model shipped one day after this plugin's model registry was last reviewed, and the registry never knew. In the same week, a provider already wired into SocialForge was selling video at **$0.01/second** while the old cost table assumed **$0.40**. Any price baked into a plugin is wrong on a timetable nobody controls.

The rule

**Never state a cost you did not look up in this session or the last 24 hours.**

Not from this file. Not from the model registry. Not from what you remember a model costing. If `price_book.py` says a price is `unknown` or `stale`, that is the answer — go and read the provider's page, then record what you read.

Looking a price up

1. Find where to look:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action providers

That returns each provider's pricing URL and its auth shape. Two things it will tell you that save time:

• **Auth differs per provider.** `Authorization: Bearer …` for WaveSpeed and Kie,

`Authorization: Key …` for fal.ai, application-default credentials for Vertex. Getting this wrong is the most common reason a first call fails.

• **Kie AI blocks automated fetches** (measured: HTTP 403). Do not report that as

"no price found" — ask the user for the rate instead, and record it with the pricing page as the source.

2. Fetch the pricing page with your own web tools and read the actual number.

3. Record it, with the URL you read it from:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action record \
  --model "kling-3.0-std" --provider wavespeed \
  --unit second --price 0.084 --source https://wavespeed.ai/pricing

A record without a source URL is rejected. That is deliberate — a price with no provenance is a guess wearing a number's clothes.

Quoting before you spend

Single item:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action quote \
  --model "kling-3.0-std" --provider wavespeed --units 55

A whole planned run — **required before `/socialforge:generate-all`**, which fans out across an entire monthly calendar and is the most expensive command in the product:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action quote-batch --items '[
  {"model":"kling-3.0-std","provider":"wavespeed","units":5,"label":"post-01"},
  {"model":"seedance-2.0-fast","provider":"wavespeed","units":6,"label":"post-02"}
]'

Both exit non-zero when they cannot price the work, so a caller can never mistake a refusal for a costed run.

**One unpriced item blocks the whole batch.** A total that quietly omits the three clips nobody could price is worse than no total, because it reads as complete.

Options that change the price

A base rate is not always the whole bill. On at least one wired video model, asking for synchronised audio bills at **1.5× the base per-second rate** — and SocialForge passes `sound` straight through to that API, so a quote taken without it understates a 10-second clip by about half a dollar and a 28-post month by roughly fifteen.

Look the surcharge up on the model's page, then pass it:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action quote \
  --model "kling-v3.0-pro" --provider wavespeed --units 10 \
  --multiplier 1.5 --multiplier-reason "sound=true"

In a batch, put it on the item: `{"model": …, "units": 10, "multiplier": 1.5, "multiplier_reason": "sound=true"}`.

The quote then shows base, multiplier and reason separately, so the user can see what the option cost them. Multipliers are provider facts and move — look them up, do not carry them in your head.

Then stop

A quote is not consent. `approved_to_run` is always `false`, even for a clean batch. Show the user the number and wait for an explicit go.

**One approval covers one run.** If the user approves a batch and then changes the calendar, re-quote and ask again.

Comparing providers before you route

The same model genuinely costs different amounts in different places — Seedance 2.0 Fast has been seen at $0.10/s on one provider and $0.24/s on another. That is a 2.4× difference for identical output.

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action compare --model "seedance-2.0-fast"

Cheapest first, grouped by unit — a per-image price is never "cheaper" than a per-second one, so they are never ranked against each other. If only one provider is on record, the output says so: one price is not a comparison. Look up a second before telling the user something is the cheapest option.

Checking what has gone stale

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action staleness

Run this at the start of a production month. Anything listed as stale needs a fresh lookup before it can appear in a quote.

Draft cheap, finish properly

Iterating a rejected concept at hero-model rates is the quietest way to waste a client's budget. Generate drafts on the cheapest capable model, and only re-run the concept the user actually picked on the expensive one.

Route on a price you looked up, not on a tier name — tier labels in the registry describe capability,