Imágenes de pregunta
¿Necesitas una serie con un espacio en blanco, una frase incompleta o un fragmento de código con una pieza menos? Estas plantillas dibujan esa imagen igual todas las veces.
Pide una imagen
Envía una plantilla y unos datos. La misma entrada siempre dibuja la misma imagen.
POST /api/v1/quizzes/{quizId}/images/templates
Authorization: Bearer <quiz-scoped-key>
Content-Type: application/json
{
"templateId": "universal.tiles",
"data": {
"rows": [
[
"2",
"4",
"8",
"?"
]
]
}
}Guárdala, o solo previsualízala
Guarda la imagen con el quiz, o pide una vista previa temporal mientras retocas el diseño.
output: "image"Lo habitual es un WebP guardado con el quiz, devuelto como identificador de imagen.
output: "png" | "svg"PNG y SVG vuelven como bytes de vista previa y no se guardan.
Plantillas con un espacio en blanco visible
Estas son las que de verdad muestran un espacio para completar.
language.textCloud y code.syntaxBlock aportan contexto, pero no dibujan un espacio en blanco, así que viven en la referencia de la API y no en esta galería.
universal.tilesFichas numéricas
Series, sumas y ecuaciones dispuestas en fichas claras.
{
"templateId": "universal.tiles",
"data": {
"rows": [
[
"2",
"4",
"8",
"?"
]
]
}
}
universal.sortingBinsCajas de clasificar
Suelta elementos en categorías con nombre.
{
"templateId": "universal.sortingBins",
"data": {
"bins": [
"Round",
"Angular"
],
"binItems": [
[
{
"kind": "shape",
"name": "circle"
},
{
"kind": "shape",
"name": "triangle"
}
],
[
{
"kind": "shape",
"name": "circle"
},
"?"
]
]
}
}
universal.clockFaceCarátula del reloj
Un reloj analógico para preguntas sobre la hora.
{
"templateId": "universal.clockFace",
"data": {
"hour": 3,
"minute": 30
}
}
universal.numberLineRecta numérica
Conteo y secuencias con un espacio en blanco opcional.
{
"templateId": "universal.numberLine",
"data": {
"start": 0,
"end": 10,
"step": 2,
"missing": 6
}
}
math.fractionBarBarra de fracción
Una barra segmentada que muestra una fracción de un todo.
{
"templateId": "math.fractionBar",
"data": {
"shaded": 3,
"total": 4
}
}
language.sentenceTilesFichas de frase
Una frase hecha de fichas de palabras, con un espacio para completar.
{
"templateId": "language.sentenceTiles",
"data": {
"words": [
"The",
"cat",
"sat",
"on",
"the",
{
"kind": "gap",
"characters": 3
}
]
}
}
geometry.figureFigura geométrica
Ángulos, triángulos, cuadriláteros, círculos y rectas paralelas con las etiquetas que necesita la pregunta y un espacio para la incógnita.
{
"templateId": "geometry.figure",
"data": {
"kind": "triangle",
"angles": [
90,
35,
55
],
"angleLabels": [
"90°",
"35°",
"?"
],
"sideLabels": [
"12 cm",
null,
"5 cm"
],
"vertices": [
"A",
"B",
"C"
]
}
}
data.barChartGráfica de barras
Leer valores en las líneas de la cuadrícula, comparar categorías o hallar un total.
{
"templateId": "data.barChart",
"data": {
"title": "Costumes worn at the party",
"categories": [
"Witch",
"Ghost",
"Vampire",
"Zombie"
],
"values": [
12,
7,
9,
4
],
"unit": "pupils"
}
}
data.tableTabla de datos
Una tabla pequeña con una celda oculta para preguntas de «¿qué va aquí?».
{
"templateId": "data.table",
"data": {
"headers": [
"Shop",
"Price (£)",
"Sold"
],
"rows": [
[
"Boo",
3.5,
12
],
[
"Fang",
4,
null
],
[
"Grim",
2.75,
20
]
]
}
}
math.coordinateGridPlano cartesiano
Puntos y segmentos graficados para coordenadas, puntos medios y pendientes.
{
"templateId": "math.coordinateGrid",
"data": {
"xMin": -5,
"xMax": 5,
"yMin": -5,
"yMax": 5,
"points": [
{
"x": 2,
"y": 3,
"label": "A"
},
{
"x": -4,
"y": 1,
"label": "B"
}
],
"segments": [
[
0,
1
]
]
}
}
science.circuitDiagrama de circuito
Un circuito en serie dibujado con símbolos estándar: pila, foco, resistencia, interruptor, medidores.
{
"templateId": "science.circuit",
"data": {
"components": [
{
"kind": "battery",
"label": "6 V"
},
{
"kind": "switch",
"open": true
},
{
"kind": "bulb",
"label": "L1"
},
{
"kind": "resistor",
"label": "10 Ω"
},
{
"kind": "ammeter"
}
]
}
}
science.rayDiagramDiagrama de rayos
Espejos y lentes con los rayos principales; pregunta dónde se forma la imagen o muéstrala.
{
"templateId": "science.rayDiagram",
"data": {
"device": "concaveMirror",
"focalLength": 2,
"objectDistance": 5,
"objectHeight": 2,
"showImage": false
}
}
code.fillBlankLlena el espacio
Código con la pieza que falta bien marcada.
{
"templateId": "code.fillBlank",
"data": {
"code": "function average(scores) {\n const total = scores.reduce(\n (sum, score) => sum + score,\n 0\n )\n return total ___{1} scores.length\n}",
"language": "javascript"
}
}Más ejemplos de código
code.fillBlank admite hasta 2,000 caracteres en 30 líneas. Un ___ suelto usa el ancho predeterminado. ___{N} pone el espacio en blanco a N caracteres, donde N va de 1 a 24. Funcionan JavaScript, Python, HTML y SQL.
JavaScript
{
"templateId": "code.fillBlank",
"data": {
"code": "async function loadQuiz(id) {\n const response = await fetch(`/api/quizzes/${id}`)\n if (!response.ok) {\n throw new Error(\"Could not load quiz\")\n }\n return ___{15}\n}",
"language": "javascript"
}
}Python
{
"templateId": "code.fillBlank",
"data": {
"code": "def average(scores):\n if not scores:\n return 0\n\n total = sum(scores)\n return total ___{1} len(scores)",
"language": "python"
}
}HTML
{
"templateId": "code.fillBlank",
"data": {
"code": "<figure class=\"quiz-image\">\n <img\n src=\"aurora.webp\"\n ___{3}=\"Northern lights over Tromsø\"\n />\n <figcaption>Norway at night</figcaption>\n</figure>",
"language": "html"
}
}SQL
{
"templateId": "code.fillBlank",
"data": {
"code": "SELECT subject, COUNT(*) AS question_count\nFROM questions\nWHERE status = 'published'\nGROUP BY ___{7}\nORDER BY question_count DESC;",
"language": "sql"
}
}Qué puedes poner en una ficha
Arma una imagen con texto, números y espacios en blanco. Emojis, emojis apilados, banderas, formas, texto con estilo y LaTeX funcionan. {"kind":"gap","characters":N} pone un espacio de texto o ficha a N caracteres, donde N va de 1 a 24. Los marcadores antiguos conservan el ancho predeterminado.
textnumber?{"kind":"gap","characters":3}emojiemojiStackflagshapelatex