API: published rate & concurrency limits, and a `docs_url` on 429s
The API limits reference now lists the per-plan rate limits (sustained requests per second) and concurrency limits (simultaneous in-flight requests) for every plan on the audio (TTS) surface. Limits apply per account, not per API key.
429 Too Many Requests responses are now self-describing:
- A
Retry-Afterheader tells you when to retry. - The error
codedistinguishes the two cases:rate_limited(too many requests per second) versusconcurrency_limited(too many simultaneous requests). - The error envelope carries a
docs_urlthat links straight to the limits reference, which lists your plan’s limits and how to raise them.
Rate and concurrency limits rise with your plan, and Enterprise limits are starting points rather than hard caps.