Amina API

1.0.0

Image generation and utilities API for the Amina Discord Bot.

Authentication

All /v1/* endpoints require API key authentication via Bearer token.

curl -H "Authorization: Bearer amina_YOUR_API_KEY" https://api.4mina.app/v1/images/rank-card?...

Get your API key at 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:

{
  "success": true,
  "data": { ... },
  "meta": {
    "generatedAt": "2024-01-01T00:00:00.000Z"
  }
}

Image endpoints return SVG directly with Content-Type: image/svg+xml.

This is version 1.0.0 of this API documentation. Last update on Dec 7, 2025.