Skip to main content
sunor enforces rate limits to ensure fair usage and platform stability. Limits are applied per API key across all endpoints.

​
Limits

ScopeLimit
Per API key120 requests / minute
All API endpoints share the same rate limit window. The limit resets every 60 seconds.

​
When you hit the limit

If you exceed the rate limit, the API returns a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait. 
{
  "code": 429,
  "message": "Rate limit exceeded. Try again in 30 seconds."
}

​
Response headers on 429

HeaderDescription
Retry-AfterNumber of seconds to wait before retrying

​
Best practices

Respect Retry-After

When you receive a 429 response, wait for the duration specified in the Retry-After header before making another request.

Use exponential backoff

For automated systems, implement exponential backoff when receiving rate limit errors to avoid hammering the API.

Batch wisely

Instead of submitting many tasks simultaneously, spread submissions over time to stay within limits.

Monitor remaining quota

Check X-RateLimit-Remaining in response headers to proactively slow down before hitting the limit.

​
Example: rate-limit-aware polling

import time
import requests

def poll_with_rate_limit(api_key, task_id, interval=5):
    while True:
        response = requests.get(
            f"https://sunor.cc/api/v1/task/{task_id}",
            headers={"x-api-key": api_key},
        )

        # Check rate limit headers
        remaining = int(response.headers.get("X-RateLimit-Remaining", 1))
        if remaining < 5:
            print("Approaching rate limit, slowing down...")
            interval = max(interval, 10)

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 30))
            print(f"Rate limited. Waiting {retry_after}s...")
            time.sleep(retry_after)
            continue

        data = response.json()["data"]
        if data["status"] in ("success", "failure", "timeout"):
            return data

        time.sleep(interval)