--- seo_title: API de Conversión de Archivos: Todos los Endpoints | EnConvert meta_desc: La API de conversión de EnConvert: 51 endpoints para páginas web, documentos, formatos de datos e imágenes, con una sola forma de solicitud y una URL prefirmada. keywords: api de conversión de archivos, endpoints de conversión api, post v1 convert, api url a pdf, api convertir documento a pdf, api de conversión de imágenes, convertir csv a json api, matriz de conversión de formatos, subir archivo multipart conversión api --- # 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/`, 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/`, donde `` 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](/es/docs/concepts/signed-urls.md). ## Ejemplo Envía una URL, recibe un PDF: ```bash 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"}' ``` ```json { "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: ```bash curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \ -H "X-API-Key: sk_your_private_key" \ -F "file=@quarterly-report.docx" ``` ## Elige una familia | Página | Endpoints | Qué cubre | |------|-----------|----------------| | [Matriz de conversión](/es/docs/endpoints/convert/matrix.md) | 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](/es/docs/endpoints/convert/web-pages.md) | 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](/es/docs/endpoints/convert/documents.md) | 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](/es/docs/endpoints/convert/data-formats.md) | 11 | JSON, XML, YAML, CSV y TOML en ambos sentidos, además de Markdown a HTML. | | [Imágenes](/es/docs/endpoints/convert/images.md) | 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](/es/docs/endpoints.md). - **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](/es/docs/concepts/sync-and-async.md) y [Procesamiento por lotes](/es/docs/guides/batch-processing.md). - **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](/es/docs/reference/rate-limits.md). - **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](/es/docs/reference/errors.md). ## 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](/es/docs/guides/batch-processing.md). ### ¿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](/es/docs/endpoints/convert/matrix.md). 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.