Response Headers
Makas metadata is conditional on the endpoint, response path and available routing/usage data. Check HTTP status first. Missing metadata does not itself mean a request failed, and metadata does not prove success.
Buffered inference metadata
| Header | Availability and meaning |
|---|---|
Makas-Was-Routed | Generated inference metadata; whether the model changed. Can be false on success. |
Makas-Model-Requested, Makas-Model-Used, Makas-Provider-Used | Available when a routing decision exists. Routing is same-provider. |
Makas-Routing-Rule | Only when a rule is attached to the decision. |
Makas-Cost-USD, Makas-Savings-USD, Makas-Savings-Percent | Require usage, a routing decision and known pricing. Monetary values are USD; savings percent is a percentage. Computed savings may be zero. |
Makas-Provider-Latency-Ms, Makas-Service-Overhead-Ms | Positive measured timings; milliseconds. |
Makas-Reasoning-Tokens, Makas-Cached-Input-Tokens | Only when usage supplies those counts. |
Read headers using cURL -i, Python SDK with_raw_response, Node SDK .withResponse() or the HTTP response object's headers. Complete examples are in OpenAI, Anthropic and Google.
Limits, correlation and errors
| Header family | Meaning |
|---|---|
Makas-RateLimit-Limit, Makas-RateLimit-Remaining, Makas-RateLimit-Reset, Makas-RateLimit-Type | Burst capacity in requests/minute, available request permits, Unix seconds for refill, and dimension type. |
Makas-Quota-Requests-Limit, Makas-Quota-Requests-Remaining, Makas-Quota-Requests-Reset | Monthly request counts and Unix-seconds quota-window end. |
Makas-Quota-Tokens-Limit, Makas-Quota-Tokens-Remaining, Makas-Quota-Tokens-Reset | Monthly token counts and Unix-seconds quota-window end. |
Makas-Provider-RateLimit-Limit, Makas-Provider-RateLimit-Remaining, Makas-Provider-RateLimit-Reset | Provider rate-limit values mapped from native provider headers; units and reset representation follow that provider, not the Makas burst bucket. |
Makas-Correlation-Id | Safe request correlation identifier; use when investigating errors. |
Makas-Circuit-Breaker-State | Synthetic circuit-breaker responses, when applicable. |
Makas-Api-Deprecated, Makas-Api-Sunset-Date, Makas-Api-Migration-Guide, Makas-Api-Sunset | Endpoint lifecycle metadata only on applicable paths. |
Limit families appear on rate-limited proxy paths when a snapshot is available. Unlimited dimensions omit the entire family; absence is not zero. Retry-After remains a standard HTTP header in seconds for retryable throttling. Monthly TOKEN_QUOTA_EXCEEDED / REQUEST_QUOTA_EXCEEDED are hard stops until reset or quota change, and do not promise a short retry interval.
Native provider authentication and standard headers keep their native names. Makas-* is reserved for metadata generated by Makas; upstream values cannot establish trusted Makas metadata.
Streaming
Initial status and headers arrive before terminal usage is known. HTTP 200 alone does not prove a complete stream. Final usage, cost and incomplete-stream outcomes belong in Request Logs after termination. Do not expect final cost/savings in HTTP headers, and handle disconnects and provider error events.