Skip to main content

Face Generator Endpoint

Overview​

This endpoint allows you to generate image with the face image provided

Face gen endpoint result

caution

Image url generated will not be accessible after 24 hours, kindly save your image generations accordingly

Request​

--request POST 'https://modelslab.com/api/v6/image_editing/face_gen' \

Make a POST request to https://modelslab.com/api/v6/image_editing/face_gen endpoint and pass the required parameters as a request body to the endpoint.

Body Attributes​

ParameterDescriptionValues
keyYour API Key used for request authorizationstring
promptThe text prompt describing the content you want in the generated imagestring
face_imageA link or valid base64 data of the face you want your generations to resemble. The format should be data:image/jpeg;base64,{your_base64_string}URL or base64 string
widthThe width of the generated image. The maximum dimension is 512 x 768 pixelsinteger (max: 512)
heightThe height of the generated image. The maximum dimension is 512 x 768 pixelsinteger (max: 768)
num_inference_stepsThe number of denoising steps. The acceptable values are 21, 31, or 41integer (21, 31, or 41)
guidance_scaleThe scale for classifier-free guidance. The minimum is 1 and the maximum is 20integer (1 to 20)
s_scaleAdjust the weight of the face structure. This should be a float between 0.0 and 2.0. The default is 1.0float (0.0 to 2.0) (default: 1.0)
samplesThe number of images to be returned in response. The maximum value is 2integer (max: 2)
safety_checkerWhether to run the safety checker to prevent NSFW image generation. This should be either true or falseboolean (true or false)
safety_checker_typeThe type of safety checker to use. Must be one of black, blur, sensitive_content_text, or pixelatestring (black, blur, sensitive_content_text, pixelate)
base64Set to true if the provided face image is in base64 format or if you want your generated images as a base64 string. The default is falseboolean (true or false) (default: false)
style This is required to generate output image in particular style. Default value is realistic.Options comic, chibi,3d, anime and realistic
webhookProvide a URL to receive a POST API call once the image generation is completeURL
track_idThis ID is returned in the response to the webhook API call and will be used to identify the webhook requestintegral value

Example​

Body​

Body
{
  "key": "",
  "prompt": "pretty woman",
  "negative_prompt": "anime, cartoon, drawing, big nose, long nose, fat, ugly, big lips, big mouth, face proportion mismatch, unrealistic, monochrome, lowres, bad anatomy, worst quality, low quality, blurry",
  "face_image":"https://media.allure.com/photos/647f876463cd1ef47aab9c88/3:2/w_2465,h_1643,c_limit/angelina%20jolie%20blonde%20hair%20chloe.jpg",
  "width": "512",
  "height": "512",
  "samples": "1",
  "num_inference_steps": "21",
  "safety_checker": false,
  "base64": false,
  "seed": null,
  "guidance_scale": 7.5,
  "webhook": null,
  "track_id": null

}

Request​

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
     "key": "",
    "prompt": "pretty woman",
    "negative_prompt": "anime, cartoon, drawing, big nose, long nose, fat, ugly, big lips, big mouth, face proportion mismatch, unrealistic, monochrome, lowres, bad anatomy, worst quality, low quality, blurry",
    "face_image":"https://media.allure.com/photos/647f876463cd1ef47aab9c88/3:2/w_2465,h_1643,c_limit/angelina%20jolie%20blonde%20hair%20chloe.jpg",
    "width": "512",
    "height": "512",
    "samples": "1",
    "num_inference_steps": "21",
    "safety_checker": false,
    "base64": false,
    "seed": null,
    "guidance_scale": 7.5,
    "webhook": null,
    "track_id": null  
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://modelslab.com/api/v6/image_editing/face_gen", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Response​

Example Response

{
    "status": "success",
    "generationTime": 7.358475685119629,
    "id": 32,
    "output": [
        "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/temp/8c3ef6ea-1c44-4d69-91cb-fc11971a65d1-0.png"
    ],
    "proxy_links": [
        "https://cdn2.stablediffusionapi.com/temp/8c3ef6ea-1c44-4d69-91cb-fc11971a65d1-0.png"
    ],
    "meta": {
        "base64": "no",
        "face_image": "https://media.allure.com/photos/647f876463cd1ef47aab9c88/3:2/w_2465,h_1643,c_limit/angelina%20jolie%20blonde%20hair%20chloe.jpg",
        "file_prefix": "8c3ef6ea-1c44-4d69-91cb-fc11971a65d1",
        "guidance_scale": 7.5,
        "height": 512,
        "negative_prompt": "anime, cartoon, drawing, big nose, long nose, fat, ugly, big lips, big mouth, face proportion mismatch, unrealistic, monochrome, lowres, bad anatomy, worst quality, low quality, blurry",
        "num_inference_steps": 21,
        "outdir": "out",
        "prompt": "pretty woman",
        "safety_checker": "no",
        "safety_checker_type": "blur",
        "samples": 1,
        "seed": 4029484891,
        "temp": "yes",
        "width": 512
    }
}