| Symptom | Cause & fix |
|---|
| “unsupported URL” | Only Twitch VODs, YouTube links, and direct video-file links are accepted. Check for typos or download + upload the file instead. |
| YouTube import fails | Platform bot-protection sometimes blocks server-side fetches of public videos. Nothing is charged; uploading the file always works. |
| Upload stalls at 0% | Usually a blocked connection to storage (corporate proxy/VPN). Pause/resume retries automatically; switching networks helps. |
| “the upload never finished” | The tab closed before the file finished sending. Uploads must complete browser-side; start it again and keep the tab open until 100%. |
| Symptom | Cause & fix |
|---|
| Analysis failed with a provider error | Transient AI-provider outages retry automatically with backoff. If it still failed, the Retry button re-runs the analysis; minutes were already refunded. |
| Very few (or zero) clips | The quality gate rejected weak candidates rather than padding. Check the rejected clips’ evidence — if you disagree, rate them up and lower your preset’s minimum score. |
| Clip stuck “rendering” | Renders normally take a few minutes. Anything stuck beyond a few hours is closed by our housekeeping sweep and becomes retryable. |
| “Analysis never started” | The job was lost before the engine picked it up (rare; e.g. mid-deploy). Housekeeping closes it within two hours and Retry re-runs it. |
| Symptom | Cause & fix |
|---|
| Captions misspell names/jargon | Speech models struggle with proper nouns. Fix the hook title and post caption in the Studio; caption re-timing keeps everything in sync on re-render. |
| Clip starts or ends oddly | Nudge the boundaries in the Studio and re-render — the AI aims for the whole arc (setup through payoff), but you always get the final cut. |
| The wrong part of the frame is centered | Shorts use center-weighted framing with an adjustable crop focus in the Studio; drag it toward the action and re-render. |
| Symptom | Cause & fix |
|---|
| “you’ve used all your minutes” | The meter resets on your period date (shown in the sidebar). Upgrade, buy extra minutes ($1 per 100), turn on auto overage in Settings → Billing, or wait for the reset. |
| Payment failed | Stripe retries per its schedule and emails you. Update the card in Settings → Billing → Manage. |
| Download link expired | Links are signed and short-lived by design. Click Download again for a fresh one. |
Still stuck? Every failure in the product carries an honest error message — include it (and the project link) when you contact support and we can trace the exact job.