---
title: "Voice-over (text to speech) — estimate"
method: POST
path: "/v1/ai/voice/estimate"
tags: ["Voice"]
---

# Voice-over (text to speech) — estimate

`POST /v1/ai/voice/estimate`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/ai/voice/estimate`
- Auth: HTTP bearer

Price the request without executing it. Same body as `POST /v1/ai/voice`.

## Request body

- object
  - `mood` string: A word for the director on the delivery: "motivational, builds to a shout", "calm explainer", "funny, deadpan"
  - `text` string, required
  - `model` 'auto' | 'eleven_multilingual_v2' | 'eleven_v3' | 'eleven_v4' | 'eleven_v4_turbo' | 'eleven_flash_v2_5' | 'eleven_turbo_v2_5': "auto" (the default) is always the newest model, eleven_v4 — the most emotive, speaks Hebrew, follows audio tags like [excited]. Name an older id only for a call that depends on it; Hebrew text always runs on eleven_v4, whatever is named
  - `speed` number
  - `style` number
  - `prepare` boolean: Hebrew: the voice director reads the text first (on by default) — niqqud on every Hebrew word (English words, brands and acronyms stay in Latin letters), an English delivery tag per sentence ([softly, smiling], [firmly], [yelling furiously, out of breath]…), a stability that fits; the words never change. Text that already carries your own tags or niqqud is reviewed, not skipped: your tags stay where they are and the words get their niqqud (a word you vocalised keeps your points when they fit the sentence). false = read exactly what you send
  - `quality` 'fast' | 'balanced' | 'best': Kept for older calls and ignored: every voice-over runs on the newest model ("auto")
  - `voice_id` string: GET /v1/ai/voices — a stock voice, or a voice you cloned (POST /v1/ai/voices/clone)
  - `next_text` string: The text that comes right after — the voice ends this one leading into it
  - `stability` number
  - `timestamps` boolean: Also return every word with its start/end (seconds) — to cut the take at its pauses, place it exactly, and time captions without a transcript
  - `language_code` string: Force a language, e.g. he
  - `previous_text` string: The text read just before this one (the previous passage) — the voice continues its flow instead of starting fresh
  - `similarity_boost` number

## Response `200`

Estimate

- Estimate
  - `operation` string
  - `estimated_credits` number
  - `credits_to_reserve` number
  - `estimated_usage` object
  - `note` string, nullable
  - `balance` object
    - `available` number
  - `sufficient` boolean

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)