Generate a quiz

Why testing comprehension gets skipped

Course creators, HR teams running onboarding, and internal training programs all produce far more reading material than assessment material, because writing a good question is genuinely harder than writing the fact it tests — a bad question either gives away the answer in its phrasing or tests trivia instead of understanding. That asymmetry means comprehension checks are usually the first thing cut under time pressure. This endpoint exists to close that gap without asking anyone to become a professional item-writer.

From source text to a finished quiz

You POST your source material to /text/quiz, and the task runs asynchronously. Once processing finishes, a set of questions with their correct answers — grounded in the submitted text, not invented facts — arrives via webhook or a signed link. The output maps directly back to the source, so every question can be traced to the passage it came from, which matters when a quiz is going to be used to certify that someone actually learned the material.

A format older than digital learning

The question-and-answer format for checking understanding predates any software — teachers have used recitation and short-answer checks since well before the printing press, and the multiple-choice test as a standardized format dates back over a century, developed originally to test large groups of people quickly and consistently. What's changed is not the format's logic but the cost of producing it: a task that once took a teacher an evening per chapter can now run against any text you already have.

Where it sits in a learning or automation pipeline

Because the endpoint is async and billed per call, it's built for scale: an e-learning platform generates a quiz automatically every time a new lesson is published, or an HR system builds an onboarding check the moment a new policy document goes live. A failed generation is retried automatically up to three times and never billed, so running this against a full course library stays predictable in cost even at volume.

What kind of quiz to expect

Expect questions that test whether the source material was understood, with answers traceable to the text rather than external trivia — the quiz reflects exactly what you fed it, so a thin source produces a thin quiz and a thorough one produces a thorough quiz. It's a tool for checking retention of specific content, not a general knowledge test generator.