Idempotency keys

Allternit supports idempotency keys on POST endpoints. Include an Idempotency-Key header to ensure that retries return the same result:
If the same Idempotency-Key is sent again within 24 hours, the server returns the cached response — no duplicate agent is created.

Retry strategy

Allternit returns standard HTTP status codes. Implement exponential backoff for transient errors:

Implementation

Rate limits

Rate limits are per-virtual-key. Check the response headers:
When Remaining hits 0, wait until the Reset timestamp before retrying.

Batch operations

For bulk operations, use the Batch Inference API instead of individual requests. Batches are processed asynchronously and are not subject to per-request rate limits.