transcribe_url
Расшифровать запись по ссылке
Переводит аудио или видео по ссылке в текст с таймкодами. Передайте diarize=true, если нужно разделение по спикерам. Понимает публичные записи YouTube, VK Видео, Rutube, Дзен, OK, Castbox и SoundCloud. Возвращает job_id сразу: результат забирается инструментом get_transcript. Списывает минуты с баланса по факту длительности записи.
輸入參數url必填diarizelanguage
create_upload
Получить ссылку для загрузки файла
Путь для локального файла, у которого нет публичной ссылки. Передайте file_name и точный size_bytes. Возвращает upload_url, s3_key и обязательный content_type. Загрузите файл запросом PUT, передав Content-Type и Content-Length в точности из ответа (например, curl -X PUT -H 'Content-Type: application/octet-stream' -H 'Content-Length: 1048576' --data-binary @file.ogg <upload_url>), после чего передайте s3_key и file_name в transcribe_file. Ссылка живёт 30 минут; один файл может занимать не более 256 МБ.
輸入參數file_name必填size_bytes必填content_type
transcribe_file
Расшифровать загруженный файл
Переводит в текст файл, загруженный по ссылке из create_upload. Возвращает job_id сразу: результат забирается инструментом get_transcript. Списывает минуты с баланса по факту длительности записи.
輸入參數s3_key必填diarizelanguagefile_name必填
get_transcript
Забрать расшифровку
Возвращает состояние задачи по job_id, а когда она готова — текст с таймкодами и метками спикеров, если при запуске было передано diarize=true. Пока идёт расшифровка, отвечает status=processing: вызывайте повторно с паузой в несколько секунд. Время зависит от длины записи, очереди и запуска обработчика.
輸入參數formatjob_id必填
list_transcripts
Список последних расшифровок
Перечисляет последние расшифровки учётной записи: id, имя файла, длительность и состояние. Полезно, чтобы найти job_id вчерашней записи, не спрашивая человека.
輸入參數limit
search_transcripts
Поиск по расшифровкам
Ищет фразу по текстам последних 200 готовых расшифровок и возвращает совпадения с таймкодом и именем спикера. Так можно найти, где именно на трёхчасовом созвоне обсуждали сроки, не перечитывая всё.
輸入參數limitquery必填
Показывает, сколько минут расшифровки осталось на балансе. Стоит спросить перед пачкой длинных записей, чтобы не упереться в нехватку на середине.
無需輸入參數。