Получение данных стенограммы
Эндпоинт возвращает данные стенограммы для указанной записи на основе уникального кода заказа. Пользователь должен предоставить уровень детализации речи и уникальный код заказа. Уровень детализации речи по умолчанию установлен на
, но может быть задан как simple
.
detailed
Эндпоинт проверяет валидность API ключа и удостоверяется, что конференция принадлежит текущему пользователю. В случае успеха возвращаются данные стенограммы.
Запрос:
-
URL:
/file/transcript
-
Метод:
GET
Параметры:
1. Query параметры:
-
(string, необязательный): Уровень детализации речи в ответе API.speech_details_level
-
Описание: Уровень детализации речи в ответе API.
-
Значение по умолчанию:
simple
-
Возможные варианты:
simple
,detailed
-
-
(string, обязательный): Уникальный код заказа.order_code
2. Header параметры:
-
(string, обязательный): API-ключ для авторизации в форматеAuthorization
Bearer {api_key}
.
Ответ:
- Возвращает данные стенограммы записи.
Ошибки:
-
: Возникает, если запись не найдена.ItemNotFound
detailed:
представляет собой список объектов слов, состоящих из 4 элементов:
text
-
начала словаtimestamp
-
конца словаtimestamp
- Степень уверенности в слове [0, 1]
- Слово (включает в себя следом идущий знак препинания и пробельный символ)
{
"speakers": [
{"id": 0, "name": "Спикер 0"},
{"id": 1, "name": "Спикер 1"}
],
"speeches": [
{
"id": 0,
"speaker_id": 0,
"timestamp": 0.2805,
"end_timestamp": 1.3023,
"text": [
[0.2805, 0.3287, 1.0, "Ехал "],
[0.3358, 0.4975, 1.0, "Грека "],
[0.5467, 0.7654, 1.0, "через "],
[0.9765, 1.3023, 1.0, "реку."],
]
},
{
"id": 1,
"speaker_id": 1,
"timestamp": 1.6746,
"end_timestamp": 1.7456,
"text": [
[1.6746, 1.7456, 1.0, "Понятно!"]
]
},
]
}
simple: text
представляет собой полный текст реплики в виде строки
{
"speakers": [
{"id": 0, "name": "Спикер 0"},
{"id": 1, "name": "Спикер 1"}
],
"speeches": [
{
"id": 0,
"speaker_id": 0,
"timestamp": 0.2805,
"end_timestamp": 1.3023,
"text": "Ехал Грека через реку."
},
{
"id": 1,
"speaker_id": 1,
"timestamp": 1.6746,
"end_timestamp": 1.7456,
"text": "Понятно!"
},
]
}