# Amina API ## Description This is version `1.0.0` of this API documentation. Last update on Dec 7, 2025. Image generation and utilities API for the Amina Discord Bot. ## Authentication All `/v1/*` endpoints require API key authentication via Bearer token. ```bash curl -H "Authorization: Bearer amina_YOUR_API_KEY" https://api.4mina.app/v1/images/rank-card?... ``` Get your API key at [4mina.app/dash](https://4mina.app/dash) ## Rate Limiting All endpoints, including status checks (e.g. `/v1/bots/{clientId}/status`), are subject to rate limits: - **60 requests per minute** per API key - Rate limit headers included in responses: - `X-RateLimit-Limit`: Maximum requests per window - `X-RateLimit-Remaining`: Requests remaining - `X-RateLimit-Reset`: Unix timestamp when limit resets If you exceed the limit, you will receive a `429 Rate Limited` response. Status endpoints are lightweight but still count toward your quota. ## Response Format All JSON responses follow this structure: ```json { "success": true, "data": { ... }, "meta": { "generatedAt": "2024-01-01T00:00:00.000Z" } } ``` Image endpoints return SVG directly with `Content-Type: image/svg+xml`. ## Servers - Production: https://api.4mina.app (Production) ## Authentication ## Endpoints and operations ### [Bots](https://docs.api.4mina.app/doc/v1/group/endpoint-bots.md) - [List all public bots (paginated)](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-bots.md) - [Get bot information](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-bots-parameter.md) - [Get bot statistics](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-bots-parameter-stats.md) - [Get bot commands](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-bots-parameter-commands.md) - [Check bot online status](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-bots-parameter-status.md) ### [Cards](https://docs.api.4mina.app/doc/v1/group/endpoint-cards.md) - [Generate a rank card](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-rank-card.md) - [Generate a welcome card](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-welcome-card.md) - [Generate a farewell card](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-farewell-card.md) - [Generate a Spotify "Now Playing" card](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-spotify-card.md) ### [Filters](https://docs.api.4mina.app/doc/v1/group/endpoint-filters.md) - [Convert image to greyscale](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-greyscale.md) - [Apply blur effect](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-blur.md) - [Apply sepia filter](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-sepia.md) - [Invert image colors](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-invert.md) - [Brighten an image](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-brighten.md) - [Darken an image](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-darken.md) - [Adjust contrast](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-contrast.md) - [Pixelate effect](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-pixelate.md) - [Adjust saturation](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-saturate.md) - [Rotate hue](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-filters-hue-rotate.md) ### [Overlays](https://docs.api.4mina.app/doc/v1/group/endpoint-overlays.md) - [Add "APPROVED" stamp](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-approved.md) - [Add "REJECTED" stamp](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-rejected.md) - [GTA "WASTED" effect](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-wasted.md) - ["TRIGGERED" meme effect](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-triggered.md) - [Prison bars overlay](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-jail.md) - [Rainbow pride overlay](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-gay.md) - [R.I.P. gravestone effect](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-overlays-rip.md) ### [Generators](https://docs.api.4mina.app/doc/v1/group/endpoint-generators.md) - ["Change My Mind" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-changemymind.md) - [Drake approve/disapprove meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-drake.md) - ["Book of Facts" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-facts.md) - ["Does this affect my baby?" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-affect.md) - ["It's beautiful" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-beautiful.md) - ["Delet this" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-delete.md) - ["It's Trash" meme](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-trash.md) - [Distracted boyfriend meme labels](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-generators-distracted.md) ### [Utilities](https://docs.api.4mina.app/doc/v1/group/endpoint-utilities.md) - [Generate a solid color image](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-color.md) - [Circle crop an image](https://docs.api.4mina.app/doc/v1/operation/operation-get-v1-images-circle.md) ### [Webhooks](https://docs.api.4mina.app/doc/v1/group/endpoint-webhooks.md) - [Transform and forward webhooks to Discord](https://docs.api.4mina.app/doc/v1/operation/operation-post-webhooks-parameter-parameter-parameter.md) - [Webhook transformer UI](https://docs.api.4mina.app/doc/v1/operation/operation-get-webhooks.md) [Powered by Bump.sh](https://bump.sh)