Использование Yandex API Gateway для настройки синтеза речи в Yandex SpeechKit

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Создайте сервисный аккаунт speechkit-sa:

   yc iam service-account create speechkit-sa
   

   Результат:

   id: nfersamh4sjq********
   folder_id: b1gc1t4cb638********
   created_at: "2023-09-21T10:36:29.726397755Z"
   name: speechkit-sa
   

   Сохраните идентификатор сервисного аккаунта speechkit-sa (id) и каталога, в котором его создали (folder_id).

   Подробнее о команде yc iam service-account create читайте в справочнике CLI.

2. Назначьте сервисному аккаунту роль ai.speechkit-tts.user на каталог, указав сохраненные ранее идентификаторы каталога и сервисного аккаунта:

   yc resource-manager folder add-access-binding <идентификатор_каталога> \
     --role ai.speechkit-tts.user \
     --subject serviceAccount:<идентификатор_сервисного_аккаунта>
   

   Подробнее о команде yc resource-manager folder add-access-binding читайте в справочнике CLI.

Чтобы создать сервисный аккаунт, воспользуйтесь методом create для ресурса ServiceAccount или вызовом gRPC API ServiceAccountService/Create.

Чтобы назначить сервисному аккаунту роль ai.speechkit-tts.user на каталог, воспользуйтесь методом setAccessBindings для ресурса ServiceAccount или вызовом gRPC API ServiceAccountService/SetAccessBindings.

1. Сохраните следующую спецификацию в файл speechkit-gw.yaml, указав идентификатор сервисного аккаунта speechkit-sa в параметре service_account_id:

   openapi: 3.0.0
   info:
     title: Sample API
     version: 1.0.0
   
   paths:
     /synthesis:
       post:
         requestBody:
           description: "/synthesis"
           content:
             application/json:
               schema:
                 type: object
                 x-yc-schema-mapping:
                   type: static
                   template:
                     text: "${.text}"
                     hints:
                       - voice: "lera"
                       - role: "friendly"
                       - audioTemplate:
                           audio:
                             audioSpec:
                               containerAudio:
                                 containerAudioType: "MP3"
         responses:
           200:
             description: "/synthesis"
             content:
               application/json:
                 schema:
                   type: object
                   x-yc-schema-mapping:
                     type: static
                     template:
                       data: "${.result.audioChunk.data}"
         x-yc-apigateway-integration:
           http_method: post
           type: http
           url: https://tts.api.cloud.yandex.net/tts/v3/utteranceSynthesis
           service_account_id: "<идентификатор_сервисного_аккаунта>"
   

2. Выполните команду:

   yc serverless api-gateway create \
     --name speechkit-api-gw \
     --spec=speechkit-gw.yaml
   

   Где:

   • --name — имя API-шлюза.
   • --spec — путь к файлу со спецификацией.

   Результат:

   done (2s)
   id: d5ddbmungf72********
   folder_id: b1gt6g8ht345********
   created_at: "2024-08-19T18:58:32.101Z"
   name: speechkit-api-gw
   status: ACTIVE
   domain: d5dm1lba80md********.i9******.apigw.yandexcloud.net
   connectivity: {}
   log_options:
     folder_id: b1gt6g8ht345********
   execution_timeout: 300s
   

Сохраните служебный домен созданного API-шлюза (значение поля domain). Он понадобится для проверки работы API-шлюза.

Подробнее о команде yc serverless api-gateway create читайте в справочнике CLI.

Чтобы создать API-шлюз, воспользуйтесь методом REST API create для ресурса ApiGateway или вызовом gRPC API ApiGatewayService/Create.