Getting Started
The MinakiLabs API gives you programmatic access to ASCII art generation endpoints. To get started, create an API key from the API Keys page in your dashboard.
Each API call consumes tokens from your balance. You can purchase tokens or subscribe to a plan from the Subscriptions page.
Authentication
All API requests must include your API key in the X-API-Key header.
Requests without a valid key will receive a 401 Unauthorized response.
X-API-Key: YOUR_API_KEY
Endpoints
GET
/ascii
1 token
Returns a random ASCII art piece.
curl -X GET https://api.minakilabs.com/ascii \ -H "X-API-Key: YOUR_API_KEY"
GET
/ascii/heavy
25 tokens
Returns a complex, high-detail ASCII art piece.
curl -X GET https://api.minakilabs.com/ascii/heavy \ -H "X-API-Key: YOUR_API_KEY"
Token Costs
| Endpoint | Method | Cost |
|---|---|---|
| /ascii | GET | 1 token |
| /ascii/heavy | GET | 25 tokens |
Rate Limits
Rate limits vary by subscription plan. Exceeding limits returns a 429 Too Many Requests response.
| Plan | Requests / Day | API Keys Allowed |
|---|---|---|
| Free | 100 | 1 |
| Pro | 5,000 | 5 |
| Enterprise | 50,000 | 20 |