Skip to main content
Version: V2

Face refiner

POST 
/v2/artworks/face-refiner

Clean up and sharpen faces in an image. Useful when a generated photo has good composition but the faces need an extra pass to look right.

Request​

Body

required

    imageUrl urirequired

    URL of the source image to refine.

    model string

    Possible values: [tengrai-20231128-m-d.safetensors, tengrai-20240423-m-f.safetensors]

    denoising integer

    Possible values: >= 1 and <= 5

    Default value: 3

    Denoising strength level from 1 (very subtle) to 5 (extreme). Controls how much the face is refined.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.

Responses​

Response indicating that the artwork was successfully created.

Schema

    id uuidrequired
    artworkType stringrequired

    Possible values: [face_refiner]

    parameters

    object

    required

    imageUrl uri

    URL of the source image to refine.

    model string

    Possible values: [tengrai-20231128-m-d.safetensors, tengrai-20240423-m-f.safetensors]

    denoising integer

    Possible values: >= 1 and <= 5

    Default value: 3

    Denoising strength level from 1 (very subtle) to 5 (extreme). Controls how much the face is refined.

    webhook uri

    Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.

    duration numberrequired
    results string[]required
    status stringrequired

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

    createdAt date-timerequired
Loading...