用途:检索 Materials Project 数据库(v3 API)中 15 万+ 无机晶体材料的 DFT 计算属性,用于材料筛选、带隙分析、热力学稳定性判断与相图查询。
认证与基础:所有请求需在请求头设置 X-API-KEY,密钥存入环境变量 MP_API_KEY:export MP_API_KEY="your_api_key_here"。API 基础地址为 https://api.materialsproject.org/v3。
主要能力:可按化学式(formula)、材料 ID(material_ids)、元素(elements)、化学体系(chemsys)检索;可按带隙范围(band_gap_min/band_gap_max)、凸包能量(energy_above_hull_max)等过滤。返回字段包括 band_gap(eV)、formation_energy_per_atom(eV/atom)、energy_above_hull(0 表示稳定)、symmetry、density、volume、nsites 等。
使用方式:用 curl 携带 X-API-KEY 调用 /materials/summary/ 端点,通过 _fields 指定返回字段、_limit 与 _skip 分页。结果可用 Python 解析 JSON。常见查询模式:太阳能吸收层 band_gap_min=1.0&band_gap_max=1.8&energy_above_hull_max=0.05;宽禁带半导体 band_gap_min=3.0&band_gap_max=6.0;金属 band_gap_max=0&is_metal=true。
限制与建议:始终指定 _fields 以减小响应体积;用 energy_above_hull_max=0.025 筛选稳定相;检查 is_deprecated 避免过时条目;请求速率保持在每秒 5 次以下;批量下载建议改用 mp-api Python 客户端。数据必须来自实际 API 响应,不得凭记忆编造结果。