@wavespeed/cli 0.4.11 → 0.4.13

package/README.md

@@ -165,14 +165,10 @@ wavespeed init                           Create a wavespeed.json with defaults +
 wavespeed skill install                  Drop SKILL.md for coding agents
 ```
 
-**Pricing is an estimate.** `wavespeed price` quotes from the model's pricing
-formula, and many models bill from an input — audio/video duration, frame count,
-text length. Those inputs are optional in the quote: ask for a price without
-them and the formula collapses to the model's **base price**, which is the floor
-of its range, not a typical run. `wavespeed price wavespeed-ai/infinitetalk`
-says `$0.15`; a 60s audio actually bills `$1.80`. The command names the inputs it
-was blind to (`unpriced_inputs` / `at_base_price` in `--json`) — supply them for
-a real quote. Whatever it says, the amount actually charged for a run is
+**Pricing is an estimate.** `wavespeed price` quotes the inputs you pass, and many
+models bill from an input — audio/video duration, frame count, text length. Pass
+the same inputs you would pass to `wavespeed run`: a quote made without them can
+be lower than the real charge. The amount actually charged for a run is
 authoritative.
 
 ## Auth

package/dist/commands/price.js

@@ -1,7 +1,6 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import { fetchPricing, fetchModels } from '../lib/api.js';
-import { missingPriceVars, isFloorQuote } from '../lib/pricing-vars.js';
+import { fetchPricing, modelDocsUrl } from '../lib/api.js';
 import { parseInputs } from '../lib/inputs.js';
 import { resolveModelToken } from '../lib/config.js';
 import { collectLocalFiles, resolveLocalFiles } from '../lib/local-files.js';
@@ -74,33 +73,14 @@ export function registerPrice(program) {
         const spinner = !opts.json ? ora('Calculating price…').start() : null;
         try {
             const data = await fetchPricing(resolved.model, inputs);
-            // /model/price evaluates the model's formula against whatever inputs we
-            // send and never complains about the ones we left out — a formula with
-            // every variable missing collapses to base_price. That is the floor of
-            // the model's range, not a representative charge, so name the inputs
-            // this quote could not see rather than presenting the floor as "the"
-            // price. Catalog is cached 1h; a lookup failure only costs the detail.
-            let unpriced = [];
-            let atFloor = false;
-            try {
-                const { models } = await fetchModels();
-                const meta = models.find((m) => m.model_id === resolved.model);
-                const props = meta?.api_schema?.api_schemas?.[0]?.request_schema?.properties;
-                unpriced = missingPriceVars(meta?.formula, inputs, props);
-                atFloor = isFloorQuote(meta?.formula, inputs);
-            }
-            catch {
-                /* no catalog — fall back to the generic disclaimer below */
-            }
             spinner?.stop();
             const disclaimer = 'Estimate only, for reference — the amount actually charged for a run is authoritative.';
             if (opts.json) {
                 process.stdout.write(JSON.stringify({
                     ...data,
                     estimate: true,
-                    unpriced_inputs: unpriced,
-                    at_base_price: atFloor,
                     disclaimer,
+                    docs_url: modelDocsUrl(resolved.model),
                     uploaded: uploadedUrls,
                 }, null, 2) + '\n');
                 return;
@@ -113,19 +93,6 @@ export function registerPrice(program) {
                 (data.discounted_price > 0 && data.discounted_price !== data.price
                     ? chalk.gray(`  (list $${data.price})`)
                     : ''));
-            if (unpriced.length > 0) {
-                console.log('  ' +
-                    chalk.yellow('note:    ') +
-                    chalk.yellow(`this model is priced from ${unpriced.join(', ')}, which ${unpriced.length === 1 ? 'was' : 'were'} not supplied.`));
-                console.log('           ' +
-                    chalk.gray(atFloor
-                        ? 'The figure above is the base price — the floor of this model’s range, not a typical run.'
-                        : 'The figure above prices the rest at their defaults and can move once these are set.'));
-                console.log('           ' +
-                    chalk.gray('Pass ') +
-                    chalk.cyan(unpriced.map((v) => `-i ${v}=…`).join(' ')) +
-                    chalk.gray(' for a representative quote.'));
-            }
             console.log();
             for (const [file, url] of Object.entries(uploadedUrls)) {
                 console.log('  ' + chalk.gray('uploaded: ') + chalk.gray(file + ' → ') + chalk.cyan(url));
@@ -135,6 +102,7 @@ export function registerPrice(program) {
             }
             console.log();
             console.log(chalk.gray('Run it: ') + chalk.cyan(`wavespeed run ${modelArg}` + (opts.prompt ? ` -p "${opts.prompt}"` : '')));
+            console.log(chalk.gray('Model docs:    ') + chalk.cyan(modelDocsUrl(resolved.model)));
             console.log(chalk.gray(disclaimer));
             console.log();
         }

package/dist/commands/schema.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import { fetchModels } from '../lib/api.js';
+import { fetchModels, modelDocsUrl } from '../lib/api.js';
 function getRequestSchema(model) {
     return model.api_schema?.api_schemas?.[0]?.request_schema;
 }
@@ -116,6 +116,7 @@ export function registerSchema(program) {
             chalk.white(model.type ?? 'unknown') +
             (model.base_price !== undefined ? chalk.gray('   base price: ') + chalk.green(`$${model.base_price}`) : ''));
         console.log(chalk.gray('  page:  ') + chalk.cyan(`https://wavespeed.ai/models/${model.model_id}`));
+        console.log(chalk.gray('  docs:  ') + chalk.cyan(modelDocsUrl(model.model_id)));
         if (model.description) {
             console.log(wrap(model.description, '  '));
         }

package/dist/lib/api.js

@@ -130,6 +130,13 @@ async function apiPost(path, body, opts = {}) {
 export async function fetchBalance() {
     return apiGet('/api/v3/balance');
 }
+// The model's page on the docs site (same rule as the dashboard's model page
+// link): provider folder, then the id without a leading "wavespeed-ai/" and
+// with "/" turned into "-".
+export function modelDocsUrl(modelId) {
+    const provider = modelId.split('/')[0];
+    return `https://wavespeed.ai/docs/docs-api/${provider}/${modelId.replace('wavespeed-ai/', '').split('/').join('-')}`;
+}
 export async function fetchPricing(modelId, inputs) {
     // /model/price is the documented pricing endpoint; /model/pricing is a
     // legacy contract kept for old clients and absent from the public docs.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavespeed/cli",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "WaveSpeed CLI — one command to run any WaveSpeed AI model from your terminal.",
   "publishConfig": {
     "access": "public"

package/dist/lib/pricing-vars.js

@@ -1,75 +0,0 @@
-// Pricing formulas are JSONata expressions returned by /api/v3/models, e.g.
-//   {"total_price": $max([5, $min([$ceil(get_duration_v3(audio)), 600])]) / 5 * base_price}
-//   {"total_price": base_price * duration / 5}
-//
-// The pricing endpoint evaluates them server-side and happily accepts a partial
-// (or empty) `inputs` object — a formula whose variables are all missing
-// collapses to `base_price`, which is the floor of the model's price range, not
-// a typical charge. `wavespeed price wavespeed-ai/infinitetalk` with no inputs
-// quotes $0.15 while a 60s audio actually costs $1.80. So we parse the formula
-// to find which inputs move the price, and say which ones the quote is blind to.
-const RESERVED = new Set(['base_price', 'total_price', 'true', 'false', 'null']);
-/**
- * Variable names a pricing formula reads from the model's inputs, in first-seen
- * order. Excludes JSONata builtins (`$max`), helper calls (`get_duration_v3`),
- * string literals, and `base_price`/`total_price`.
- *
- * Returns [] for a flat-priced model (`base_price * 1`) or an unparseable
- * formula — callers should treat [] as "nothing input-dependent to warn about".
- */
-export function extractPriceVars(formula) {
-    if (!formula)
-        return [];
-    // Drop string literals first so "720p" / "total_price" keys never register.
-    const stripped = formula.replace(/"(?:[^"\\]|\\.)*"/g, '""').replace(/'(?:[^'\\]|\\.)*'/g, "''");
-    const vars = [];
-    const seen = new Set();
-    const re = /(\$?)([A-Za-z_][A-Za-z0-9_]*)\s*(\()?/g;
-    let m;
-    while ((m = re.exec(stripped)) !== null) {
-        const [, dollar, name, call] = m;
-        if (dollar)
-            continue; // $max, $ceil, $length — JSONata builtin
-        if (call)
-            continue; // get_duration_v3(...) — server-side helper
-        if (RESERVED.has(name))
-            continue;
-        if (seen.has(name))
-            continue;
-        seen.add(name);
-        vars.push(name);
-    }
-    return vars;
-}
-/**
- * Price-driving variables the quote is genuinely blind to.
- *
- * A driver the caller omitted but that carries a schema default is NOT blind —
- * the server priced it at that default, which is exactly what a run would use.
- * Only drivers with no default (infinitetalk's `audio`, seedance's
- * `reference_videos`) leave the quote uninformed, and those are the ones that
- * silently collapse the formula toward base_price.
- */
-export function missingPriceVars(formula, inputs, schemaProps) {
-    return extractPriceVars(formula).filter((v) => {
-        const val = inputs[v];
-        if (val !== undefined && val !== null && val !== '')
-            return false;
-        const prop = schemaProps?.[v];
-        return !(prop && 'default' in prop);
-    });
-}
-/**
- * True when every price driver is unsupplied — the case where the formula
- * degenerates to `base_price` and the quote is the floor of the model's range
- * rather than a representative charge.
- */
-export function isFloorQuote(formula, inputs) {
-    const vars = extractPriceVars(formula);
-    if (vars.length === 0)
-        return false;
-    return vars.every((v) => {
-        const val = inputs[v];
-        return val === undefined || val === null || val === '';
-    });
-}