Skip to main content

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​

HeaderAvailability and meaning
Makas-Was-RoutedGenerated inference metadata; whether the model changed. Can be false on success.
Makas-Model-Requested, Makas-Model-Used, Makas-Provider-UsedAvailable when a routing decision exists. Routing is same-provider.
Makas-Routing-RuleOnly when a rule is attached to the decision.
Makas-Cost-USD, Makas-Savings-USD, Makas-Savings-PercentRequire 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-MsPositive measured timings; milliseconds.
Makas-Reasoning-Tokens, Makas-Cached-Input-TokensOnly 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 familyMeaning
Makas-RateLimit-Limit, Makas-RateLimit-Remaining, Makas-RateLimit-Reset, Makas-RateLimit-TypeBurst 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-ResetMonthly request counts and Unix-seconds quota-window end.
Makas-Quota-Tokens-Limit, Makas-Quota-Tokens-Remaining, Makas-Quota-Tokens-ResetMonthly token counts and Unix-seconds quota-window end.
Makas-Provider-RateLimit-Limit, Makas-Provider-RateLimit-Remaining, Makas-Provider-RateLimit-ResetProvider rate-limit values mapped from native provider headers; units and reset representation follow that provider, not the Makas burst bucket.
Makas-Correlation-IdSafe request correlation identifier; use when investigating errors.
Makas-Circuit-Breaker-StateSynthetic circuit-breaker responses, when applicable.
Makas-Api-Deprecated, Makas-Api-Sunset-Date, Makas-Api-Migration-Guide, Makas-Api-SunsetEndpoint 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.