Skip to main content
Version: V2

Detailer Upscaler

POST 
/v2/artworks/detailer-upscaler

Sharpen fine details in an image and optionally upscale it. Set scaleFactor to 1 for detail enhancement only, or 2, 4, or 8 to combine enhancement with upscaling.

Request​

Body

required

    imageUrl urirequired

    The URL of the image. The image's total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216). Accepted image formats: JPEG, JPG, PNG, and WebP.

    scaleFactor integer

    Default value: 2

    Scale factor for upscaling. 1 = enhance details only (no upscaling), 2/4/8 = enhance details + upscale.

    details integer

    Possible values: >= 1 and <= 3

    Default value: 2

    Detail enhancement level. 1 = Low, 2 = Medium, 3 = High.

    modification integer

    Possible values: >= 1 and <= 3

    Default value: 2

    Modification strength. 1 = Subtle, 2 = Balanced, 3 = Strong.

    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. The Tengrai pipeline applies a deterministic transform (floor(seed * 1.2) + 17) before submitting to the workflow engine. Range: 1-2147483647. Omit to let the server pick a random seed.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion. Must be HTTPS and a publicly routable host — loopback, link-local, private, and cloud-metadata addresses are rejected.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto (the default) uses the server default (webp with high-quality settings); png is lossless; webp is equivalent to auto.

Responses​

Response indicating that the artwork enhancement has started.

Schema

    id uuidrequired
    artworkType stringrequired

    Possible values: [detailer_upscaler]

    parameters

    object

    required

    imageUrl uri

    The URL of the image. The image's total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216). Accepted image formats: JPEG, JPG, PNG, and WebP.

    scaleFactor integer

    Default value: 2

    Scale factor for upscaling. 1 = enhance details only (no upscaling), 2/4/8 = enhance details + upscale.

    details integer

    Possible values: >= 1 and <= 3

    Default value: 2

    Detail enhancement level. 1 = Low, 2 = Medium, 3 = High.

    modification integer

    Possible values: >= 1 and <= 3

    Default value: 2

    Modification strength. 1 = Subtle, 2 = Balanced, 3 = Strong.

    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. The Tengrai pipeline applies a deterministic transform (floor(seed * 1.2) + 17) before submitting to the workflow engine. Range: 1-2147483647. Omit to let the server pick a random seed.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion. Must be HTTPS and a publicly routable host — loopback, link-local, private, and cloud-metadata addresses are rejected.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto (the default) uses the server default (webp with high-quality settings); png is lossless; webp is equivalent to auto.

    duration numberrequired
    results string[]required
    status stringrequired

    Possible values: [starting, processing, succeeded, failed, canceled]

    createdAt date-timerequired
Loading...