Patina

12.00 credits/call + 12.00 credits/MP/map
ae_patina

Turn a photo or render into PBR texture maps, including base color, normal, roughness, metalness, and height maps.

Image
12.00 credits/call + 12.00 credits/MP/map

Pricing

12.00 credits/call + 12.00 credits/MP/map
ConditionCharge
Base fee per call12.00 credits/call
Output texture maps12.00 credits/megapixel/map

Based on actual output texture pixels; one megapixel is 1024 × 1024 pixels.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.mapsarrayNoWhich PBR maps to predict. Defaults to all five.—
request_body.seedinteger | unknownNoRandom seed for reproducible denoising. If not set, a random seed is used.—
request_body.image_urlstringYesURL of the input image (photograph or render).—
request_body.sync_modebooleanNoIf True, return images as data URIs instead of CDN URLs.false
request_body.output_formatenum (jpeg | png | webp)NoOutput image format.png
request_body.enable_safety_checkerbooleanNoEnable the safety checker for images.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' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "enable_safety_checker": true,
      "image_url": "https://v3b.fal.media/files/b/0ab1c142/oC7XXlvi-6-iXPKY95c8A.png",
      "maps": [
        "basecolor",
        "normal",
        "roughness",
        "metalness",
        "height"
      ],
      "output_format": "png"
    }
  }
}'
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": "8647e907-0985-4b9e-acd6-207dc352d6ad"
}

This example shows part of the response. Copied content is valid JSON.