Skip to main content
Version: v2

Face Swap

POST 
/v2/studio/artworks/face-swap

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

Request​

Body

required

    sourceImage urirequired

    URL of the source image containing the face to swap from.

    targetImage urirequired

    URL of the target image containing the face to be replaced.

    denoising integer

    Possible values: >= 1 and <= 5

    Default value: 3

    Denoising strength level from 1 (very subtle) to 5 (extreme). Controls blending intensity.

    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...