| 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
- 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.
-
Fetch the pricing page with your own web tools and read the actual number.
-
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, not cost, and the two do not track each other reliably.
What this skill will not do
- Quote from memory, from the registry, or from this file
- Present a partial total as the cost of a run
- Treat a quote as approval
- Call one provider cheapest on the strength of a single price
- Report a fetch failure as an absence of cost
