Poly Haven默认端点无login/API key;读取资产目录JSON元信息,须独特User-Agent和来源标示。
调用方式 / profile:polyhaven-asset-metadata-documentation · 组件版本:documentation-sha256:dee5f2e47fef8f0f5f02ba17ef335ea730e4cd8befe778197b8770cf00d77937 · 引用此版本与调用方式
已记录条件
- invocation_mode = api:支持。Supported within this profile and component version. 依据:polyhaven-asset-metadata-documentation-e1
- output_format = json:支持。Supported within this profile and component version. 依据:polyhaven-asset-metadata-documentation-e1
- output_structure = json_object:支持。Supported within this profile and component version. 依据:polyhaven-asset-metadata-documentation-e1
- auth_required = false:支持。Supported within this profile and component version. 依据:polyhaven-asset-metadata-documentation-e2
- account_required = false:支持。Supported within this profile and component version. 依据:polyhaven-asset-metadata-documentation-e2
入口与前提
- 协议
- HTTPS GET
- 认证
- 本页默认端点no login/API key;不泛化未来端点或付费第三方镜像
- 价格是否查明
- known
- 配额是否查明
- unknown
https://api.polyhaven.com/assets
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- 官方称默认API商业用途免费、无premium tier/分成;资产CC0与live API来源标示条件分开。
- 每次请求要独特User-Agent;不能冒用文档示例身份;未给数额频率quota。
- best effort、端点/认证可能改变;素材链接不代表已下载、完整校验或私有资产处理。
配方 polyhaven-asset-metadata-documentation-recipe · 修订 1
所需调用能力:
- read_asset_metadata_catalog
运行前提:
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- 官方称默认API商业用途免费、无premium tier/分成;资产CC0与live API来源标示条件分开。
- 每次请求要独特User-Agent;不能冒用文档示例身份;未给数额频率quota。
- best effort、端点/认证可能改变;素材链接不代表已下载、完整校验或私有资产处理。
使用步骤:
- 准备已获授权的最小输入,核对本profile的适用范围、认证与费用;不填私人信息或凭据到公开示例。
- 候选GET https://api.polyhaven.com/assets,使用调用方真实且独特User-Agent并标示来源;本次不请求API或下载素材。
- 未来获准调用后核对HTTP/MCP状态、返回结构与请求条件,保留缺项/限流/权限错误;本次没有执行此步骤。
- 输入约定
- GET /assets;如需单资产文件元信息,按文档/files/{id}使用有效asset ID。
- 输出约定
- 以asset ID为key的JSON对象及name/tags/authors等;files返回分格式/分辨率的url/size/md5元信息。
- 成功检查
- 待执行:HTTP/JSON对象、asset IDs与元数据完整性;按需少取,错误或策略变化不绕过。
- 失败与回退
- 条件不满足、认证/限流/结构错误即停止该调用并保留unknown;不切换付费服务、不猜工具名、不执行写操作。
适用证据
polyhaven-asset-metadata-documentation-e1 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/api-expansion-20261024-01/sources/polyhaven-asset-metadata-documentation.txt:L30-L60
- 来源版本
- documentation-sha256:dee5f2e47fef8f0f5f02ba17ef335ea730e4cd8befe778197b8770cf00d77937
- 内容摘要
- dee5f2e47fef8f0f5f02ba17ef335ea730e4cd8befe778197b8770cf00d77937
- 采集时间
- 2026-10-20T11:07:09.9001680+00:00
GET /assets - list & metadata curl -H "User-Agent: MyAssetBrowser/1.0" https://api.polyhaven.com/assets { "sunset_jhbcentral": { "name": "Joburg Central Sunset", "description": "Free, unclipped 24K HDRI of a low-contrast rooftop sunset, cool twilight with pink clouds, building skyline, soft warm light and muted tones.", "category": "Streets & Town/Rooftops & Balconies/City Rooftops", "tags": ["city", "roof", "skyline", "building", "architecture", "industrial", "pink", "twilight"], "attributes": { "time_of_day": "dusk", "weather": "partly_cloudy", "light_type": "natural", "contrast": "low", "environment": "outdoor", "sky_view": "open" }, "thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/sunset_jhbcentral.png?width=256&height=256&v=7f3a91c4", "img_version": "7f3a91c4", "max_resolution": [24576, 12288], "download_count": 269506, "authors": { "Greg Zaal": "Processing", "Dimitrios Savva": "Photography" }, "date_published": 1633305600, "date_taken": 1621531620, "coords": [-26.205388, 28.039787], "whitebalance": 5319, "evs_cap": 12, "category_id": "8133f881-e55d-5c6c-a360-99dbf7204ee5", "files_hash": "e2e14a204ee06104209396caa9e7b40322dbb3d4",
覆盖条件:invocation_mode=api; output_format=json; output_structure=json_object
polyhaven-asset-metadata-documentation-e2 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/api-expansion-20261024-01/sources/polyhaven-asset-metadata-documentation.txt:L222-L223
- 来源版本
- documentation-sha256:dee5f2e47fef8f0f5f02ba17ef335ea730e4cd8befe778197b8770cf00d77937
- 内容摘要
- dee5f2e47fef8f0f5f02ba17ef335ea730e4cd8befe778197b8770cf00d77937
- 采集时间
- 2026-10-20T11:07:09.9001680+00:00
1. ✅ The API is free to use, for any purpose Personal, academic, or commercial. There's no premium tier, no revenue share, and no login or API key required for the default endpoints.
覆盖条件:auth_required=false; account_required=false
结构化配方尚未提供或不适用于本版本;旧用法文字保留,连接与执行结果未知。