Matriz de Conversiones#
Los 51 endpoints de conversión en un solo lugar: qué acepta cada uno, qué devuelve y dónde está su página de referencia. Busca tu entrada en la columna izquierda, copia la ruta del centro y haz clic para ver parámetros y ejemplos de código. Un par que no aparezca en estas tablas no está admitido.
anything-to-pdf acepta 36 extensiones de archivo y siempre devuelve un PDF; anything-to-markdown acepta 22 y siempre devuelve un único archivo .md en UTF-8.
Ambos aparecen una sola vez en la tabla de Documentos, más abajo, en lugar de repetirse para cada tipo de entrada que cubren.
Páginas Web#
Cinco endpoints que renderizan una URL en vivo en un navegador real. Aceptan un cuerpo JSON, no una carga de archivo.
| Entrada | Salida | Endpoint | Documentación |
|---|---|---|---|
| URL | POST /v1/convert/url-to-pdf |
url-to-pdf | |
| URL | Captura de pantalla PNG | POST /v1/convert/url-to-screenshot |
url-to-screenshot |
| URL | Markdown | POST /v1/convert/url-to-markdown |
url-to-markdown |
Sitio web (rastreado o desde sitemap.xml) |
ZIP de PDFs | POST /v1/convert/website-to-pdf |
website-to-pdf |
Sitio web (rastreado o desde sitemap.xml) |
ZIP de PNGs | POST /v1/convert/website-to-screenshot |
website-to-screenshot |
Los tres endpoints url-to-* aceptan una sola cadena de URL o una lista, y se ejecutan de forma síncrona para una URL. Los dos endpoints website-to-* descubren las páginas por sí mismos y son solo asíncronos: siempre responden 202 con un batch_id y un output_format de zip. Las capturas de pantalla son PNG; no existe una opción de captura en JPEG.
Documentos#
Trece endpoints, cada uno una carga multipart/form-data con el documento en el campo file.
| Entrada | Salida | Endpoint | Documentación |
|---|---|---|---|
| 36 tipos de archivo (Office, iWork, OpenDocument, RTF, CSV, HTML, Markdown, texto, EPUB, imágenes, SVG, PDF) | POST /v1/convert/anything-to-pdf |
anything-to-pdf | |
| 22 tipos de archivo (PDF, Office, OpenDocument, RTF, CSV, HTML, Markdown, texto, EPUB) | Markdown | POST /v1/convert/anything-to-markdown |
anything-to-markdown |
HTML (.html, .htm) |
POST /v1/convert/html-to-pdf |
html-to-pdf | |
Markdown (.md, .markdown) |
POST /v1/convert/markdown-to-pdf |
markdown-to-pdf | |
Word (.doc, .docx) |
POST /v1/convert/doc-to-pdf |
doc-to-pdf | |
Excel (.xls, .xlsx) |
POST /v1/convert/excel-to-pdf |
excel-to-pdf | |
PowerPoint (.ppt, .pptx) |
POST /v1/convert/ppt-to-pdf |
ppt-to-pdf | |
Apple Pages (.pages) |
POST /v1/convert/pages-to-pdf |
pages-to-pdf | |
Apple Numbers (.numbers) |
POST /v1/convert/numbers-to-pdf |
numbers-to-pdf | |
OpenDocument Text (.odt) |
POST /v1/convert/odt-to-pdf |
odt-to-pdf | |
OpenDocument Spreadsheet (.ods) |
POST /v1/convert/ods-to-pdf |
ods-to-pdf | |
OpenDocument Presentation (.odp) |
POST /v1/convert/odp-to-pdf |
odp-to-pdf | |
OpenDocument Spreadsheet Template (.ots) |
POST /v1/convert/ots-to-pdf |
ots-to-pdf |
El motor cambia según la entrada, y eso cambia lo que pdf_options acepta. HTML y Markdown pasan por WeasyPrint y admiten tamaño de página, orientación, márgenes, encabezados y pies de página. Los nueve endpoints basados en LibreOffice (doc, excel, ppt, odt, ods, odp, ots, pages, numbers) toman la geometría de página del documento original, por lo que solo respetan grayscale y devuelven 400 si estableces explícitamente una opción de geometría.
Formatos de Datos#
Once endpoints, todos cargas multipart/form-data síncronas. La extensión del archivo que envías debe coincidir con el endpoint al que lo envías.
| Entrada | Salida | Endpoint | Documentación |
|---|---|---|---|
JSON (.json) |
XML | POST /v1/convert/json-to-xml |
json-to-xml |
XML (.xml) |
JSON | POST /v1/convert/xml-to-json |
xml-to-json |
JSON (.json) |
YAML | POST /v1/convert/json-to-yaml |
json-to-yaml |
YAML (.yaml, .yml) |
JSON | POST /v1/convert/yaml-to-json |
yaml-to-json |
JSON (.json) |
CSV | POST /v1/convert/json-to-csv |
json-to-csv |
CSV (.csv) |
JSON | POST /v1/convert/csv-to-json |
csv-to-json |
JSON (.json) |
TOML | POST /v1/convert/json-to-toml |
json-to-toml |
TOML (.toml) |
JSON | POST /v1/convert/toml-to-json |
toml-to-json |
CSV (.csv) |
XML | POST /v1/convert/csv-to-xml |
csv-to-xml |
XML (.xml) |
CSV | POST /v1/convert/xml-to-csv |
xml-to-csv |
Markdown (.md, .markdown) |
HTML | POST /v1/convert/markdown-to-html |
markdown-to-html |
Las entradas deben estar en UTF-8. No hay garantía de ida y vuelta entre un par de endpoints: XML y CSV no transportan la información de tipos de JSON, así que convertir de JSON a CSV y de vuelta devuelve strings.
Imágenes#
Veintidós endpoints, todos cargas multipart/form-data. La entrada JPEG cubre .jpg y .jpeg, y la entrada HEIC cubre .heic y .heif.
| Entrada | Salida | Endpoint | Documentación |
|---|---|---|---|
| JPEG | PNG | POST /v1/convert/jpeg-to-png |
jpeg-to-png |
| PNG | JPEG | POST /v1/convert/png-to-jpeg |
png-to-jpeg |
| JPEG | SVG | POST /v1/convert/jpeg-to-svg |
jpeg-to-svg |
| SVG | JPEG | POST /v1/convert/svg-to-jpeg |
svg-to-jpeg |
| JPEG | HEIC | POST /v1/convert/jpeg-to-heic |
jpeg-to-heic |
| HEIC | JPEG | POST /v1/convert/heic-to-jpeg |
heic-to-jpeg |
| JPEG | WebP | POST /v1/convert/jpeg-to-webp |
jpeg-to-webp |
| WebP | JPEG | POST /v1/convert/webp-to-jpeg |
webp-to-jpeg |
| PNG | SVG | POST /v1/convert/png-to-svg |
png-to-svg |
| SVG | PNG | POST /v1/convert/svg-to-png |
svg-to-png |
| PNG | HEIC | POST /v1/convert/png-to-heic |
png-to-heic |
| HEIC | PNG | POST /v1/convert/heic-to-png |
heic-to-png |
| PNG | WebP | POST /v1/convert/png-to-webp |
png-to-webp |
| WebP | PNG | POST /v1/convert/webp-to-png |
webp-to-png |
| SVG | HEIC | POST /v1/convert/svg-to-heic |
svg-to-heic |
| HEIC | SVG | POST /v1/convert/heic-to-svg |
heic-to-svg |
| SVG | WebP | POST /v1/convert/svg-to-webp |
svg-to-webp |
| WebP | SVG | POST /v1/convert/webp-to-svg |
webp-to-svg |
| HEIC | WebP | POST /v1/convert/heic-to-webp |
heic-to-webp |
| WebP | HEIC | POST /v1/convert/webp-to-heic |
webp-to-heic |
| JPEG, o un ZIP de JPEGs | POST /v1/convert/pdf-to-jpeg |
pdf-to-jpeg | |
| PNG, JPEG o WebP | El mismo formato que la entrada | POST /v1/convert/compress-image |
compress-image |
Tres detalles que suelen causar problemas:
- Los cuatro endpoints
*-to-svgno vectorizan. Codifican en base64 la imagen rasterizada dentro de un elemento<image>de SVG dimensionado según los píxeles originales, lo que añade aproximadamente un 33% al tamaño del archivo. pdf-to-jpegdevuelve un JPEG sin procesar para un PDF de una sola página y un ZIP conpage_1.jpegen adelante para uno de varias páginas, así que escribe tu cliente para gestionar ambos casos.compress-imageconserva el formato de entrada. Si entra un PNG, sale un PNG.
413 antes de que empiece cualquier trabajo de conversión. Los tamaños por plan están en Límites de frecuencia y cuotas.
¿No aparece aquí?#
Dos sitios donde mirar a continuación.
Formatos compatibles tiene las listas de extensiones en bruto en lugar de los pares, incluidas las 36 entradas que acepta anything-to-pdf y las 22 que acepta anything-to-markdown.
Perceive es el endpoint para leer una página en lugar de convertirla. Un solo renderizado de una URL devuelve a la vez Markdown, HTML limpio, una captura de pantalla, un PDF, el inventario de enlaces e imágenes y datos estructurados, que suele ser lo que necesitas para un agente o un pipeline de RAG.
Algunos pares que faltan siguen siendo alcanzables en dos pasos o mediante un endpoint genérico. No existe un endpoint png-to-pdf, por ejemplo, pero anything-to-pdf acepta .png y devuelve un PDF de una sola página. Lo que no existe en absoluto es OCR ni conversión de audio y vídeo. Por eso también enviar una imagen a anything-to-markdown devuelve 400: no hay capa de texto que leer ni una pasada de OCR detrás.