Rate Limits

API rate limits

API endpoints (/api/v2/generate and /v1/chat/completions) use a single limit: 30 requests per minute per account. The limit is the same for all plans.

Bot rate limits by plan

This table is for the Telegram bot, not for API responses:

Plan	Per Hour	Per Day	Notes
free	20	150	Free plan
basic	30	200	All models
pro	60	500	All models
vip	100	1,000	All models + API access
elite	∞	∞	No limits

Bot limits are applied per user account, not per API key.

Rate Limit Headers

OpenAI-compatible API responses (/v1/chat/completions) include only:

X-RateLimit-Limit: 30
X-Token-Balance: 1000

X-RateLimit-Remaining and X-RateLimit-Reset are not returned in API responses.

Handling rate limit errors

{
  "error": {
    "message": "Rate limit exceeded. Max 30 requests per minute.",
    "type": "invalid_request_error",
    "param": null,
    "code": 429
  }
}

When the limit is exceeded, status 429 is returned.

Best Practices

Implement exponential backoff

Don’t hammer the API after a 429. Wait, then retry with increasing delays:

import time
import requests

def request_with_backoff(url, headers, payload, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=payload)
        if response.status_code == 429:
            retry_after = 2 ** attempt
            time.sleep(retry_after)
            continue
        return response
    raise Exception("Max retries exceeded")

Monitor limits proactively

Use the API docs values (30 requests/minute) to size your retry schedule; these are not per-plan for API.

Batch where possible

For bulk tasks (e.g. generating 100 images), spread requests over time.

Auth Endpoint Limits

Authentication endpoints have stricter rate limits to prevent abuse:

Endpoint	Limit
`POST /auth/login`	10 requests/min per IP
`POST /auth/register`	10 requests/min per IP
`POST /auth/forgot-password`	3 requests/hour per IP

Getting Started

Concepts

Guides

Generate

Generations (results)

OpenAI compatibility

Models

User

API Keys

Assistants

Payments

Schedules

Auth

Resources

API rate limits

Bot rate limits by plan

Rate Limit Headers

Handling rate limit errors

Best Practices

Auth Endpoint Limits

​API rate limits

​Bot rate limits by plan

​Rate Limit Headers

​Handling rate limit errors

​Best Practices

​Auth Endpoint Limits

API rate limits

Bot rate limits by plan

Rate Limit Headers

Handling rate limit errors

Best Practices

Auth Endpoint Limits