---
title: "Exact text meter, voice surcharge and price before creating speech"
method: POST
path: "/v1/speech/estimate"
tags: ["platform-api"]
---

# Exact text meter, voice surcharge and price before creating speech

`POST /v1/speech/estimate`

## Request

- Base URL: `https://api.cuddler.ai`
- URL: `https://api.cuddler.ai/v1/speech/estimate`
- Auth: HTTP bearer

## Request body

- object
  - `model` 'elevenlabs-v4' | 'elevenlabs-v4-turbo' | 'elevenlabs-flash-v2.5' | 'fish-s2.1-pro' | 'gemini-3.8-flash-tts' | 'gemini-3.8-flash-lite-tts' | 'minimax-speech-2.8-hd' | 'minimax-speech-2.8-turbo', required
  - `text` string
  - `voice_id` string
  - `dialogue` object[]
    - `voice_id` string, required
    - `text` string, required
  - `output_format` 'mp3'
  - `max_usd` string: Maximum USD this job may charge; creation refuses a larger hold and settlement never exceeds this ceiling
  - `webhook_url` string, uri
  - `metadata` object

## Response `200`

Frozen text meter and price

- object
  - `object` 'speech_estimate', required
  - `model` 'elevenlabs-v4' | 'elevenlabs-v4-turbo' | 'elevenlabs-flash-v2.5' | 'fish-s2.1-pro' | 'gemini-3.8-flash-tts' | 'gemini-3.8-flash-lite-tts' | 'minimax-speech-2.8-hd' | 'minimax-speech-2.8-turbo', required
  - `meter` 'character' | 'utf8_byte' | 'utf16_unit' | 'audio_token' | 'minimax_character', required
  - `units` integer, required
  - `usd` string, required
  - `usd_micros` integer, required
  - `hold_usd` string, required
  - `price_version` string, required

## Other responses

- `400`: Invalid request or maximum USD
- `401`: unauthorized — no key, or an unknown or revoked one (WWW-Authenticate: Bearer)
- `403`: organization_suspended — the organization is not active; forbidden — a test key on a live-only route
- `404`: not_found — the Platform API is switched off, or the object does not exist
- `429`: rate_limited — over this key's requests per minute (Retry-After)
- `500`: internal_error — quote request_id when contacting support
- `503`: Price configuration unavailable

---

[API](https://skmtc.dev/cuddler/apis/cuddler-platform-api.md) · [All operations](https://skmtc.dev/cuddler/apis/cuddler-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cuddler/apis/cuddler-platform-api/revisions/f03943ceadff?raw)