Table of contents

Получение данных стенограммы

Эндпоинт возвращает данные стенограммы для указанной записи на основе уникального кода заказа. Пользователь должен предоставить уровень детализации речи и уникальный код заказа. Уровень детализации речи по умолчанию установлен на simple, но может быть задан как detailed.

Эндпоинт проверяет валидность API ключа и удостоверяется, что конференция принадлежит текущему пользователю. В случае успеха возвращаются данные стенограммы.

Запрос:

  • URL: /file/transcript
  • Метод: GET

Параметры:

1. Query параметры:

  • speech_details_level (string, необязательный): Уровень детализации речи в ответе API.
    • Описание: Уровень детализации речи в ответе API.
    • Значение по умолчанию: simple
    • Возможные варианты: simple, detailed
  • order_code (string, обязательный): Уникальный код заказа.

2. Header параметры:

  • Authorization (string, обязательный): API-ключ для авторизации в формате Bearer {api_key}.

Ответ:

  • Возвращает данные стенограммы записи.

Ошибки:

  • ItemNotFound: Возникает, если запись не найдена.

detailed: text представляет собой список объектов слов, состоящих из 4 элементов:

  • 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": "Понятно!" }, ] }