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

Описание технологии

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

URI сервера для загрузки -

https://s3.api.tinkoff.ai

Имя пакета всегда одинаковое -

Inbound

Файлы можно загружать, просматривать их список, но нельзя скачивать.
Загруженные файлы хранятся не более 5 дней.

Авторизация

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

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

• консольные
  • S3cmd
  • AWS CLI s3-api
• UI
  • S3Browser
  • CyberDuck
• SDK
  • Python - Boto3
  • Go - aws-sdk-go, в частности s3

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

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

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

Формат URI

При передаче ссылок на хранилище в методы отложенной обработки ожидается, что URI будет иметь фиксированный формат:

storage://s3.api.tinkoff.ai/inbound/<имя_файла>