Skip to main content

Reasons and how to fix

Polling too fast

Status endpoints allow 3,600 requests per hour per job type, about one per second. Poll each job every few seconds, or pass webhookUrl and only poll as a fallback. See webhooks.

Submitting a large batch at once

POST /import and POST /transcribe allow 240 requests per hour, and the metadata endpoints 1,000 combined. Spread submissions out, and on a 429, wait retryAfter seconds before you continue.

Watch the headers

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset, so you can slow down before you hit the limit. All limits are on Errors & rate limits.