Загрузка файлов для отложенной обработки

Описание

Задачи отложенной обработки (LongRunningRecognize) могут принимать контент не только в виде части gRPC-сообщения, но и в виде загруженных файлов через REST API, который поддерживает некоторые методы Amazon S3.

Это позволяет отправлять в отложенную обработку файлы, размер которых превышает ограничения на размер gRPC-сообщения, а также загружать такие файлы по частям.

• URI сервера для загрузки — https://s3.api.tinkoff.ai.
• Имя пакета всегда одинаковое — Inbound.
• Файлы можно загружать, просматривать их список, но нельзя скачивать.
• Загруженные файлы хранятся не больше 5 дней.

Авторизация

В качестве ключа авторизации и секрета используются те же значения, что и для авторизации в сервисах распознавания или синтеза речи.

Поддерживается только авторизация AWS Signature V4.

Популярные клиенты для работы с API

• S3cmd
• AWS CLI s3-api

Поддерживаемые методы

Из всего разнообразия методов работы S3 API поддерживаются только методы, которые нужны для загрузки файлов и проверки успеха.

• GetBucketLocation
• GetBucketVersioning
• HeadObject
• ListObjects
• PutObject
• Multipart:
  • CreateMultipartUpload
  • UploadPart
  • CompleteMultipartUpload
  • AbortMultipartUpload

Формат URI

В методах отложенной обработки ссылки на хранилище передаются в URI фиксированного формата — storage://s3.api.tinkoff.ai/inbound/<имя_файла>.