Resumen rápido de la API PDF‑to‑Quiz
- Carga de PDF mediante una llamada HTTP simple, compatible con multipart/form-data.
- Extracción de texto y OCR integrado para PDFs escaneados, preservando la estructura del documento.
- Generación automática de preguntas de opción múltiple, verdadero/falso y asociación, con control de dificultad.
- Opciones de personalización como número de preguntas, inclusión de explicaciones y selección de idioma.
Flujo técnico de la API de carga y análisis de PDFs
El proceso comienza con una petición POST a /api/v1/pdf‑quiz, donde el cliente envía el archivo PDF y los parámetros de configuración. La API valida el tipo y tamaño del archivo, y si el PDF está protegido, verifica la contraseña proporcionada. Una vez aceptado, el archivo se almacena en un contenedor temporal aislado, garantizando que ningún otro proceso pueda acceder a los datos.
A continuación, un motor de extracción analiza el contenido. Si el PDF contiene texto seleccionable, se utiliza un parser basado en reglas para identificar encabezados, listas y párrafos. Cuando el documento es una imagen escaneada, se activa un OCR de alta precisión que convierte la imagen en texto estructurado. El resultado se normaliza en un árbol jerárquico que representa capítulos, secciones y conceptos clave, facilitando que la IA comprenda el contexto antes de generar preguntas.
Cómo la IA transforma el contenido del PDF en preguntas activas
Una vez que el texto estructurado está disponible, el modelo de generación de preguntas evalúa cada nodo del árbol para extraer conceptos relevantes. Se aplican técnicas de aprendizaje activo como el "active recall", creando preguntas que obligan al estudiante a recordar la información en lugar de reconocerla pasivamente. Cada pregunta incluye una explicación que sirve como feedback inmediato, reforzando la comprensión.
Para los conceptos que aparecen de forma recurrente, la API emplea un algoritmo de repetición espacida (SM‑2) que prioriza la generación de preguntas sobre los temas menos dominados. De esta manera, el quiz resultante no solo cubre todo el contenido, sino que también dirige al estudiante hacia los puntos débiles, optimizando la retención a largo plazo.
Pasos para integrar la API PDF‑to‑Quiz en tu aplicación
- 1
Paso 1 : Obtén tu clave API Regístrate en la consola de desarrolladores de Quizly y genera una clave secreta que autorizará tus peticiones. - 2
Paso 2 : Envía el PDF Realiza una petición POST a /api/v1/pdf‑quiz con el archivo PDF y los parámetros como "question_count" y "difficulty". - 3
Paso 3 : Recibe el quiz generado La respuesta incluye un JSON con las preguntas, opciones, respuestas correctas y explicaciones detalladas, listo para mostrarse en tu interfaz. - 4
Paso 4 : Gestiona la seguridad Almacena la clave API de forma segura, usa HTTPS y configura límites de tasa para evitar abusos.
Parámetros configurables de la API
- question_count — número exacto de preguntas a generar; la IA distribuye los temas de forma equilibrada.
- difficulty — nivel de complejidad (fácil, medio, difícil) que ajusta vocabulario y profundidad de las explicaciones.
- question_type — selecciona entre "multiple_choice", "true_false" o "matching" según el estilo de evaluación deseado.
- include_explanations — booleano que indica si cada pregunta debe incluir una retroalimentación detallada.
- language — código ISO del idioma en que se generarán las preguntas, soportando español, inglés y varios idiomas europeos.
Casos de uso típicos
- Profesores que quieren transformar sus apuntes en quizzes interactivos para tareas en línea.
- Plataformas de e‑learning que desean ofrecer contenido personalizado sin requerir creación manual de preguntas.
- Estudiantes que automatizan la revisión de libros de texto antes de los exámenes.
- Programas de onboarding que convierten manuales internos en evaluaciones de conocimientos.
- Herramientas de certificación que generan pruebas a partir de documentos técnicos.
- Sistemas de gestión de conocimiento que convierten PDFs de políticas en cuestionarios de cumplimiento.
Opiniones de usuarios
Integramos la API de Quizly en nuestro portal de capacitación y ahora podemos crear cuestionarios a partir de cualquier manual PDF en segundos. El proceso es fiable y la calidad de las preguntas es excelente.— Especialista en capacitación, Madrid
Como docente, subo mis notas en PDF y obtengo quizzes listos para mis alumnos. Me ahorra tiempo y me permite enfocarme en la retroalimentación personalizada.— Profesor de biología, Valencia
Utilicé la API para generar preguntas de certificación a partir de la documentación de nuestro producto. Los resultados fueron consistentes y la integración fue muy sencilla.— Gerente de producto, Barcelona
Preguntas frecuentes
¿Cómo funciona la extracción de texto de un PDF mediante la API de Quizly?
La API recibe el archivo PDF mediante una petición multipart/form-data, lo almacena temporalmente y utiliza un motor OCR avanzado cuando el PDF contiene imágenes escaneadas. Luego, un parser especializado identifica títulos, subtítulos y párrafos, preservando la jerarquía estructural para que la IA pueda comprender el contexto antes de generar preguntas.
¿Qué tipos de preguntas pueden generarse automáticamente a partir de un documento PDF?
Quizly permite crear preguntas de opción múltiple, verdadero/falso y de asociación. Cada tipo se adapta al contenido detectado: los conceptos clave generan preguntas de opción múltiple, las afirmaciones verificables se convierten en verdadero/falso y las relaciones entre conceptos se usan para preguntas de asociación.
¿Se puede definir la dificultad de los quizzes generados por la API?
Sí, la solicitud incluye un parámetro de dificultad (fácil, medio, difícil). La IA evalúa la complejidad del texto y selecciona vocabulario y niveles de detalle acordes, garantizando que las preguntas se alineen con el nivel de dominio deseado.
¿Cómo se controla la cantidad de preguntas que se generan por documento?
El cuerpo de la petición acepta un campo "question_count" que indica el número exacto de preguntas. La IA distribuye equitativamente los temas del documento, priorizando los segmentos más extensos y los conceptos repetidos para cubrir la mayor parte del contenido.
¿Qué formatos de PDF son compatibles con la API de Quizly?
La API admite PDFs nativos, PDFs escaneados y PDFs protegidos por contraseña (cuando se proporciona la clave). En caso de archivos protegidos, la API valida la contraseña antes de iniciar el proceso de extracción.
¿Es posible personalizar el estilo de las preguntas generadas?
Sí, mediante parámetros opcionales como "question_type", "include_explanations" y "language". Se puede solicitar que cada pregunta incluya una explicación detallada, elegir entre español, inglés u otros idiomas soportados, y definir si se prefiere un formato de respuesta único o múltiple.
¿Cómo se gestiona la seguridad y privacidad de los documentos subidos a la API?
Los archivos se encriptan en tránsito con TLS 1.3 y se almacenan temporalmente en un contenedor aislado. Tras la generación del quiz, el PDF se elimina automáticamente después de 24 horas, garantizando que la información confidencial no quede persistente en los servidores.
¿Qué limitaciones existen en cuanto al tamaño máximo de archivo PDF que puedo subir?
La API permite subir archivos de hasta 50 MB, suficiente para la mayoría de libros de texto y manuales. Para documentos más extensos, se recomienda dividir el PDF en capítulos y procesarlos por separado, lo que también mejora la precisión de la generación de preguntas.
