\begin{pdf-api}
API de generación de PDF
Una API de generación de PDF le permite compilar documentos mediante programación con una sola solicitud HTTP, sin herramientas locales. FormaTeX ofrece una API REST basada en LaTeX que produce PDF con calidad de publicación desde cualquier lenguaje, framework o herramienta de automatización.
\section{Definition}
¿Qué es una API de generación de PDF?
Una API de generación de PDF es un servicio REST que acepta el código fuente de un documento (HTML, LaTeX, Markdown o una plantilla) y devuelve un archivo PDF compilado como respuesta binaria. En lugar de instalar herramientas de PDF en cada máquina que necesite producir documentos, usted hace una solicitud HTTP desde cualquier lenguaje o plataforma y recibe un PDF listo para usar en el cuerpo de la respuesta.
Cualquier lenguaje, cualquier plataforma
Un único POST HTTP funciona desde Python, Node.js, Go, Ruby, PHP o cualquier herramienta sin código con una acción HTTP.
Sin instalación local
Sin TeX Live, wkhtmltopdf, Chrome sin interfaz ni Puppeteer que instalar, actualizar o mantener en sus servidores.
Resultado predecible
Una API administrada produce un resultado idéntico en todos los entornos. Se acabaron los errores de PDF del tipo «se ve distinto en CI».
\section{Comparison}
API de PDF basadas en LaTeX frente a basadas en HTML
| Característica | API de LaTeX (FormaTeX) | API de HTML a PDF |
|---|---|---|
| Calidad tipográfica | Profesional: Knuth–Plass, microtipografía | Renderizado a nivel de navegador |
| Matemáticas | amsmath nativo, soporte completo de ecuaciones | Soluciones alternativas con MathJax/KaTeX |
| Control del diseño de página | Preciso: márgenes, columnas, encabezados, pies de página | Aproximación con CSS, rarezas de impresión |
| Documentos largos | Índice, referencias cruzadas, bibliografía | Complejo de gestionar con fiabilidad |
| Fuentes | Soporte completo de OTF/TTF con xelatex/lualatex | Limitado a fuentes del sistema o web |
| Formato de origen | LaTeX (.tex) | HTML + CSS |
| Complejidad de configuración | Curva inicial más alta, enorme recompensa | Familiar si conoce HTML/CSS |
| Ideal para | Informes, artículos, facturas, certificados | Recibos sencillos, capturas de páginas web |
\section{FormaTeX}
El enfoque de FormaTeX
FormaTeX ejecuta una distribución completa de TeX Live en un entorno aislado del lado del servidor. Cada solicitud de compilación obtiene un sandbox nuevo: sin contaminación cruzada entre trabajos, sin archivos auxiliares obsoletos y sin riesgos de seguridad por el LaTeX proporcionado por los usuarios. El PDF compilado se devuelve como bytes sin procesar en la respuesta HTTP y luego se elimina de nuestros servidores.
Compilación síncrona
Haga un POST a /api/v1/compile y reciba los bytes del PDF directamente en la respuesta. Ideal para la generación bajo demanda cuando necesita el archivo de inmediato.
Tres motores LaTeX
Elija pdflatex (rápido, la mayor compatibilidad), xelatex (Unicode, fuentes del sistema) o lualatex (scripting con Lua, tipografía avanzada).
Compilación efímera
Su código fuente LaTeX y el PDF compilado se eliminan de nuestros servidores inmediatamente después de enviar la respuesta. No se almacena nada.
Autenticación sencilla
Envíe su clave de API en el encabezado X-API-Key. Genere todas las claves que necesite desde el panel y revóquelas individualmente.
\section{Inicio rápido}
Compile su primer PDF en 30 segundos
Ejecute este comando curl después de reemplazar YOUR_API_KEY por su clave de FormaTeX. La opción --output hello.pdf guarda los bytes sin procesar del PDF en un archivo del directorio actual.
curl -X POST https://api.formatex.io/api/v1/compile \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"latex": "\\documentclass{article}\n\\begin{document}\n\\title{Hello, FormaTeX!}\n\\author{Your Name}\n\\date{\\today}\n\\maketitle\n\nThis PDF was generated via the FormaTeX API.\n\n\\end{document}",
"engine": "pdflatex"
}' \
--output hello.pdf\section{Casos de uso}
Qué construyen los equipos con una API de generación de PDF
Informes automatizados
Genere informes de analítica mensuales, resúmenes financieros o paneles operativos como PDF de forma programada, alimentados con datos en vivo.
Facturas y recibos
Compile facturas profesionales a partir de los datos del sistema de facturación. LaTeX maneja con precisión las líneas de varias columnas, los totales y las secciones de impuestos.
Certificados de finalización
Genere certificados de finalización personalizados para plataformas de e-learning. Inserte nombres, títulos de cursos y fechas de forma dinámica.
Artículos académicos y tesis
Compile artículos de investigación, envíos a conferencias y tesis con todo el formato de LaTeX: bibliografías, ecuaciones, figuras y más.
\section{FAQ}
Preguntas frecuentes
¿Necesito saber LaTeX para usar FormaTeX?
El LaTeX básico es sencillo para documentos comunes. El playground de FormaTeX le permite experimentar de forma interactiva. Para flujos de trabajo con IA, puede usar GPT-4 o Claude para generar el código fuente LaTeX: solo tiene que escribir el prompt.
¿Qué motores LaTeX admite FormaTeX?
FormaTeX admite pdflatex (el más rápido, con la mayor compatibilidad de paquetes), xelatex (texto Unicode, fuentes OpenType) y lualatex (scripting con Lua, tipografía avanzada). Indique su motor en el cuerpo de la solicitud.
¿Cuánto tarda la compilación?
Los documentos sencillos se compilan en menos de un segundo. Los documentos complejos con muchos paquetes, figuras TikZ o bibliografías suelen compilarse en dos a cinco segundos.
¿Se almacena mi código fuente LaTeX después de la compilación?
No. Su código fuente LaTeX y el PDF compilado se eliminan de nuestros servidores inmediatamente después de enviar la respuesta HTTP. No se conserva nada.
¿Puedo usar cualquier paquete de CTAN?
Sí. FormaTeX ejecuta una instalación completa de TeX Live. Cualquier paquete disponible en CTAN está disponible en su entorno de compilación sin ninguna configuración.
\end{pdf-api}
Empiece a generar PDF mediante la API
Cree una cuenta gratuita de FormaTeX, obtenga su clave de API y compile su primer PDF con un solo comando curl, sin tarjeta de crédito.