PATINA Material Extract
Patina
Patina 材质提取
- PATINA Material Extract 模型,从现有图像中提取纹理并生成完整 PBR material
- 异步处理模式,使用返回的任务ID 进行查询
- 生成的图像链接,有效期为24小时,请尽快保存
POST
PATINA Material Extract
授权
所有接口均需要使用Bearer Token进行认证
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
patina-material-extract:从图片提取纹理和 PBR maps
示例:
"patina-material-extract"
输入图片的公开 URL
说明:
- 用于提取材质的源图片
- 必须为公开可访问的 URL
示例:
"https://example.com/wall-photo.jpg"
要生成的 PBR map 类型列表
可选值:
basecolor— 基础色贴图normal— 法线贴图roughness— 粗糙度贴图metalness— 金属度贴图height— 高度贴图
示例:
["basecolor", "normal", "roughness"]蒙版图片的公开 URL
说明:
- 指定从图片的哪个区域提取材质
示例:
"https://example.com/mask.png"
输出图像边长(像素)
说明:
- 控制提取的纹理和 PBR maps 尺寸
示例:
512
放大倍率
说明:
- 对输出材质进行放大处理
- 启用会增加计费
非必须不要传这个参数。
示例:
2
响应
任务创建成功
任务创建时间戳
示例:
1757165031
任务ID
示例:
"task-unified-1757165031-uyujaw3d"
实际使用的模型名称
任务的具体类型
可用选项:
image.generation.task 任务进度百分比 (0-100)
必填范围:
0 <= x <= 100示例:
0
任务状态
可用选项:
pending, processing, completed, failed 示例:
"pending"
异步任务信息
任务的输出类型
可用选项:
image 示例:
"image"