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.

Image
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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.mapsarrayNoWhich PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five.—
request_body.seedinteger | unknownNoRandom seed for reproducible generation.—
request_body.promptstringYesThe text prompt describing the material/texture to generate.—
request_body.mask_urlstring | unknownNoURL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url.—
request_body.strengthnumberNoHow much to transform the input image. Only used when image_url is provided.0.75
request_body.image_urlstring | unknownNoURL 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_sizeintegerNoTile size in latent space (64 = 512px, 128 = 1024px).128
request_body.image_sizeobject | stringNoOutput texture dimensions in pixels.square_hd
request_body.image_size.widthintegerNoThe width of the generated image.512
request_body.image_size.heightintegerNoThe height of the generated image.512
request_body.num_imagesintegerNoNumber of texture images to generate.1
request_body.tile_strideintegerNoTile stride in latent space.64
request_body.tiling_modeenum (both | horizontal | vertical)NoTiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'.both
request_body.output_formatenum (jpeg | png | webp)NoOutput image format for textures and PBR maps.png
request_body.upscale_factorenum (0 | 2 | 4)NoUpscale 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_stepsintegerNoNumber of denoising steps for texture generation.8
request_body.enable_safety_checkerbooleanNoEnable the safety checker for generated images.true
request_body.enable_prompt_expansionbooleanNoExpand 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-Key

Submit 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
JSONPartial content
{
  "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.