Use Patina with Comfy Router

Call fal/patina through Comfy Router: endpoint, request shape and the response Router returns.

API Reference for fal/patina, served by Comfy Router from fal.

Quick start

Create a key in your Comfy workspace and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP.

Model ID: fal/patina

Endpoint: POST https://api.comfy.org/v2/models/fal/patina

Python

from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.
with Comfy() as client:
    result = client.models.run(
        "fal/patina",
        {
            "image_url": "https://storage.googleapis.com/falserverless/gallery/patina-blog-hero-render.png",
        },
    )

print(result)

Schema

Input

enable_safety_checker · boolean · default: "true"

Enable the safety checker for images.

image_url · string · required

URL of the input image (photograph or render).

maps · string[]

Which PBR maps to predict. Defaults to all five.

output_format · string · default: "\"png\""

Output image format: jpeg, png, or webp.

seed · integer

Random seed for reproducible denoising.

sync_mode · boolean · default: "false"

If true, return images as data URIs instead of CDN URLs.

Generated from the schema Router serves at GET /v2/models/fal/patina/openapi.json, the same document it validates a call against before the request reaches the provider.

Output

images · object[]

Generated tileable texture image plus the predicted PBR material maps. The base texture has only a url; each map entry also carries a map_type.

images[].map_type · string

The PBR map type (basecolor, normal, roughness, metalness, height). Absent for the base texture image.

images[].url · string

URL of the generated image.

prompt · string

The prompt used for texture generation (possibly expanded).

seed · integer

Seed used for texture generation.

timings · object

End-to-end timing breakdown (seconds).

Examples

Input

{
  "image_url": "https://storage.googleapis.com/falserverless/gallery/patina-blog-hero-render.png"
}

Output

{
  "images": [
    {
      "map_type": "basecolor",
      "url": "https://example.invalid/fal/patina/basecolor.png"
    },
    {
      "map_type": "normal",
      "url": "https://example.invalid/fal/patina/normal.png"
    },
    {
      "map_type": "roughness",
      "url": "https://example.invalid/fal/patina/roughness.png"
    }
  ],
  "prompt": "weathered copper roof tiles",
  "seed": 1234567,
  "timings": {
    "inference": 6.25
  }
}

Before you ship

The SDKs create an Idempotency-Key and reuse it for automatic retries. For manual retries, reuse the original key. Router can hold the connection for up to 10 minutes.

When a request fails, Router sends an X-Comfy-Error-Type response header explaining why. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Using the Router API

Model discovery, validation errors, retries, and billing.

Limitations

What Router does not do today, and what to use instead.