A “turn” is one call to
POST /v1/agent (or one playground chat
message) - it includes the candidate picks and confirmations inside a
narrowing conversation. Paid turns (a positive balance) have no daily
cap: they settle per turn at the per-turn price.
When you hit a limit
You receive429 with:
Retry-After- seconds to wait
402 with
top-up options in the PAYMENT-REQUIRED header — see
Payments.
Back off and retry after the header says so. Never retry in a tight
loop - the answer to a rate limit is patience, not repetition.
Living within the limits
- A full narrowing conversation is typically 2-4 calls (candidates -> pick -> confirm).
- Questions about a previous answer (“how far was it?”) do not need a call - the facts are already in your last response.