Retries, idempotency, and request IDs
- GET requests may be retried after a connection failure or timeout with exponential backoff and random jitter.
- When retrying an AI POST, reuse the same UUID
Idempotency-Keyfor the same business operation. - For
429, honorRetry-Afterwhen present and reduce concurrency.401,403, and insufficient balance are not transient. - A
5xxor dropped connection can have an uncertain result. Retry only with a defined idempotency policy, maximum attempts, and total deadline.
You may send a UUID X-Request-Id for each business request. The platform also returns a request ID. Give support only this ID, the time, and a safe error code—not the request or response body.