PBR Map Generator API

Generate Normal, Roughness, Displacement and Ambient Occlusion maps from one texture

原始信息汇总

PBR Map Generator API 概述

基本信息

• 类别：视频、图像
• 提供方：Bitramen
• 订阅者数：1
• 定价：基础版（$0.00/月）、专业版（$5.99/月）

核心功能

根据单张漫反射或反照率纹理，生成生产级材质贴图，包括：

• Normal（法线贴图）
• Roughness（粗糙度贴图）
• Displacement（位移贴图）
• Ambient Occlusion（环境光遮蔽贴图）

使用场景

• 为3D产品配置器生成PBR材质
• 构建游戏和实时引擎的纹理处理流程
• 为Blender、Unreal Engine、Unity、Three.js、WebGL项目创建材质贴图
• 自动化资产库和电商目录的纹理增强
• 从源图像生成法线、粗糙度、高度和遮蔽资产

API 端点

• 请求方式：POST /api/generate
• 请求说明：上传纹理，选择要生成的贴图类型

请求头

头字段	必填	说明
X-RapidAPI-Key	是	RapidAPI消费者密钥
X-RapidAPI-Host	是	RapidAPI主机值
Accept	否	设置为 application/zip, image/png 以接受两种输出类型

表单数据参数

参数	类型	必填	默认值	说明
image	文件	是	—	源纹理，支持JPG、PNG、WebP、BMP、TIFF，最大20MB
maps	字符串	否	normal,roughness,displacement	逗号分隔的贴图名称，可选值：normal、roughness、displacement、ao
normal_strength	数字	否	1.0	法线贴图强度
roughness_contrast	数字	否	1.0	粗糙度贴图对比度乘数
roughness_invert	布尔	否	false	设为 true 时反转粗糙度贴图
displacement_blur	整数	否	3	位移贴图的平滑半径
displacement_contrast	数字	否	1.0	位移贴图对比度乘数
ao_strength	数字	否	1.0	环境光遮蔽强度乘数

响应说明

• 请求一种贴图：返回 image/png 格式的PNG文件，响应头 X-Map-Type 标明生成的贴图名称
• 请求多种贴图：返回 application/zip 格式的ZIP压缩包，内含每张贴图的PNG文件，响应头 X-Maps-Generated 列出生成的贴图名称

错误码

状态码	含义
400	不支持的图像类型、无效图像数据、无效参数或未请求有效贴图
401	缺少认证凭据
403	无效认证凭据
413	图像上传超过20MB限制
429	请求次数超限，稍后重试
500	处理意外失败

集成注意事项

• 仅请求一种贴图时直接使用PNG响应
• 请求多种贴图时保存并解压ZIP响应
• 使用光照均匀清晰的纹理可获得更可预测的输出
• 超过最大尺寸的图像会在处理前调整大小
• 仅处理有效贴图名称，未提供有效名称时返回400错误