Exam version mixer API

Shuffle questions and options into N exam versions with codes (mã đề) and answer keys, reproducible from a seed. JSON or a zip of .docx exams.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/vn-exam-mix" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4.","versions":2,"seed":"demo-2026","code_start":101}'

const res = await fetch('https://apibox.io.vn/v1/vn-exam-mix', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "text": "Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4.",
    "versions": 2,
    "seed": "demo-2026",
    "code_start": 101
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-exam-mix",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text": "Câu 1. Thủ đô của Việt Nam là\nA. TP. Hồ Chí Minh\t*B. Hà Nội\nC. Đà Nẵng\tD. Huế\nCâu 2. 2 + 2 = ?\nA. 3\nB. 4\nC. 5\nD. 6\nĐáp án: B\nLời giải: 2 + 2 = 4.", "versions": 2, "seed": "demo-2026", "code_start": 101},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-exam-mix');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"text":"Câu 1. Thủ đô của Việt Nam là\\nA. TP. Hồ Chí Minh\\t*B. Hà Nội\\nC. Đà Nẵng\\tD. Huế\\nCâu 2. 2 + 2 = ?\\nA. 3\\nB. 4\\nC. 5\\nD. 6\\nĐáp án: B\\nLời giải: 2 + 2 = 4.","versions":2,"seed":"demo-2026","code_start":101}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "seed": "demo-2026",
  "version_count": 2,
  "codes": [
    "101",
    "102"
  ],
  "question_count": 2,
  "settings": {
    "shuffle_questions": true,
    "shuffle_options": true,
    "shuffle_statements": false,
    "numbering_restarts_per_part": false
  },
  "answer_table": [
    [
      "Câu",
      "101",
      "102"
    ],
    [
      "1",
      "D",
      "A"
    ],
    [
      "2",
      "D",
      "B"
    ]
  ],
  "versions": [
    {
      "code": "101",
      "questions": [
        {
          "number": 1,
          "original_number": 1,
          "section": 0,
          "type": "multiple_choice",
          "points": null,
          "stem": "Thủ đô của Việt Nam là",
          "options": [
            {
              "label": "A",
              "text": "TP. Hồ Chí Minh",
              "original_label": "A"
            },
            {
              "label": "B",
              "text": "Huế",
              "original_label": "D"
            },
            {
              "label": "C",
              "text": "Đà Nẵng",
              "original_label": "C"
            },
            {
              "label": "D",
              "text": "Hà Nội",
              "original_label": "B"
            }
          ],
          "answer": [
            "D"
          ],
          "answer_text": null,
          "group": null
        },
        {
          "…": "…"
        }
      ],
      "answer_key": "1.D 2.D"
    },
    {
      "code": "102",
      "questions": [
        {
          "…": "…"
        }
      ],
      "answer_key": "1.A 2.B"
    }
  ],
  "note": "Same seed + same questions + same codes = same versions. Options such as \"Tất cả đều đúng\" keep their position; questions whose options refer to other letters (\"Cả A và B\") keep their option order; reading groups stay together."
}

Use cases

• Print several exam codes for a class without desktop mixers
• Generate answer keys for an optical-mark or app grader
• Run online tests where each student gets a shuffled version
• Rebuild a past mix from its seed when a key is lost

FAQ

Related APIs