V1 vs V2 vs V3 vs V4 — Which Should You Use?
With four distinct endpoints available, it can be confusing to know which one is right for your specific application. This guide provides a direct comparison to help you optimize for speed, intelligence, or cost.
Quick Comparison Matrix
2.5.1Here is a high-level overview of what each version offers:
| Feature | V1 | V2 | V3 | V4 |
|---|---|---|---|---|
| Basic Question Data | ✅ | ✅ | ✅ | ✅ |
| Syllabus Topics | ❌ | ✅ | ✅ | ✅ |
| Difficulty Stats | ❌ | ❌ | ✅ | ✅ |
| AI Hints & NLP | ❌ | ❌ | ❌ | ✅ |
| Average Latency | ~40ms | ~55ms | ~90ms | ~600ms |
When to use V1
2.5.2Use V1 when you are building a strict, timed Computer Based Test (CBT) simulator where speed is the only thing that matters. If you are simulating a real JAMB exam, the student doesn't need AI hints or difficulty ratings during the exam—they just need the questions to load instantly.
When to use V4
2.5.3Use V4 when you are building an interactive study companion, a chatbot, or an adaptive learning platform. If your goal is to actually teach the student rather than just test them, the AI hints and conceptual mapping provided by V4 are invaluable, and the slightly higher latency is an acceptable trade-off.