POST
Создать транскрипцию

Authorizations

Authorization
string
header
required

API-ключ в качестве токена носителя в заголовке авторизации

Body

Ввод запроса преобразования речи в текст. Принимает тело JSON с input_audio, содержащим звук в кодировке Base64.

input_audio
object
required

Звук в кодировке Base64 для расшифровки

Example:
model
string
required

Идентификатор модели STT

Example:

"openai/whisper-large-v3"

language
string

Код языка ISO-639-1 (например, «en», «ja»). Определяется автоматически, если опущено.

Example:

"en"

provider
object

Конфигурация транзитной передачи для конкретного поставщика

response_format
enum<string>

Формат вывода. "json" (по умолчанию) возвращает {текст, использование}. «verbose_json» дополнительно возвращает временные метки уровня задачи, языка, продолжительности и сегмента; поддерживается только поставщиками, совместимыми с OpenAI.

Available options:
json,
verbose_json
Example:

"json"

temperature
number<double>

Температура отбора проб для транскрипции

Example:

0

timestamp_granularities
enum<string>[]

Уровни детализации меток времени, которые следует включать, если для параметра response_format установлено значение «verbose_json». «сегмент» возвращает временные метки уровня сегмента; «word» дополнительно возвращает временные метки уровня слова в массиве слов. Игнорируется, если параметр response_format не имеет значения «verbose_json».

Уровень детализации временной метки для ответов на транскрипцию verbose_json.

Available options:
word,
segment
Example:

Response

Результат транскрипции

Ответ STT, содержащий расшифрованный текст и дополнительную статистику использования.

text
string
required

Записанный текст

Example:

"Hello, this is a test of OpenAI speech-to-text transcription. The weather is sunny today and the temperature is around 72 degrees."

duration
number<double>

Продолжительность входного аудио в секундах, присутствует, когда формат ответа имеет значение verbose_json.

Example:

9.2

language
string

Обнаруженный или принудительный язык, присутствует, когда формат ответа имеет значение verbose_json.

Example:

"english"

segments
object[]

Сегменты расшифровки с отметкой времени, присутствуют, когда параметр response_format имеет значение verbose_json.

task
string

Задача выполнена, отображается, когда формат_ответа имеет значение verbose_json.

Example:

"transcribe"

usage
object

Агрегированная статистика использования по запросу

Example:
words
object[]

Слова с метками времени, присутствуют, когда поставщик возвращает метки времени на уровне слова.