Respuesta y headers

Markdown (por defecto)

Con response_format=markdown recibes el documento convertido como cuerpo crudo:

HTTP/1.1 200 OK
content-type: text/markdown; charset=utf-8
content-disposition: attachment; filename="informe.md"

JSON

Con response_format=json recibes un objeto con el Markdown y su metadata:

{
  "filename": "informe.pdf",
  "input_format": "pdf",
  "markdown": "# Informe...\n\n...",
  "size_bytes": 184320,
  "timings": {
    "convert_ms": 142,
    "clean_ms": 3,
    "total_worker_ms": 145,
    "upload_ms": 20,
    "total_request_ms": 171
  },
  "markdown_bytes": 5120,
  "token_saved_estimate": 44800
}

string

Documento convertido a Markdown.

string

Formato detectado o forzado de la entrada.

string

integer

Tamaño del documento procesado en bytes.

object

Tiempos en milisegundos: convert_ms, clean_ms, total_worker_ms, upload_ms, total_request_ms.

integer

Tamaño del Markdown de salida en bytes.

integer

Estimación de tokens ahorrados frente a meter el documento bruto en el prompt.

Headers

Toda respuesta incluye headers de observabilidad, útiles para logging y métricas en tu cliente.

Header	Significado
`X-Conversion-Engine`	Motor de conversión usado.
`X-Input-Format`	Formato detectado de la entrada.
`X-Input-Bytes`	Bytes del documento procesado.
`X-Wire-Bytes`	Bytes recibidos por red (solo `/convert/raw` con compresión).
`X-Markdown-Bytes`	Tamaño del Markdown de salida.
`X-Token-Saved-Estimate`	Tokens ahorrados estimados.
`X-Conversion-Ms`	Tiempo de conversión.
`X-Total-Request-Ms`	Tiempo total de la petición.
`ETag`	Hash del contenido + parámetros. Úsalo para caché.
`Cache-Control`	`public, max-age=..., immutable`.

Ver Caché y ETag.

​Respuesta y headers

​Markdown (por defecto)

​JSON

​Headers

Respuesta y headers

Markdown (por defecto)

JSON

Headers