Usage Examples

Learn how to make the most out of Lorem Toneflix by following the examples we provide here.

Anything Random

By Default, Lorem Toneflix will return a random image when ever called.

https://lorem.toneflix.com.ng/images

Image Resolution

You can also dictate what resolutions that generated images should be in by passing the w and h query parameters representing width and height respectively

https://lorem.toneflix.com.ng/images?w=100&h=100

Category

Lorem Toneflix currently supports the following categories avatar, album, event, poster, and technology, to request a specific category, call the images/{category} endpoint, where {category} is one of the currently supported categories.

https://lorem.toneflix.com.ng/images/avatar

Text

To add text on top of an image, simply pass the text to to the text query parameter or pass true to add the file name on the image, usefull if you intend to use the image name to return a particular image at all times.

https://lorem.toneflix.com.ng/images?text=I+Love+You

OR

https://lorem.toneflix.com.ng/images?text=true

Filters

Lorem Toneflix provides a few filters to help you customize your images.

Some filters accept an optional parameter in which case they can be passsed by appending it to the filter name separated by a :, E.g: filters=blur:10

Blur | :amount

Allows you to add gausian blur to your image, accepts an optional amount parameter.

https://lorem.toneflix.com.ng/images/avatar?filters=blur:15

Note: The blur filter puts a lot of strain on the server, this is evident on the amount of time it takes to process as the amount is increased, be respectfull to others using the services and set only a resonable value for the amount. We may block origins and IPs that repeatedly overuse our resources.

Invert

Allows you invert all colors of the image.

https://lorem.toneflix.com.ng/images/avatar?filters=invert

Sharpen | :amount

Allows you sharpen the image.

https://lorem.toneflix.com.ng/images/avatar?filters=sharpen:15

Pixelate | :amount

Allows you pixelate the image.

https://lorem.toneflix.com.ng/images/avatar?filters=pixelate:7

Greyscale

Turn image into a greyscale version.

https://lorem.toneflix.com.ng/images/avatar?filters=greyscale

Combining Filters

Filters can also be combined to create more effects.

https://lorem.toneflix.com.ng/images/avatar?filters=greyscale,pixelate:10,blur:5