Patina Material

按实际用量计费
ae_patina_material

根据文本提示或图像创建无缝 PBR 材质纹理,包含基础颜色、法线、粗糙度、金属度和高度等贴图。

图像
按实际用量计费

价格说明

单次费用为(较大值(12 × 计费量(megapixels), 0))AE积分。各项条件同时适用,按所选条件计算合计费用。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
request_bodyobject是暂无参数说明。—
request_body.mapsarray否Which PBR maps to predict. Deselect all to skip PBR estimation entirely. Defaults to all five.—
request_body.seedinteger | unknown否Random seed for reproducible generation.—
request_body.promptstring是The text prompt describing the material/texture to generate.—
request_body.mask_urlstring | unknown否URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url.—
request_body.strengthnumber否How much to transform the input image. Only used when image_url is provided.0.75
request_body.image_urlstring | 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_sizeinteger否Tile size in latent space (64 = 512px, 128 = 1024px).128
request_body.image_sizeobject | string否Output texture dimensions in pixels.square_hd
request_body.image_size.widthinteger否The width of the generated image.512
request_body.image_size.heightinteger否The height of the generated image.512
request_body.num_imagesinteger否Number of texture images to generate.1
request_body.tile_strideinteger否Tile stride in latent space.64
request_body.tiling_modeenum (both | horizontal | vertical)否Tiling direction: 'both' (omnidirectional), 'horizontal', or 'vertical'.both
request_body.output_formatenum (jpeg | png | webp)否Output image format for textures and PBR maps.png
request_body.upscale_factorenum (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_stepsinteger否Number of denoising steps for texture generation.8
request_body.enable_safety_checkerboolean否Enable the safety checker for generated images.true
request_body.enable_prompt_expansionboolean否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
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。