Download an image or document
Stream a Printables image or attached document: a gallery image, a file preview, a designer avatar, or the printing-instructions PDF, using a url taken from a model result. Only Printables media hosts are accepted. HTTP Range requests are supported, so a large file can be fetched in pieces. This is a GET with query parameters, not a JSON POST, and it bills as one request. It does not serve model files — Printables publishes no public download URL for geometry or sliced files.
/media Utility https://api.fetchlayer.dev/printables/media Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
url string required Printables image or document URL, as returned on a model. Passed as a query parameter.
filename string optional Content-Disposition filename to serve the file as (max 200 characters).
Range string optional Standard HTTP Range request header, for example bytes=0-65535. Sent as a header, not a query parameter.
Response Fields
media
Download an image or document
(body) binary The file itself. 200 for the whole file, 206 for a requested byte range.
Content-Type header Media type of the file, e.g. image/jpeg or application/pdf.
Content-Range header Byte range served, on a 206 response.
Accept-Ranges header Present when the file supports range requests.
Request
curl -X GET "https://api.fetchlayer.dev/printables/media?url=https%3A%2F%2Fmedia.printables.com%2Fmedia%2Fprints%2F512345%2Fimages%2Fcover.jpg&filename=cable-tray-cover.jpg" \
-H "Authorization: Bearer ss-your-key"Response
{
"note": "Binary file streamed back with Content-Type, Content-Length and Accept-Ranges headers."
}