postreef
View as Markdown

FAQ

Short answers to the questions we get most. Something missing? The quickstart and pricing pages cover the rest.

Which platforms are supported?

YouTube (including Shorts), TikTok, Instagram Reels and many more video platforms. Any publicly accessible video URL is worth trying. The probe (POST /v1/probe, or the home page in the web app) tells you immediately whether we can work with it.

Why did my run fail?

The usual causes: the video is private or was removed, the URL points to something we don't support (a channel page, a playlist, a non-video link), or a transient error happened while fetching. Whatever the reason, failed runs are always refunded in full, automatically, so retrying costs you nothing extra.

What if the video doesn't match my schema?

That's a normal, successful outcome, not a failure. If you run, say, the recipe schema on a video that isn't a recipe, the AI won't invent one: the result comes back with outcome: "no_match" (or "uncertain" when the inputs were too thin to be sure), extraction: null, and a one-sentence verdictReason explaining why. In the web app you'll see a "No match" card instead of extracted data. Because real work was done to reach that verdict, the run is billed like any other and isn't refunded. Tip: adding audio or video to your inputs gives the model more to judge and cuts down on uncertain.

Why is my transcript not in English?

Transcripts are built from the video's captions in the video's original language. AI extraction understands that language just fine, so if you want the structured output in English (or any other language), say so in your schema's field descriptions, e.g. "summary of the recipe, in English".

Why was I charged less than quoted?

When a platform doesn't report the video's duration up front, we quote a worst case of 5 minutes. During the run we measure the real duration and refund the difference automatically. That refund is what you see in your credit history. You're never charged more than the quote, only less.

What's a cached result?

If you recently ran the exact same extraction (same video, same inputs, same schema), we serve the stored result instead of re-running everything. Cached results are instant and free. If you want a fresh run anyway (say, to pick up new comments), set force: true on the request (or tick the force re-run option in the web app).

How do I get more credits?

Head to Billing. Your balance, full credit history and top-up options live there.

Are there limits?

Yes, two: at most 2 runs at the same time per account, and fair-use rate limits on how fast you can submit new runs. Both exist to keep extractions fast for everyone; normal usage never hits them.