POST /convert

Convierte un documento subido como multipart/form-data. Es la ruta natural para formularios web y clientes que ya manejan ficheros adjuntos.

Request

POST /convert?mode=fast HTTP/1.1
x-api-key: TU_API_KEY
content-type: multipart/form-data; boundary=----xyz

El campo de archivo se llama file.

Query params

enum

predeterminado:"auto"

pdf, docx, csv, txt, xlsx, pptx, zip. Con auto se detecta por extensión y luego por content-type.

enum

predeterminado:"fast"

fast, balanced, quality o auto. Ver Modos.

boolean

predeterminado:"true"

Limpia headers repetidos, líneas de control y ruido del Markdown.

enum

predeterminado:"markdown"

markdown (cuerpo crudo) o json (objeto con metadata embebida).

Body

file

requerido

El documento a convertir. Formato detectado por nombre de archivo y content-type.

Ejemplos

curl -X POST "https://api.markpdf.tech/convert?mode=fast" \
  -H "x-api-key: TU_API_KEY" \
  -F "file=@informe.pdf"

import httpx

with open("informe.pdf", "rb") as fh:
    r = httpx.post(
        "https://api.markpdf.tech/convert",
        params={"mode": "fast"},
        headers={"x-api-key": "TU_API_KEY"},
        files={"file": ("informe.pdf", fh, "application/pdf")},
        timeout=300,
    )
print(r.text)

const form = new FormData();
form.append("file", fileBlob, "informe.pdf");

const res = await fetch("https://api.markpdf.tech/convert?mode=fast", {
  method: "POST",
  headers: { "x-api-key": "TU_API_KEY" },
  body: form,
});
console.log(await res.text());

Respuesta

Por defecto text/markdown más headers de facturación. Ver Respuesta y headers.

Para máxima eficiencia de red en uploads grandes, usa POST /convert/raw con content-encoding: gzip o zstd. multipart no se comprime tan bien.

​POST /convert

​Request

​Query params

​Body

​Ejemplos

​Respuesta

POST /convert

Request

Query params

Body

Ejemplos

Respuesta