Ejemplos
Convertir una carga de usuario (FastAPI)
convert_raw_bytes(data, filename=..., **params) es la variante de convert_file para cuando ya tienes el contenido en la memoria (por ejemplo, una FastAPI UploadFile) y no quieres escribirlo en el disco primero.
PDF grande con rango de páginas
Combínelo con pdf_index para saber qué rango ordenar sin descargar todo el PDF del lado del cliente.
BYOS: sube el resultado directamente a tu almacenamiento
Con output_url, API carga Markdown directamente a su almacenamiento (S3, R2, Supabase Storage, GCS) y devuelve un JSON liviano en lugar del cuerpo completo, útil para canalizaciones por lotes donde no desea que Markdown pase por su propio backend. Consulte Compresión para conocer los valores de output_encoding.
Canalización RAG con /pdf/index
Este flujo evita pagar el costo (tokens + latencia) de convertir 500 páginas cuando el agente solo necesita 12. Consulte el PDF Índice para agentes IA.
Procesar un ZIP
Los límites de tamaño y cantidad de archivos dentro de ZIP están documentados en Límites. Un ZIP fuera de rango devuelve 413, que SDK convierte en MarkpdfPayloadTooLargeError.
Convertir muchos archivos en paralelo (asíncrono)
AsyncClient reutiliza una única conexión subyacente HTTP/2, por lo que iniciar conversiones paralelas con asyncio.gather es más eficiente que abrir un Client sincrónico por archivo.