Patina Material
按实际用量计费
ae_patina_material
根据文本提示或图像创建无缝 PBR 材质纹理,包含基础颜色、法线、粗糙度、金属度和高度等贴图。
按实际用量计费
价格说明
单次费用为(较大值(12 × 计费量(megapixels), 0))AE积分。各项条件同时适用,按所选条件计算合计费用。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
request_body | object | 是 | 暂无参数说明。 | — |
request_body.maps | array | 否 | Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five. | — |
request_body.seed | integer | unknown | 否 | Random seed for reproducible generation. | — |
request_body.prompt | string | 是 | The text prompt describing the material/texture to generate. | — |
request_body.mask_url | string | unknown | 否 | URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url. | — |
request_body.strength | number | 否 | How much to transform the input image. Only used when image_url is provided. | 0.75 |
request_body.image_url | string | unknown | 否 | URL of an input image for image-to-image or inpainting. When provided without mask_url, performs image-to-image; with mask_url, performs inpainting. | — |
request_body.tile_size | integer | 否 | Tile size in latent space (64 = 512px, 128 = 1024px). | 128 |
request_body.image_size | object | string | 否 | Output texture dimensions in pixels. | square_hd |
request_body.image_size.width | integer | 否 | The width of the generated image. | 512 |
request_body.image_size.height | integer | 否 | The height of the generated image. | 512 |
request_body.num_images | integer | 否 | Number of texture images to generate. | 1 |
request_body.tile_stride | integer | 否 | Tile stride in latent space. | 64 |
request_body.tiling_mode | enum (both | horizontal | vertical) | 否 | Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'. | both |
request_body.output_format | enum (jpeg | png | webp) | 否 | Output image format for textures and PBR maps. | png |
request_body.upscale_factor | enum (0 | 2 | 4) | 否 | Upscale factor for predicted PBR maps via SeedVR seamless upscaling. 0 = no upscaling, 2 = 2× resolution, 4 = 4× resolution. The base texture image is not upscaled. | 0 |
request_body.num_inference_steps | integer | 否 | Number of denoising steps for texture generation. | 8 |
request_body.enable_safety_checker | boolean | 否 | Enable the safety checker for generated images. | true |
request_body.enable_prompt_expansion | boolean | 否 | Expand prompt with an LLM for richer detail. Adds ~0.0025 credits. | true |
调用示例
提交任务并查询完成结果
POST
/agent-api/v1/tool/executeX-Api-Key先提交任务,再用返回的 task_id 查询,直至完成。
请求代码request.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_patina_material' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"image_size": {
"height": 1024,
"width": 1024
},
"maps": [
"basecolor",
"normal"
],
"num_images": 1,
"prompt": "seamless tileable PBR game texture: aged brushed metal surface, light grey steel with faint horizontal brushing lines, small scratches, slight oxidation spots and dull patches, not rusty, semi-gloss worn paint hints, photorealistic, top-down flat view, even diffuse lighting, no shadows, no objects",
"seed": 909
}
}
}'返回示例response.json
{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "323379d7-268f-4e0d-bc3b-9b8296835f56"
}返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。






