> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kvantora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Озвучивание и транскрипция

> TTS и STT через приватные задания.

## Выберите операцию

Для озвучивания вызовите `POST /v1/audio/speech` с `model` и `input` (до 32000 символов). Транскрипция для внешних моделей сейчас недоступна. Её JSON-формат `POST /v1/audio/transcriptions` предусматривает `model` и `file_id` своего проверенного WAV или MP3.

Проверьте операцию в [каталоге](/models), права [ключа](/authentication) и [оценку стоимости](/billing). Значение `PUBLIC_API_ID` ниже замените публичным ID выбранной модели; это заполнитель, а не готовая модель.

## Тело запроса

Передайте `Authorization: Bearer <ключ>`, `Content-Type: application/json` и сохранённый `Idempotency-Key`. Для каждой новой генерации нужен отдельный ID.

<Tabs>
  <Tab title="Озвучивание">
    ```json theme={null}
    {
      "model": "PUBLIC_API_ID",
      "input": "Ваше обращение принято. Мы ответим в этом чате."
    }
    ```
  </Tab>

  <Tab title="Транскрипция">
    Загрузите свой файл по [инструкции](/files) и подставьте его `file_id`. Файл должен пройти проверку. Поле `file_id` содержит UUID, а не публичный URL.

    ```javascript theme={null}
    const body = {
      model: process.env.KVANTORA_MODEL_ID,
      file_id: process.env.KVANTORA_FILE_ID,
    };
    ```
  </Tab>
</Tabs>

## Получение результата

Оба endpoint возвращают асинхронное задание. После succeeded получите файл из output.file\_id. Озвучивание даёт аудио, транскрипция даёт UTF-8 TXT; его можно прочитать через GET /v1/files/FILE\_ID/content.

Проверяйте `GET /v1/jobs/ID`, пока задание не завершится. При статусе `unknown` не запускайте новую транскрипцию или озвучивание автоматически. [Состояния задания](/jobs) объясняют, когда можно получать файл и что делать при неопределённом исходе.

## Ограничения

JSON-контракт не принимает multipart, voice, language, скорость речи или поток аудио. Транскрипция сейчас недоступна для внешних моделей. Для озвучивания выбирайте доступную операцию с опубликованным фиксированным тарифом за запрос.