alicli documentation

media render

media render

Request a device-rendered PDF of a document preview.

alicli media render "mr-0000000000000000" --out preview.pdf --deadline-seconds 90 --json

Use a render when you need the preview representation. This calls the vendor’s device-render service. It is separate from original-byte download and does not certify that the rendered bytes match the original file.

Bounded waiting

The client polls the document render status under its own deadline. It rejects an explicit error, a missing page count that persists beyond the grace window, an unfinished download response or a non-PDF body. Progress goes to stderr. A result is written only after the render completes; pass --out to save it.

Raster output

The PDF can contain one raster image per page with no text layer. Text extraction requires OCR in that case. The result includes isRender:true, ofMd5, pages, bytes and the output path. ofMd5 identifies the original being rendered, not the rendered PDF’s checksum. Rendering does not fill the local media cache.

media original · media gap