Skip to main content
Version: v2

Face Refiner

POST 
/v2/studio/artworks/face-refiner

Start a face-refiner generation. Billed to your Studio credits. The result arrives by webhook or polling.

Request​

Body

required

    imageUrl urirequired

    URL of the source image to refine.

    model string

    Possible values: [Sun, Moon]

    Model variant (Sun / Moon). Optional — when omitted, the artwork is generated with both models. Mapped to the upstream model id at dispatch time.

    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.

    seed integer

    Possible values: >= 1 and <= 2147483647

    Optional random seed for deterministic generation. Range: 1-2147483647.

    outputFormat string

    Possible values: [auto, png, webp]

    Default value: auto

    Output image format. auto lets the provider pick. Supported: auto, png, webp.

    webhook uri

    Optional HTTPS callback URL. Receives a signed delivery when the artwork finalizes.

Responses​

Accepted — generation queued.

Schema

    id string

    Artwork id. Poll GET /studio/artworks/{id} or await the webhook.

Loading...