Vision

Rate Limits

Rate limits ensure fair usage and service stability for all customers. When you exceed a limit, the API returns a 429 Too Many Requests error.

Request Limits

All limits are per API key, per 24-hour rolling window.

EndpointRequests per Day
POST /images/upload100
POST /images/search100
POST /videos/upload50
POST /search50
POST /v1/creator/reels10

Rate Limit Headers

Every response includes headers to help you monitor your usage:

HeaderDescription
x-ratelimit-requests-limitMaximum requests allowed in the time window
x-ratelimit-requests-remainingRequests remaining in the current window
x-ratelimit-requests-resetSeconds until the rate limit window resets
retry-afterSeconds to wait before retrying (0 if allowed, positive if rate limited)

Example

HTTP/1.1 429 Too Many Requests
x-ratelimit-requests-limit: 100
x-ratelimit-requests-remaining: 0
x-ratelimit-requests-reset: 86400
retry-after: 3600

Handling 429 Errors

When you hit a rate limit:

  1. Check X-RateLimit-Reset to know when you can retry
  2. Implement exponential backoff in your application
  3. Consider batching operations where possible
1{
2  "error": {
3    "code": "rate_limit_exceeded",
4    "message": "You have exceeded your daily request limit for this endpoint."
5  }
6}

Higher Limits

Enterprise plans offer significantly higher limits. Contact us if you need:

  • Higher request quotas
  • Increased content size limits

For pricing information, see the Vision Pricing page.