Skip to content
All docs

Reference

Response headers

Besides the body, every answer carries a few headers: what the call cost, what is left, what was dropped and how long to wait. Browsers can read them too.

Checked 26 October 2026

The headers

HeaderOnHolds
x-nokeep-creditsWhole repliesWhat the call cost, in credits. On a stream, read usage.nokeep_credits in the last chunk.
x-nokeep-balanceWhole repliesThe account’s bought credits after the call.
x-nokeep-ignoredAny call that dropped a fieldThe fields the model couldn’t take, comma-separated.
x-ratelimit-limit-requestsKeyed callsRequests a minute this key may send.
x-ratelimit-remaining-requestsKeyed callsRequests left in the current minute.
retry-afterEvery 429 and 503 busySeconds to wait before retrying.
x-nokeep-testTest-key calls1: the reply came from the test key, not a model.

The API allows calls from any web page, and exposes these headers to them.