AI Chat

Analysis Quote

Check whether a media item can be analysed as audio or video, and what that will cost, before running a chat with analysisInput.

This is the only check that reflects both the account's premium opt-in and the platform-wide switch, so treat it as the answer on whether a run will work. An ineligible file is a normal 200 with eligible: false and a plain-English reason, not an error.

The quote shares its eligibility rules, duration cap, model resolution and credit conversion with the run itself, so the figure you get back is the figure the run is charged against.

get/prompt/analysisQuote

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/prompt/analysisQuote
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Query parameters

mediaIdstring required

The media item you want to price. Must belong to your company.

analysisInput'audio' | 'video' required

What the model would take in. Use "audio" to have it hear the recording, or "video" to have it watch the file. Audio on a video file is priced for the extracted audio track, which costs a fraction of a video pass and reaches longer files.

modelId'gpt-3.5' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0125' | 'gpt-4' | 'gpt-4-1106-preview' | 'gpt-4-turbo' | 'gpt-4o-2024-05-13' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4o-2024-08-06' | 'gpt-4o-mini-2024-07-18' | 'gpt-4.1-2025-04-14' | 'gpt-5.1-2025-11-13' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano' | 'gpt-5.5' | 'gpt-5.5-thinking' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude-2' | 'claude-3-5-sonnet' | 'claude-3-5-sonnet-20241022' | 'claude-3-7-sonnet-latest' | 'claude-haiku-4-5' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-opus-4-8' | 'gemini-1.5-pro' | 'gemini-1.5-flash' | 'gemini-2.0-flash' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3-flash-preview' | 'gemini-3.1-flash-lite' | 'gemini-3.1-pro-preview' | 'gemini-3.5-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | 'x-ai/grok-4.5' | 'z-ai/glm-5.2'

Price the run against a specific model. Optional. Leave it out and your company default is used, which is what the run itself would use.

Response

OK

statusstring

Changes

No recorded changes to this operation across all 2 revisions of this API.