---
title: "Analysis Quote"
method: GET
path: "/prompt/analysisQuote"
tags: ["AI Chat"]
---

# Analysis Quote

`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`

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.

## Query parameters

- `mediaId` string, required
- `analysisInput` 'audio' | 'video', required
- `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'

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `eligible` boolean: Whether this file can be analysed with this analysisInput right now.
    - `reason` string: Why the file cannot be analysed, in language you can show a user. Present only when eligible is false.
    - `credits` number: Credits the analysis would cost, on top of the normal chat cost. Zero when the file is not eligible.
    - `seconds` number: Duration of the media the quote was priced on, in seconds. Zero when the file is not eligible.

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)