@facelessad/cli 2.1.0 → 2.1.2

package/README.md

@@ -41,7 +41,7 @@ Three ways to get the file:
 
 ```bash
 facelessad download 103 --out ad.mp4        # saves into the CURRENT directory
-facelessad status 103 --json | jq -r .url   # the raw link, valid ~1 hour
+facelessad status 103 --json | jq -r .url   # the raw link, valid ~24 hours
 ```
 
 The third is the browser: every video made through the CLI also appears in My

package/SKILL.md

@@ -14,10 +14,11 @@ facelessad login                   # API key from https://facelessad.com/develop
 facelessad balance                 # proves the key works
 ```
 
-**The API needs a paid plan.** Trial credits cover the web app but do not
-open API keys — if a command answers `api_access_required`, the user has to
-subscribe first. That is a billing state, not a broken key, so say so rather
-than retrying.
+**The API needs a paid plan or an active trial.** The $15 trial (300
+credits, 7 days) opens API keys, the CLI and MCP for its duration. If a
+command answers `api_access_required`, the subscription has ended or the
+trial has expired or run out of credits — a billing state, not a broken
+key, so say so rather than retrying.
 
 In CI, skip `login` and set `FACELESSAD_API_KEY`; the environment variable
 wins over the saved key.
@@ -162,8 +163,8 @@ no voice, no script, no music and no SFX.
 
 `--voiceover-text "<script>"` (or `--voiceover-file <path>`) makes the
 narration **word-for-word** — the AI script writer is skipped and not
-charged. The word limit follows the duration: 15 s fits ~40 words, 30 s ~60,
-50 s ~95. Over the limit is a clear error, never a silent trim, so count
+charged. The word limit follows the duration: 15 s fits ~45 words, 30 s ~80,
+50 s ~130. Over the limit is a clear error, never a silent trim, so count
 before sending. Not on music-video (its script is sung) or video-banner.
 
 `--visual-direction` steers the storyboard and `--hook-text` the first frame.
@@ -291,9 +292,10 @@ names the offending field and usually the valid values.
 
 **Access and capacity**
 
-- `api_access_required` — no active paid plan. Trial credits do not open the API.
+- `api_access_required` — no active paid plan or live trial. An active $15 trial opens the API for its 7 days.
 - `insufficient_credits` — the body carries the estimate and the balance; nothing was spent.
 - `too_many_active` — the plan's queue is full (Starter 10, Growth 25, Scale 50; app and API share it). Wait for a build to finish, then retry.
+- `test_quota_exceeded` — 100 test runs per day per account (`"test": true` only). Real runs are unaffected; the quota resets at 00:00 UTC and the body carries `retryAfter`.
 - `rate_limited` — over 300 POSTs this hour (`estimate` has its own 600). `retryAfter` gives the seconds until the counter resets on the hour.
 - `unauthorized` — the key is unknown or revoked.
 

package/index.js

@@ -861,7 +861,7 @@ Create flags:
   --video-mode continuous|cuts     (animated-ad and music-video only)
   --voiceover-text "<script>"      (your own narration, spoken word-for-word —
        the AI script writer is skipped and not charged. Word limit follows
-       duration: 15s fits 40 words, 30s fits 60, 50s fits 95. Over the limit
+       duration: 15s fits 45 words, 30s fits 80, 50s fits 130. Over the limit
        is an error, never a silent trim. Not on music-video or video-banner.)
   --voiceover-file <path>          (same, read from a local text file)
   --visual-direction "<...>"       (how the video should LOOK and what happens
@@ -950,7 +950,7 @@ function statusLine(d) {
   let s = 'Video ' + d.id + ': ' + bold(d.status);
   if (d.phase && !done) s += ' ' + dim('(' + d.phase + ')');
   if (d.url) s += '\n' + dim('Download: ') + 'facelessad download ' + d.id + ' --out ad.mp4'
-    + '\n' + dim('(the direct link is in --json output; it expires in ~1 h)');
+    + '\n' + dim('(the direct link is in --json output; it expires in ~24 h)');
   if (d.error) s += '\n' + d.error;
   return s;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facelessad/cli",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Create faceless video ads from your terminal or build scripts \u2014 the FacelessAd command line.",
   "license": "MIT",
   "type": "module",