Patina Material
Usage-based pricing
ae_patina_material
Create seamless PBR material textures from a text prompt or image, with maps such as base color, normal, roughness, metalness, and height.
Usage-based pricing
Pricing
The charge per call is (max(12 × billable megapixels, 0)) AE credits. All applicable conditions are combined to calculate the total.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.maps | array | No | Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five. | — |
request_body.seed | integer | unknown | No | Random seed for reproducible generation. | — |
request_body.prompt | string | Yes | The text prompt describing the material/texture to generate. | — |
request_body.mask_url | string | unknown | No | URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url. | — |
request_body.strength | number | No | How much to transform the input image. Only used when image_url is provided. | 0.75 |
request_body.image_url | string | unknown | No | 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 | No | Tile size in latent space (64 = 512px, 128 = 1024px). | 128 |
request_body.image_size | object | string | No | Output texture dimensions in pixels. | square_hd |
request_body.image_size.width | integer | No | The width of the generated image. | 512 |
request_body.image_size.height | integer | No | The height of the generated image. | 512 |
request_body.num_images | integer | No | Number of texture images to generate. | 1 |
request_body.tile_stride | integer | No | Tile stride in latent space. | 64 |
request_body.tiling_mode | enum (both | horizontal | vertical) | No | Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'. | both |
request_body.output_format | enum (jpeg | png | webp) | No | Output image format for textures and PBR maps. | png |
request_body.upscale_factor | enum (0 | 2 | 4) | No | 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 | No | Number of denoising steps for texture generation. | 8 |
request_body.enable_safety_checker | boolean | No | Enable the safety checker for generated images. | true |
request_body.enable_prompt_expansion | boolean | No | Expand prompt with an LLM for richer detail. Adds ~0.0025 credits. | true |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
Request coderequest.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 exampleresponse.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"
}This example shows part of the response. Copied content is valid JSON.







