Save over 30% when you subscribe to an annual subscription plan!

Random Image API

The Random Image API generates random images for all your placeholder and design needs. It supports custom sizes as well as custom image categories.

/v1/randomimage GET

https://api.api-ninjas.com/v1/randomimage

Returns a random, base64-encoded image in JPEG format.


Parameters

  • category  optionalpremium only

    Image category. If set, must be one of the following: nature, city, technology, food, still_life, abstract, wildlife.

  • width  optionalpremium only

    Width of the image to generate. Must be between 1 and 5000. Default value is 640.

  • height  optionalpremium only

    Height of the image to generate. Must be between 1 and 5000. Default value is 480.

Headers

  • X-Api-Key  required

    API Key associated with your account.

  • Accept  required

    Header indicating the content type to accept in the result. Must be set to the following: image/jpg.

Sample Request Live Demo!

https://api.api-ninjas.com/v1/randomimage

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

IMAGE

Code Examples

1 2 3 curl -X GET "https://api.api-ninjas.com/v1/randomimage?category=wildlife" \ -H "X-Api-Key: YOUR_API_KEY" \ --output random_image.jpg

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.