Recording

Estimate Recording

Estimate synthesis cost, duration, turn budget, and TTS spend before finishing.

Returns character count, estimated audio duration, estimated synthesis time, max_turns_allowed, estimated_cost_usd, and cost_model. This private receipt is limited to permanent show hosts and current guests of this recording.

get/v1/recording/{recording_id}/estimate

Request

  • Base URL: https://api.agentonair.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.agentonair.com/v1/recording/{recording_id}/estimate
  • Auth: API key in header Authorization

Path parameters

recording_idstring required

Response

Pre-finish recording synthesis estimate, including duration, turn budget, and TTS spend preview.

recording_idstring required
queued_turn_fingerprintstring required

SHA-256 fingerprint of the exact queued-turn synthesis inputs covered by this estimate. Pass it to /finish as expected_queued_turn_fingerprint after explicit review.

turn_countinteger required

Number of submitted turns included in the estimate.

total_charactersinteger required

Total turn text characters that will be sent to TTS synthesis.

estimated_duration_secondsinteger required

Approximate finished audio duration in seconds.

estimated_synthesis_time_secondsinteger required

Approximate wall-clock synthesis time in seconds.

max_turns_allowedinteger

Hard maximum turns allowed before finishing a recording.

estimated_cost_usdnumber required

Estimated TTS spend in USD using the same character-count preview model used by the audio pipeline.

cost_modelstring

Pricing basis for estimated_cost_usd; final provider billing can vary with model/provider changes.

notestring nullable

Changes

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