AI Generation
Kuis & Flashcards
LMS Cards School

Alur interaksi guru dari memilih tipe hingga mendapatkan output AI. Dua cabang utama: KUIS (konfigurasi jenis soal) dan FLASHCARDS (total kartu). Keduanya berbagi alur sumber knowledge dan preview.

Jenis soal yang tersedia (KUIS)

Semua angka adalah range estimasi. Faktor penentu: panjang pertanyaan, jumlah opsi, panjang pembahasan, dan bahasa output. Angka di bawah belum termasuk token knowledge source (lihat bagian 03).

Tipe KUIS — token per 1 soal (output)

System Prompt KUIS (base tetap, sekali per request): ~400–650 tk input.

Tipe FLASHCARDS — token per kartu

Perbandingan total token: 10 soal vs 10 kartu (tanpa knowledge)

Token knowledge adalah bagian input yang paling bervariasi. Nilainya bergantung pada panjang konten, kualitas teks, dan apakah dokumen di-chunk sebelum masuk ke prompt. Semua estimasi adalah token yang masuk ke prompt (setelah ekstraksi/processing).

Total input estimate: 10 soal + knowledge source

Skenario acuan: 10 soal KUIS campuran (3 PG + 3 PG Kompleks + 1 T/F + 2 Essay + 1 Isian Singkat) + knowledge Jurnal Guru 1–3 entri.

Semua angka adalah range estimasi operasional per satu request (asumsi di kotak emas di atas). Biaya aktual bergantung pada panjang knowledge source. Untuk envelope worst-case riset (token + plafon lintas model), gunakan §07–§08. IDR = USD × 17.678, dibulatkan ke rupiah penuh.

Proyeksi bulanan (1.000 request)

Strategi pemilihan model per skenario

Kenapa Gemini 2.5 Flash jadi best model?

Skenario: Guru membuat kuis 10 soal campuran (3 PG + 3 PG Kompleks + 1 T/F + 2 Essay + 1 Isian Singkat), tingkat kesulitan Sedang, knowledge dari Jurnal Guru (3 entri). Untuk perbandingan biaya di bawah dipakai satu envelope token worst-case (batas atas range di §02–§03 + buffer ~10–15% pada knowledge dan output) agar estimasi cocok untuk CAPEX / buffer anggaran riset, bukan angka operasional harian.

System Prompt Template (variabel dinamis)

Variabel dalam {{warna ungu}} diisi oleh backend berdasarkan input guru sebelum dikirim ke API.

// ── SYSTEM PROMPT ──────────────────────────────────────────────────
Kamu adalah asisten pembuat soal ujian profesional untuk platform LMS
pendidikan Cards School. Tugasmu adalah menghasilkan soal berkualitas
tinggi yang sesuai dengan materi yang diberikan.

// ── INSTRUKSI GENERATE ────────────────────────────────────────────
TUGAS:
Buat {{total_soal}} soal untuk mata pelajaran {{mata_pelajaran}},
kelas {{kelas}}, tingkat kesulitan {{tingkat_kesulitan}}.

KOMPOSISI SOAL:
{{komposisi_soal}}
// Contoh nilai: "Pilihan Ganda: 3, PG Kompleks: 3, True/False: 1,
//  Essay: 2, Isian Singkat: 1"

SUMBER MATERI (KNOWLEDGE):
{{sumber_knowledge}}
// Diisi dengan teks hasil ekstraksi dari sumber yang dipilih guru.

ATURAN WAJIB:
- Buat soal HANYA berdasarkan materi di atas, tidak mengarang.
- Setiap soal WAJIB memiliki: pertanyaan, jawaban benar, pembahasan.
- Untuk PG dan PG Kompleks: sertakan opsi jawaban [{ "key": "a", "value": "..." }].
- Untuk PG Kompleks: boleh lebih dari 1 correct_answer (array) — ini juga dipakai untuk pola multi-select/checkbox di UI.
- Untuk Essay: sertakan answer_key dan rubric.
- Bahasa: Indonesia formal. Jangan tambahkan teks di luar JSON.
- Output HARUS berupa JSON valid sesuai skema: {{json_schema}}

Estimasi token: breakdown 10 soal campuran (5 jenis)

Perbandingan biaya — envelope worst-case yang sama (semua model)

Tarif per §04. Kolom token identik untuk setiap baris; hanya perbedaan harga per juta token yang membedakan estimasi.

Pada envelope ini, selisih tertinggi vs terendah mencerminkan ~36× antara Gemini 2.5 Flash-Lite dan Claude Sonnet 4.6 — gunakan baris termurah untuk baseline volume, dan baris termahal sebagai plafon anggaran bila tim riset mencoba model premium.

Contoh JSON output — KUIS (10 soal, 5 jenis)

{
  "type": "kuis",
  "metadata": {
    "mata_pelajaran": "Biologi",
    "kelas": "XI IPA",
    "difficulty": "sedang",
    "total_soal": 10,
    "knowledge_source": "teacher_journal",
    "generated_at": "2026-05-18T19:00:00+07:00",
    "usage": {
      "input_tokens": 3050,
      "output_tokens": 4350,
      "total_tokens": 7400,
      "cost_usd": 0.0118,
      "cost_idr": 209,
      "fx_idr_per_usd": 17678
    }
    // Biaya aktual per provider mengikuti tabel "Perbandingan biaya" di atas (bukan duplikasi usage per model).
  },
  "questions": [

    // ─── q1: Pilihan Ganda ────────────────────────────────────────────
    {
      "id": "q1",
      "type": "pilihan_ganda",
      "question": { "text": "Organel sel yang berperan dalam proses respirasi seluler adalah…" },
      "options": [
        { "key": "a", "value": "Ribosom" },
        { "key": "b", "value": "Mitokondria" },
        { "key": "c", "value": "Kloroplas" },
        { "key": "d", "value": "Lisosom" }
      ],
      "correct_answer": "b",
      "explanation": { "text": "Mitokondria adalah tempat utama respirasi aerob menghasilkan ATP melalui siklus Krebs dan rantai transpor elektron." }
    },

    // ─── q2: PG Kompleks ─────────────────────────────────────────────
    {
      "id": "q2",
      "type": "pilihan_ganda_kompleks",
      "question": { "text": "Manakah di antara pernyataan berikut yang BENAR mengenai membran sel?" },
      "options": [
        { "key": "a", "value": "Terdiri dari lapisan fosfolipid bilayer" },
        { "key": "b", "value": "Bersifat selektif permeabel" },
        { "key": "c", "value": "Mengandung protein integral dan periferal" },
        { "key": "d", "value": "Bersifat kaku dan tidak dapat berubah bentuk" },
        { "key": "e", "value": "Dapat mengangkut molekul melalui transpor aktif dan pasif" }
      ],
      "correct_answer": [ "a", "b", "c", "e" ],
      "explanation": { "text": "Membran sel terdiri dari fosfolipid bilayer (a), bersifat selektif permeabel (b), mengandung protein (c), dan dapat melakukan transpor aktif/pasif (e). Pernyataan d salah karena membran sel bersifat fleksibel (fluid mosaic model)." }
    },

    // ─── q3: True/False ──────────────────────────────────────────────
    {
      "id": "q3",
      "type": "true_false",
      "question": { "text": "Fotosintesis hanya dapat terjadi di dalam sel yang memiliki kloroplas." },
      "correct_answer": "true",
      "explanation": { "text": "Benar. Kloroplas adalah organel yang mengandung klorofil — pigmen yang diperlukan untuk menangkap energi cahaya matahari dalam proses fotosintesis." }
    },

    // ─── q4: Essay ───────────────────────────────────────────────────
    {
      "id": "q4",
      "type": "essay",
      "question": { "text": "Jelaskan perbedaan antara transpor aktif dan transpor pasif pada membran sel, beserta contoh molekul yang menggunakan masing-masing mekanisme tersebut!" },
      "answer_key": "Transpor pasif: perpindahan molekul dari konsentrasi tinggi ke rendah tanpa energi ATP (difusi, osmosis, difusi terfasilitasi). Contoh: O₂, CO₂, air (aquaporin). Transpor aktif: perpindahan melawan gradien konsentrasi, membutuhkan energi ATP. Contoh: pompa Na⁺-K⁺, transpor glukosa aktif.",
      "rubric": [
        { "criteria": "Definisi transpor pasif benar", "max_score": 25 },
        { "criteria": "Definisi transpor aktif benar", "max_score": 25 },
        { "criteria": "Contoh transpor pasif tepat (≥1)", "max_score": 25 },
        { "criteria": "Contoh transpor aktif tepat (≥1)", "max_score": 25 }
      ],
      "explanation": { "text": "Perbedaan utama ada pada kebutuhan energi dan arah perpindahan. Transpor pasif mengikuti gradien konsentrasi (spontan), sedangkan aktif melawan gradien (memerlukan ATP)." }
    },

    // ─── q5: Isian Singkat ───────────────────────────────────────────
    {
      "id": "q5",
      "type": "isian_singkat",
      "question": { "text": "Proses pembelahan sel yang menghasilkan dua sel anak dengan jumlah kromosom sama seperti sel induk disebut …" },
      "correct_answer": "mitosis",
      "accepted_answers": [ "mitosis", "pembelahan mitosis" ],
      "explanation": { "text": "Mitosis menghasilkan 2 sel anak diploid (2n) identik dengan sel induk. Berbeda dengan meiosis yang menghasilkan 4 sel haploid (n)." }
    },

    // ─── q6: PG Kompleks (multi-jawaban) ─────────────────────────────
    {
      "id": "q6",
      "type": "pilihan_ganda_kompleks",
      "question": { "text": "Pilih SEMUA organel yang umumnya hanya ditemukan pada sel tumbuhan (bukan sel hewan)!" },
      "options": [
        { "key": "a", "value": "Kloroplas" },
        { "key": "b", "value": "Dinding sel" },
        { "key": "c", "value": "Mitokondria" },
        { "key": "d", "value": "Vakuola sentral besar" }
      ],
      "correct_answer": [ "a", "b", "d" ],
      "explanation": { "text": "Kloroplas (a), dinding sel (b), dan vakuola sentral besar (d) khas tumbuhan. Mitokondria (c) ada di sel hewan dan tumbuhan." }
    },

    // ─── q7–q10: soal ke-2 dari tipe yang sama (ringkas) ─────────────
    { "id": "q7", "type": "pilihan_ganda", "question": { "text": "..." }, "options": [ { "key": "a", "value": "..." }, … ], "correct_answer": "c", "explanation": { "text": "..." } },
    { "id": "q8", "type": "pilihan_ganda", "question": { "text": "..." }, "options": [ { "key": "a", "value": "..." }, … ], "correct_answer": "a", "explanation": { "text": "..." } },
    { "id": "q9", "type": "pilihan_ganda_kompleks", "question": { "text": "..." }, "options": [ …5 opsi… ], "correct_answer": [ "b", "d" ], "explanation": { "text": "..." } },
    { "id": "q10", "type": "essay", "question": { "text": "..." }, "answer_key": "...", "rubric": [ … ], "explanation": { "text": "..." } }

  ]
}

Skenario: Guru membuat 10 kartu flashcard tingkat kesulitan Mudah, knowledge dari Link YouTube (video 8 menit dengan CC). Sama seperti §07, angka di bawah memakai envelope worst-case (transkrip ke ujung range + buffer) untuk perencanaan anggaran riset.

System Prompt Template (variabel dinamis)

// ── SYSTEM PROMPT ──────────────────────────────────────────────────
Kamu adalah asisten pembuat flashcard edukatif untuk platform LMS
Cards School. Tugasmu adalah menghasilkan kartu belajar (flashcard)
berkualitas tinggi yang memudahkan siswa mengingat konsep penting.

// ── INSTRUKSI GENERATE ────────────────────────────────────────────
TUGAS:
Buat {{total_kartu}} kartu flashcard untuk topik {{topik}},
tingkat kesulitan {{tingkat_kesulitan}}.

SUMBER MATERI (KNOWLEDGE):
{{sumber_knowledge}}
// Diisi dengan teks hasil ekstraksi (transkrip CC YouTube, dll.).

ATURAN WAJIB:
- Setiap kartu berupa pertanyaan spesifik di sisi depan (front).
- Sisi belakang (back) berisi: jawaban singkat, pembahasan, dan konsep kunci.
- Pertanyaan harus atomic — satu konsep per kartu, tidak bertele-tele.
- Hindari pertanyaan terlalu umum seperti "Apa itu X?" — jadikan lebih spesifik.
- Bahasa: Indonesia formal. Jangan tambahkan teks di luar JSON.
- Output HARUS berupa JSON valid sesuai skema: {{json_schema}}

Estimasi token: breakdown 10 kartu

Perbandingan biaya — envelope worst-case yang sama (semua model)

Flashcard tetap lebih murah dari KUIS pada envelope worst-case karena output jauh lebih pendek, meskipun input knowledge YouTube bisa besar.

Perbandingan: Flashcard vs KUIS 10 soal

Contoh JSON output — FLASHCARDS (10 kartu)

{
  "type": "flashcards",
  "metadata": {
    "topik": "Sistem Pencernaan Manusia",
    "difficulty": "mudah",
    "total_kartu": 10,
    "knowledge_source": "youtube_cc",
    "knowledge_url": "https://www.youtube.com/watch?v=xyz789abc12",
    "generated_at": "2026-05-18T19:30:00+07:00",
    "usage": {
      "input_tokens": 4450,
      "output_tokens": 2000,
      "total_tokens": 6450,
      "cost_usd": 0.00125,
      "cost_idr": 22,
      "fx_idr_per_usd": 17678
    }
    // Biaya aktual per provider mengikuti tabel "Perbandingan biaya" di §08 (bukan duplikasi usage per model).
  },
  "cards": [

    // ─── fc1: kartu detail pertama ────────────────────────────────────
    {
      "id": "fc1",
      "front": {
        "text": "Di organ manakah proses pencernaan protein dimulai secara kimiawi?"
      },
      "back": {
        "text": "Lambung (gaster)",
        "explanation": "Enzim pepsin yang dihasilkan lambung dalam suasana asam (HCl) memecah protein menjadi polipeptida. Pencernaan mekanis dimulai di mulut, tetapi kimiawi untuk protein baru efektif di lambung.",
        "key_concept": "Pencernaan kimiawi protein — pepsin — lambung"
      }
    },

    // ─── fc2: kartu detail kedua ──────────────────────────────────────
    {
      "id": "fc2",
      "front": {
        "text": "Sebutkan 3 fungsi utama usus halus dalam pencernaan!"
      },
      "back": {
        "text": "(1) Pencernaan kimiawi akhir oleh enzim pankreas dan empedu, (2) Penyerapan nutrisi (glukosa, asam amino, asam lemak) melalui villi dan mikrovilli, (3) Sekresi hormon pencernaan (sekretin, kolesistokinin).",
        "explanation": "Usus halus terdiri dari duodenum, jejunum, ileum. Permukaan villi meningkatkan luas penyerapan hingga 200 m².",
        "key_concept": "Usus halus — absorpsi nutrisi — villi"
      }
    },

    // ─── fc3–fc10: kartu ringkas (pola sama) ─────────────────────────
    { "id": "fc3", "front": { "text": "Apa fungsi empedu dalam pencernaan lemak?" }, "back": { "text": "Mengemulsifikasi lemak menjadi tetesan kecil agar mudah dicerna lipase pankreas.", "explanation": "...", "key_concept": "Emulsifikasi lemak — empedu" } },
    { "id": "fc4", "front": { "text": "..." }, "back": { "text": "...", "explanation": "...", "key_concept": "..." } },
    { "id": "fc5", "front": { "text": "..." }, "back": { "text": "...", "explanation": "...", "key_concept": "..." } },
    // … fc6–fc10 mengikuti pola yang sama …
    { "id": "fc10", "front": { "text": "..." }, "back": { "text": "...", "explanation": "...", "key_concept": "..." } }

  ]
}