Planium is an API to add text onto an image. This API is meant for you to use as it comes with lots of features. Images are cached, so don't worry about spamming the API. Planium is hosted on an Oracle Cloud (OCI) server with ARM64 based processing. The current cache limit is 50,000 unique photos, if there becomes a point where that is too little, then I will upgrade the server, but for now, this should do.
The source code can be found here.
| Method | Endpoint | Required Params | Optional Params | Size |
|---|---|---|---|---|
| GET | /api/v1/preset/stubby | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
600x440 |
| GET | /api/v1/preset/long | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
1200x440 |
| GET | /api/v1/preset/github | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
1280x640 |
| GET | /api/v1/preset/square | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
1280x1280 |
| GET | /api/v1/preset/giant | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
2400x880 |
| GET | /api/v1/preset/4K | text - The actual text to overlay | fontSize - The size of the font x - The x coordinate position y - The y coordinate position |
384x2160 |
Planium will return a response containing the text, fontSize, x, and y properties you passed in, but will also give you a path variable, which correlates to where the image is stored on Planium. Don't worry if the URL looks ugly, Planium uses Base58check to serialize the urls, this is done so you can put special characters such as %&^# in your text labels. Though I would stick to a UTF-8 Charset.
Note: You do not need to call the API with every value to receive it back, Planium is smart and will automatically format
each variable you don't give it, it just returns the variables back to you in case you wanted to see it or use it.
Another Note: The image path returned modifies the headers of the HTML object, meaning it will still be treated like a IMAGE/PNG, just without
the .png extension at the end.
{