Well, referencing the API documentation is fine, but we also should put a bit more usage information directly in our docs.
That can also be done after merging this (but before the next release), though.

What we should note, is that we do return the images as binary data (as opposed to like giving the url that was forwared to, which is the url of the image itself).
I had to read a bit in the code to make sure this is how it works.
Note that none of the other functions return anything other than json so far.