Ejecutar en el sandbox

Endpoints de Conversión de Archivos#

Convert es la mitad determinista de EnConvert: 51 endpoints que aceptan un archivo o una URL y devuelven el mismo contenido en otro formato. Todos son un POST a /v1/convert/<id>, así que en cuanto has llamado a uno ya sabes cómo llamar al resto.

Una sola forma de solicitud#

Entre una conversión y otra cambian tres cosas: el id de la ruta, lo que envías y cuál es el resultado. Nada más se mueve.

Ruta. POST https://api.enconvert.com/v1/convert/<id>, donde <id> nombra el par de conversión: url-to-pdf, doc-to-pdf, csv-to-json, heic-to-webp.

Entrada. O un archivo o una URL.

Las conversiones de archivo, 46 de las 51, aceptan multipart/form-data con el archivo en un campo file.
Las conversiones de páginas web, las otras cinco, aceptan application/json con un campo url que admite una URL o un array de ellas.

Salida. Cada conversión escribe su resultado en almacenamiento de objetos y responde con una URL de descarga prefirmada válida durante 15 minutos. Los endpoints que admiten direct_download pueden devolver en su lugar los bytes como cuerpo de la respuesta; cada página de familia indica su propio valor por defecto. Consulta URLs prefirmadas.

Ejemplo#

Envía una URL, recibe un PDF:

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
    "presigned_url": "https://spaces.example.com/...signed...",
    "object_key": "live/files/4127/url-to-pdf/example_20260405_123456789.pdf",
    "filename": "example_20260405_123456789.pdf",
    "file_size": 48213,
    "conversion_time_seconds": 2.41
}

La versión con subida de archivo de la misma llamada, para los 46 endpoints de archivo:

curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -F "[email protected]"

Elige una familia#

Página	Endpoints	Qué cubre
Matriz de conversión	las 51	Todos los formatos de entrada y todos los de salida en una sola tabla, con el id de endpoint de cada par. Empieza aquí cuando ya sabes qué tienes y qué quieres.
Páginas web	5	Renderiza una URL en vivo a PDF, a un PNG de página completa o a Markdown, o rastrea un sitio entero y recibe un único ZIP.
Documentos	13	Word, Excel, PowerPoint, Pages, Numbers, OpenDocument, HTML y Markdown a PDF, además de `anything-to-pdf` (36 extensiones de entrada) y `anything-to-markdown` (22).
Formatos de datos	11	JSON, XML, YAML, CSV y TOML en ambos sentidos, además de Markdown a HTML.
Imágenes	22	JPEG, PNG, SVG, HEIC y WebP entre sí, páginas de PDF renderizadas a JPEG, y compresión dentro del mismo formato.

Cada página de familia lista sus endpoints en una tabla con la ruta exacta de cada uno. Después, cada endpoint tiene su propia página: parámetros de la solicitud, la respuesta, los casos de error que puede devolver y ejemplos de código.

Los endpoints de Office ignoran la geometría de página. Los nueve endpoints basados en LibreOffice (doc-to-pdf, excel-to-pdf, ppt-to-pdf, odt-to-pdf, ods-to-pdf, odp-to-pdf, ots-to-pdf, pages-to-pdf, numbers-to-pdf) aceptan pdf_options pero solo respetan grayscale. El tamaño de página, la orientación y los márgenes provienen del documento de origen, así que fijar uno de ellos explícitamente devuelve 400.

Qué comparten todos los endpoints de conversión#

Las credenciales y los tipos de contenido son los mismos en toda la API. Consulta Endpoints.
El modo asíncrono y los lotes solo están disponibles en los cinco endpoints de páginas web. Las subidas de archivos siempre se ejecutan de forma síncrona, un archivo por solicitud. Consulta Trabajos síncronos y asíncronos y Procesamiento por lotes.
El tamaño de subida tiene un tope por plan, que empieza en 5 MB en el plan Founding. Por encima del tope recibes 413 con el tamaño de tu archivo y el límite en el cuerpo. Consulta Límites de frecuencia y cuotas.
El coste es de una op por conversión. Un lote de 10 URLs son 10 ops, y el lote entero se verifica contra tu cuota restante antes de que se renderice ninguna página.
Los tiempos de espera son reales. Las conversiones de LibreOffice se cortan a los 120 segundos y devuelven 504; el propio gateway abandona cualquier solicitud a los 300 segundos.
Los errores usan los mismos códigos de estado en todas las familias: 400 para entrada inválida, 401 para credenciales incorrectas, 402 para cuota, 403 para una función restringida por plan, 413 para una subida demasiado grande. Consulta Errores.

Preguntas frecuentes#

¿Qué endpoints aceptan una URL en lugar de un archivo?#

Los cinco endpoints de páginas web: url-to-pdf, url-to-screenshot, url-to-markdown, website-to-pdf y website-to-screenshot. Los otros 46 son solo de subida, incluido anything-to-pdf. Para convertir un documento que está en una URL, descárgalo tú mismo y sube los bytes.

¿Puedo convertir varios archivos en una sola solicitud?#

Como subidas, no. El procesamiento por lotes funciona en los endpoints de URL, donde el campo url admite un array, y requiere una clave privada además de un plan con acceso a lotes; el límite de lotes del plan Founding es 0. Consulta Procesamiento por lotes.

¿Y si mi par de formatos no es uno de los 51?#

Mira primero anything-to-pdf: acepta 36 extensiones de entrada y cubre pares que no tienen un endpoint dedicado. Para texto que quieres leer en lugar de imprimir, anything-to-markdown acepta 22. Ninguno de los dos hace OCR, así que una imagen como entrada de anything-to-markdown devuelve 400.

¿Cómo encuentro el endpoint para un par de formatos concreto?#

Abre la matriz de conversión. Lista todos los formatos de entrada en un eje y todos los de salida en el otro, con el id del endpoint en la celda.

← Ingest Conversion Matrix →

API Documentation