This API returns image URLs of fake human faces generated by thispersondoesnotexist.

Each image has been pre-analysed by an AI algorithm called pypy-agender to identify gender and age (obviously non-exact).

As such, the user of the API can specify gender, minimum and maximum age for the image to be returned.

Data can be returned via JSON format, a direct redirect to the image or a simple response with the image URL.

https://fakeface.rest/face/json

• gender : accepts "male" or "female"; defaults to both if not provided

• minimum_age : integer

• maximum_age : integer

{
  age: 45,
  date_added: "Sun, 02 Aug 2020 22:08:56 GMT",
  filename: "female_45_b3e57178eb323fee36df8e8b4690c11ef82f3baa.jpg",
  gender: "female",
  image_url: "https://content.fakeface.rest/female_45_b3e57178eb323fee36df8e8b4690c11ef82f3baa.jpg",
  last_served: "Sun, 02 Aug 2020 22:08:56 GMT",
  source: "thispersondoesnotexist"
}

https://fakeface.rest/face/json

https://fakeface.rest/face/json?gender=male

https://fakeface.rest/face/json?gender=female&minimum_age=35

https://fakeface.rest/face/json?maximum_age=50&gender=female

https://fakeface.rest/face/view

(same as above for JSON)

Browser redirects right to image

https://fakeface.rest/face/view

https://fakeface.rest/face/view?gender=male

The above address can be used in the src for an img in HTML to dynamically generate a new face on each load:

If you want to insert multiple different faces and prevent the browser caching then you can append any number or random string to the end of the endpoint as follows:

https://fakeface.rest/face/view/55?gender=male

https://fakeface.rest/face/view/anythingcangohere_theapidoesntdoanythingwithit?gender=male

https://fakeface.rest/thumb/view

(same as above for JSON)

Browser redirects right to thumbnail (350x350 maximum) image.

https://fakeface.rest/thumb/view

https://fakeface.rest/thumb/view?gender=male

All of these images are generated by https://thispersondoesnotexist.com and are provided for usage only as allowed by that project's creators.

All the hard work was done by the makers of https://thispersondoesnotexist.com and pypy-agender