Estimate an exact billable request

Validates the request with the same model contract, route controls, key limits and live pricing used at execution. Creates no credit hold and no model charge. The estimate expires after ten minutes and is a snapshot, not a price or capacity reservation.

post/estimates

Request

  • Base URL: https://api.openmayhem.ai/v1
  • URL: https://api.openmayhem.ai/v1/estimates
  • Auth: HTTP bearer

Headers

integer
OR
'T1' | 'T2' | 'T3' | 'T4'

Minimum acceptable provider attestation tier. Unlike the catalog's exact attestation_tier filter, dispatch accepts this tier or any higher tier.

X-Mayhem-Min-Ctxinteger

Text generation only. Minimum provider context capacity in tokens. The effective floor is never lower than the request's calculated input plus output requirement.

X-Mayhem-Quantstring
Example:nvfp4

Require one canonical quantization bucket; matching is case-insensitive after normalization.

X-Mayhem-Prefer-Providersstring

Ordered, comma-separated provider public keys. This is a strict provider set: failover follows the listed order and does not fall back outside the set.

X-Mayhem-Hedge0 | 1

Text generation only. Set to 1 to request hedged dispatch across eligible routes, or 0 to disable it. It cannot be combined with X-Mayhem-Prefer-Providers.

X-Mayhem-Min-Tok-Snumber

Minimum sustained throughput in the endpoint's native measured unit per second. For text this is tokens per second; other endpoint families use their Core-defined native unit.

X-Mayhem-Max-Wait-Msinteger

Maximum time in milliseconds to wait for an eligible provider admission. This is not the inference or asynchronous job runtime limit.

X-OpenMayhem-Max-Input-Price-Per-Million-Usdstring

Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.

Example:0.50

Price ceiling for the model of this request. The request is refused before any credit hold with 403 price_ceiling_exceeded when the model's retail input price per one million tokens (pricing.prompt_per_million_au) is higher. The catalog filter max_input_price_per_million_usd takes the same number. It has no effect on a model without an input token rate.

X-OpenMayhem-Max-Output-Price-Per-Million-Usdstring

Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.

Example:0.50

Price ceiling for the model of this request. The request is refused before any credit hold with 403 price_ceiling_exceeded when the model's retail output price per one million tokens (pricing.completion_per_million_au) is higher. The catalog filter max_output_price_per_million_usd takes the same number. It has no effect on a model without an output token rate.

X-OpenMayhem-Max-Representative-Request-Price-Usdstring

Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.

Example:0.50

Price ceiling for the model of this request. The request is refused before any credit hold with 403 price_ceiling_exceeded when the retail price of the model's representative request (pricing.representative_request_au) is higher. The catalog filter max_representative_request_price_usd takes the same number. Use it for media, audio, video and workflow models.

Request body

endpoint'CHAT' | 'COMPLETIONS' | 'RESPONSES' | 'EMBEDDINGS' | 'DECISIONS' | 'IMAGES' | 'VIDEOS' | 'AUDIO_SPEECH' | 'AUDIO_TRANSCRIPTIONS' | 'AUDIO_GENERATIONS' | 'MUSIC' | 'WORKFLOWS' required
bodyobject required

The exact endpoint request, including model.

Response

Expiring estimate with expected cost, maximum hold, price version and current can_start snapshot.

object'request.estimate' required
estimate_idstring required
endpoint'CHAT' | 'COMPLETIONS' | 'RESPONSES' | 'EMBEDDINGS' | 'DECISIONS' | 'IMAGES' | 'VIDEOS' | 'AUDIO_SPEECH' | 'AUDIO_TRANSCRIPTIONS' | 'AUDIO_GENERATIONS' | 'MUSIC' | 'WORKFLOWS' required
modelstring required
estimated_cost_usdstring required

Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.

maximum_cost_usdstring required

Non-negative decimal USD string with at most 6 decimal places, parsed with exact fixed-point arithmetic.

estimated_unitsobject
price_versionstring required
expires_atstring date-time required
can_startboolean required

Read-only current route and whole-rail funding snapshot; nothing is reserved.

Example response

{
  "estimated_cost_usd": "0.50",
  "maximum_cost_usd": "0.50"
}

Changes

No recorded changes to this operation across all 1 revision of this API.