SYSTEM · ONLINE// HELPBUILD · 2.1.β--:--:-- UTC

// HELP

How TokBench works.

Everything you need to use TokBench — upload formats, modes, reading your report, sharing, accounts, privacy, and what to do when something breaks.

// GETTING_STARTED

Drop in your TikTok ad — four ways

  • Upload video — MP4, MOV, or WebM. Frames get extracted in your browser (your original file never leaves the device); only the JPEG keyframes upload. Works best on clips under 60 seconds.
  • TikTok URL— paste any public TikTok video URL. We pull the cover frame + caption via TikTok's own oEmbed endpoint. For per-frame analysis, use the Video tab.
  • Image — JPG, PNG, WebP, or GIF. Good for Spark Ad stills, planned thumbnails, or storyboard frames.
  • Script— paste a script before you film. We'll score the hook, structure, and CTA so you can rewrite before burning a shoot day.

// MODES

Quick check vs Deep dive

Quick check

~10 seconds

Overall 0–100 score, one-line summary, 5-category scorecard (Hook · Native feel · Clarity · CTA · Brand fit), 3–5 actionable things to fix. Runs on Claude Haiku 4.5. Pick this when you want a fast read before re-shooting or before kicking spend.

Deep dive

~30–60 seconds

Hook-rate prediction, hook-formula classification, 6-category rubric with evidence, 10 predicted performance metrics, production analysis, algorithm signals, business projections, risk flags, ranked top issues with fixes, 3 hook rewrites + new caption + 3 CTA variants + shot-list edits, vertical benchmark match. Runs on Claude Opus 4.7. Pick this for a real review before launch or when planning a campaign.

// READING_YOUR_REPORT

What the numbers mean

All scores are 0–100, color-coded so you can read the verdict at a glance:

  • 75–100 — strong. Ship it. Rare for first drafts.
  • 50–74 — fixable. Address the top issues and re-score.
  • 0–49 — overhaul needed. The model will tell you exactly what to change.

Every score carries a one-sentence justification — the model doesn't leave you guessing why a category dropped. In Deep mode, scores also point at evidence: a frame timestamp or a transcript span.

Hook rate in Deep mode is the predicted % of viewers who keep watching past 3 seconds. 30%+ is strong. 40%+ is the kind of ad that goes viral.

// SHARING

Share a report

Hit SHARE_REPORT on any report. We mint a 10-character share URL like tokbench.ai/r/abc123xyz that anyone can open without signing in. Read-only. Lasts 1 year.

If you're signed in, we also save the report to your account so you can come back to it from /account/reports. Each saved report shows its view count.

To export as PDF, sign in, open the saved report, and click PRINT— it opens a print-optimized view that auto-fires your browser's print dialog. Pick "Save as PDF" from there.

// ACCOUNTS

Sign in

Three ways to sign in, all free:

  • Magic link — enter your email at /login, we send a one-click sign-in link. The link expires in 15 minutes and works once. No password.
  • Continue with Google — uses your verified Google email.
  • Continue with TikTok— uses your TikTok identity (no email needed; we use TikTok's stable user ID instead).

Signed-in benefits: higher daily analysis limit, saved report history, view counts on shared links, PDF export, side-by-side comparison at /compare.

// PRIVACY

Where your data goes

For video uploads: your original file never leaves the browser. Frame extraction happens client-side; only the JPEG keyframes (~80–150 KB each) upload to Vercel Blob storage at unguessable URLs.

The audio track is extracted client-side and sent to OpenAI Whisper for voiceover transcription, then dropped.

Anthropic's commercial API terms forbid training on the content we send them. We don't fingerprint, retain, or resell the creative content of analyses.

To delete: email legal@tokbench.ai with the share URL or saved-report ID.

// COMMON_ISSUES

If something’s broken

"The analysis took too long and timed out"

Try a shorter video (under 60 seconds works best), or switch to the URL or Image tab. Long videos hit Vercel's 300-second function ceiling on busy days.

"You’ve hit today’s analysis limit"

Free anonymous quota is 2/day. Sign in for a higher cap. Tomorrow at midnight UTC the counter resets.

"That sign-in link expired or was already used"

Magic links are good for 15 minutes and one click. Request a new one — it'll arrive within 10 seconds.

"TikTok did not return caption/thumbnail"

The post is private, removed, or geo-blocked. Try a different URL, or download the video and use the Video tab instead.

The Continue with Google / TikTok button isn’t there

That provider's env isn't configured on this server. Use email magic-link instead — same account either way.

// CONTACT

Talk to a human

TokBench is a Bloody Fingers Software production. For anything this page doesn't answer: