VocalStack Logo

Documentation

Получить данные транскрипции

Транскрипция с микрофона или LiveStream

Переписать речь в прямом эфире с микрофона или поток

Сеансы транскрипции

Мониторинг и управление состоянием транскрипции с помощью сеансов

Перевести транскрипцию

Перевод транскрибированного текста на другой язык

Транскрипция аудио из URL

Транскрипция речи из заранее записанного аудио в URL в обычный текст

Токены проверки подлинности на стороне клиента

Создать временный токен проверки подлинности для запросов со стороны клиента

Запрос и ответ на транскрипцию

Общие параметры запроса и ответы для всех операций транскрипции

Транскрипция и презентация сеанса полиглота

Создать сеанс, который может быть использован для трансляции транскрипции в реальном времени через публичную ссылку для совместного использования

Получить данные транскрипции

Просмотр документации
Получить данные из ожидающих или завершенных транскрипций. Это включает в себя хронологию транскрипции, ключевые слова, резюме и сегменты абзацев.
Вы можете использовать API VocalStack для получения данных транскрипции после начала транскрипции аудио с помощью любого из следующих методов:
Транскрипция аудио из URL
Транскрипция речи из заранее записанного аудио в URL в обычный текст. Поддерживаются основные форматы файлов, включая MP3, WAV, FLAC и OGG.
Транскрипция с микрофона или LiveStream
Переписать речь в прямом эфире с микрофона или поток. Интегрируйте с Polyglot для создания публичной ссылки для транскрипции, которую пользователи могут читать на любом языке.
Транскрипция и презентация сеанса полиглота
Создать сеанс, который может быть использован для трансляции транскрипции в реальном времени через публичную ссылку для совместного использования. Пользователи могут читать транскрипции в реальном времени на выбранном ими языке, а также транскрипции прошлых сессий, когда вы неактивны.

Получение всех транскриптов

Получение всех транскрипций осуществляется с помощью Transcriptions из VocalStack SDK:
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcriptions = await sdk.getAllTranscriptions();

transcriptions.data?.forEach((transcription) => {
  // the transcription ID (use this to get more details about the transcription)
  console.log(transcription.id);
  
  // 'waiting', 'processing', 'done', or 'error'
  console.log(transcription.status);

  // the time the transcription started
  console.log(transcription.start);

  // the time the transcription finalized
  console.log(transcription.end); 

  // the keywords associated with the transcription
  console.log(transcription.keywords);
  
  // the length of the transcription in seconds
  console.log(transcription.duration);
});

Получение одной транскрипции

Чтобы получить все данные, доступные для транскрипции, мы должны использовать id этой транскрипции. id возвращается каждый раз, когда впервые инициируется процесс транскрипции. Однако, его также можно получить, посмотрев на все транскрипции с помощью API выше.
Для получения конкретной транскрипции используйте Transcriptions из VocalStack SDK:
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcription = await sdk.getTranscription({ id: 'TRANSCRIPTION-ID' });
const data = transcription.data;

if (data) {
  // the transcription ID (use this to get more details about the transcription)
  console.log(data.id);

  // 'waiting', 'processing', 'done', or 'error'
  console.log(data.status);

  // the time the transcription started
  console.log(data.start);

  // the time the transcription finalized
  console.log(data.end);

  // the keywords associated with the transcription
  console.log(data.keywords);

  // the length of the transcription in seconds
  console.log(data.duration);

  // an object with the transcription timeline
  console.log(data.timeline);

  // a summary of the transcription
  console.log(data.summary);

  // the entire transcription in paragraph form
  console.log(data.paragraphs);
}

Ожидаемые стенограммы

В большинстве случаев вы будете заинтересованы в получении данных для одной транскрипции только после того, как эта транскрипция закончится обработкой. Это потому, что транскрипция является асинхронной операцией, и ее ход может отслеживаться асинхронно, где бы вы ни выполняли этот процесс транскрипции. Однако, если вы запросите данные транскрипции для транскрипции, которая все еще находится в процессе обработки, вы все равно получите все доступные данные для этой транскрипции, включая самые последние timeline.

Завершенные стенограммы

После завершения транскрипции она проходит последующую обработку, и в этом случае данные транскрипции будут также содержать значения для keywords, summary и paragraphs.

Следующие шаги

Просмотр объекта ответа, возвращаемого с каждой транскрипцией:
Запрос и ответ на транскрипцию
Общие параметры запроса и ответы для всех операций транскрипции. Используйте параметры для настройки параметров транскрипции.
Scroll Up