Poly Haven 公共 API 与按需资产下载，继承 web.rest.jsonLiteClient。无 API key。界面显示内容来源 Poly Haven；正式应用请设置独立 userAgent。
无网络，生成并校验单个主文件及依赖的下载计划。与 planDownload 的选项相同。
无网络，返回精确文件叶节点。分辨率默认1k；类型默认自动hdri或blend，格式默认exr或类型本身。
检查大小与 MD5，文件描述含 size/md5。分块读取文件，无需把大文件加载入内存。返回 true 或 null,err。
库版本。
流式下载计划文件及 include，保留相对路径。选项 maxBytes（默认512MiB，0禁止下载）、overwrite（默认false）、onProgress。已存在文件须大小+MD5正确才复用；临时文件校验后改名。成功返回 report，失败 null,err,partialReport。
planDownload + download。选项合并上述方法的选项。成功返回 report（含 mainFile）；不自动启动/导入 Blender。
GET /assets。支持 type/category/categories/collection/vault 和 taxonomy 定义的属性。数组转逗号分隔字符串，不改参数。返回以资产 ID 为键的表；失败 null,err,code。
GET /author/{id}，自动编码作者 ID（可含空格）。
GET /categories/{type}，旧分类计数；默认 all 返回三种资产数。新应用优先 getTaxonomy。
GET /files/{id}。返回 文件类型→分辨率→格式 的树；叶节点含 url、size、md5，部分含 include 相对路径依赖。
GET /info/{id}。保留原始 JSON 字段；type：0 HDRI，1 材质，2 模型。
GET /taxonomy/{type}；省略参数则 GET /taxonomy。返回分类树和属性定义。
GET /types，返回 hdris、textures、models 数组。
只取文件清单，不下载。选项 kind/resolution/format；默认自动 HDRI/exr 或 blend/blend、1k。严格精确选取，不隐式换分辨率/格式。计划含 mainRelativePath/files/totalSize。
GET /search。自动 trim/lower。筛选表支持 t/type、limit、min、future、hybrid。保留返回的排名顺序，不按 score 重排；不自动回退或重试。
文件数组，每项含 relativePath、url、size、md5。
主文件相对路径。
主文件及所有依赖的总字节数。
大小+MD5符合而复用的文件数。
所有文件完成才为 true。失败的 partialReport 为 false。
文件包根目录；整个目录一起移动才能保持相对贴图引用。
实际下载文件数。
已校验的文件数组，每项包含绝对 path、relativePath、url、size、md5、可选 cached。
主文件绝对路径，可作为 process.blender 的 args 参数传递。
总计划大小（包含已缓存文件）。
可选配置 userAgent、proxy、proxyBypass、httpFlags。默认节点 https://api.polyhaven.com。每个工作线程各建客户端；同步调用，勿在界面线程下载大文件。