Skip to main content

Enterprise: Face Generator Endpoint

Overview​

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

Face gen endpoint result
caution

Make sure you add your s3 details for image_editing server, so you can receive image generated in your bucket. Images generated without s3 details being added will be delete after 24hours

Request​

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

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

Body Attributes​

ParameterDescription
keyYour API Key used for request authorization
promptText prompt with description of the things you want in the image to be generated.
face_imageLink or valid base64 data which follows data:image/jpeg;base64,{your_base64_string} to the image of the face you want your generations to resemble.
widthWidth of your generated image. Max dimension: 512 x 768
heightHeight of your generated image. Max dimension: 512 x 768
num_inference_stepsNumber of denoising steps. Value accepted are 21,31 or 41
guidance_scaleScale for classifier-free guidance.
style This is required to generate output image in particular style. Default value is realistic. Options comic, chibi, 3d, anime and realistic.
s_scaleadjust the weight of the face structure [float][0.0 to 2.0] [default 1.0].
samplesNumber of images to be returned in response. The maximum value is 2.
safety_checkerWhether to run the safety checker to prevent NSFW image generation. One of true or false.
safety_checker_typeMust be one of black, blur, sensitive_content_text, pixelate
base64If provided face_image is in base64 format or if you want your generated images as a base64 string, must be set to true. Default: false.
webhookSet an URL to get a POST API call once the image generation is complete.
track_idThis ID is returned in the response to the webhook API call. This will be used to identify the webhook request.

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/v1/enterprise/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
    }
}