Generar un quiz
Convertir un capítulo, un manual de capacitación o un documento de onboarding en un quiz justo toma más tiempo que escribir el material original, por eso casi nunca se llega a evaluar. La API Generar Quiz lee el contenido fuente y devuelve un conjunto de preguntas con respuestas tomadas de ese mismo texto, pensada para el momento en que necesita comprobar si algo se entendió de verdad, no solo si se leyó.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué comprobar la comprensión suele quedar fuera
Creadores de cursos, equipos de recursos humanos que gestionan onboarding y programas de capacitación interna producen mucho más material de lectura que material de evaluación, porque escribir una buena pregunta es genuinamente más difícil que escribir el dato que evalúa: una pregunta mal hecha revela la respuesta en su propia redacción o termina evaluando trivia en lugar de comprensión. Esa asimetría hace que las comprobaciones de comprensión sean lo primero que se recorta bajo presión de tiempo. Este endpoint existe para cerrar esa brecha sin pedirle a nadie que se convierta en redactor profesional de exámenes.
Del texto fuente a un quiz terminado
Envía su material fuente por POST a /text/quiz, y la tarea corre de forma asíncrona. Al terminar el procesamiento, llega por webhook o enlace firmado un conjunto de preguntas con sus respuestas correctas, fundamentadas en el texto enviado y no en datos inventados. El resultado se puede rastrear directamente hasta la fuente, de modo que cada pregunta se remonta al pasaje del que salió, algo importante cuando el quiz se va a usar para certificar que alguien realmente aprendió el material.
Un formato anterior al aprendizaje digital
El formato de preguntas y respuestas para comprobar comprensión es anterior a cualquier software: los maestros han usado la recitación y las preguntas cortas desde mucho antes de la imprenta, y el examen de opción múltiple como formato estandarizado tiene más de un siglo, desarrollado originalmente para evaluar a grandes grupos de personas de forma rápida y consistente. Lo que cambió no es la lógica del formato sino el costo de producirlo: una tarea que antes le tomaba a un maestro una tarde por capítulo hoy puede correr contra cualquier texto que ya tenga.
Dónde encaja en un flujo de aprendizaje o automatización
Al ser asíncrono y cobrarse por llamada, el endpoint está pensado para escala: una plataforma de e-learning genera un quiz automáticamente cada vez que se publica una lección nueva, o un sistema de recursos humanos arma una comprobación de onboarding en el momento en que se publica una política nueva. Una generación fallida se reintenta automáticamente hasta tres veces y nunca se cobra, así que ejecutar esto contra una biblioteca completa de cursos mantiene un costo predecible incluso a volumen.
Qué tipo de quiz esperar
Espere preguntas que evalúan si se entendió el material fuente, con respuestas rastreables hasta el texto y no trivia externa; el quiz refleja exactamente lo que le entregó, así que una fuente escasa produce un quiz escaso y una fuente completa produce un quiz completo. Es una herramienta para comprobar retención de un contenido específico, no un generador de preguntas de cultura general.
Qué puede hacer con ella
Evaluaciones en cursos de e-learning
Una plataforma de cursos en línea genera automáticamente un quiz de fin de módulo a partir de la transcripción de cada lección apenas se publica.
Comprobaciones de onboarding para empleados
Un equipo de recursos humanos convierte una nueva política de cumplimiento en un quiz corto que deben aprobar los nuevos empleados, generado el mismo día en que la política queda finalizada.
Guías de estudio a partir de libros o apuntes
Un servicio de tutorías convierte un capítulo o los apuntes propios de un estudiante en preguntas de práctica para autoevaluarse antes de un examen.
Capacitación de producto para equipos de soporte
Una empresa pasa su documentación de producto actualizada por el endpoint para mantener al día los cuestionarios de capacitación del equipo de soporte con cada nueva versión.
Preguntas frecuentes
¿Cómo genero un quiz a partir de mi propio material con esta API?
Envíe su texto fuente por POST a /text/quiz; la tarea corre de forma asíncrona y las preguntas con sus respuestas se entregan por webhook o por un enlace firmado.
¿Existe un plan gratuito para la API de generar quiz?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se cobra la generación de quiz?
$0.003 por solicitud más $0.0135 por cada 1.000 palabras del material fuente, y solo se cobra cuando la tarea se completa con éxito.
¿Las respuestas están garantizadas como correctas?
Las respuestas se fundamentan en el texto que envía y no se inventan, así que su precisión depende de la calidad y claridad del material fuente que proporcione.
¿En qué formato vienen las preguntas?
El resultado es un conjunto estructurado de preguntas y respuestas correctas vinculadas al texto fuente, apto para incorporarse en una interfaz de quiz o en un LMS.
¿Puedo generar quizzes a partir de documentos largos como un capítulo completo?
Sí, el precio escala según el número de palabras, así que capítulos completos, manuales o transcripciones funcionan bien como material fuente.
¿Qué pasa si falla la tarea de generación de quiz?
Se reintenta automáticamente hasta tres veces y nunca se cobra una tarea que no llega a completarse.
¿Cómo y cuándo recibo el quiz generado?
Mediante un webhook firmado, recomendado para procesos automatizados, o un enlace firmado válido por 24 horas; el material fuente se elimina al vencer la retención y nunca se usa para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/text/quiz \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/quiz", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/quiz",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/quiz", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/quiz", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.quiz",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |