# Amazon Pollyの使い方をAPI Gateway経由で公開する構成

## 目次

1. 1-1 はじめに
2. 1-2 概要
3. 2-1 構成の概要
4. 2-2 必要なAWSサービス
5. 3-1 前提条件
6. 4-1 ステップ1: IAMポリシーとロールの設定
7. 4-2 ステップ2: Amazon Pollyのセットアップ
8. 4-3 ステップ3: Lambda関数の作成
9. 4-4 ステップ4: API Gatewayの設定
10. 4-5 ステップ5: テストと確認
11. 5-1 まとめ

## 1-1 はじめに

音声合成サービスとして人気を集めるAmazon Pollyは、テキストをリアルな音声に変換することができます。本記事では、Amazon PollyをAPI Gatewayを通じて公開する方法について説明します。これにより、外部のアプリケーションから音声のリクエストを行うことが可能になります。

## 1-2 概要

この記事の目的は、Amazon PollyをAWS API Gateway経由でWeb APIとして公開し、外部のクライアントが容易に利用できるようにすることです。これにより、音声合成機能をアプリケーションに統合する際の柔軟性が増し、音声合成機能の利用が非常に簡単になります。

## 2-1 構成の概要

このセットアップは、いくつかのAWSサービスを組み合わせて実現します。具体的には下記のサービスを組み合わせて、Amazon PollyへのリクエストをHTTPリクエストとして処理できるようにします。

## 2-2 必要なAWSサービス

- **Amazon Polly:** テキストを音声に変換するテキスト読み上げサービス。
- **AWS Lambda:** AWS API Gatewayのトリガーとして用いる無サーバーの計算サービス。
- **Amazon API Gateway:** RESTful APIを作成、管理するためのサービスで、HTTPリクエストを受け付ける。

## 3-1 前提条件

- AWSアカウントを持っていること。
- 基本的なAWSのサービス（IAM, Lambda, API Gateway）の知識があること。
- AWS CLIがインストールされており、初期設定が済んでいること。

## 4-1 ステップ1: IAMポリシーとロールの設定

### 4-1-1 IAMポリシーの作成

Amazon PollyにアクセスするためのIAMポリシーを作成します。このポリシーをLambda関数が利用します。

```json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "polly:SynthesizeSpeech",
            "Resource": "*"
        }
    ]
}
```

### 4-1-2 IAMロールの作成

上記で作成したポリシーをLambda用IAMロールにアタッチします。

## 4-2 ステップ2: Amazon Pollyのセットアップ

Amazon Pollyの設定は特に不要で、IAMロールで権限が設定されていれば、そのまま利用可能です。

## 4-3 ステップ3: Lambda関数の作成

AWSコンソールから新しいLambda関数を作成します。以下のPythonコードを使用します。

```python
import boto3
from base64 import b64encode

def lambda_handler(event, context):
    client = boto3.client('polly')
    
    response = client.synthesize_speech(
        Text=event['queryStringParameters']['text'],
        OutputFormat='mp3',
        VoiceId='Joanna'
    )
    
    audio_stream = response['AudioStream'].read()
    encoded_audio = b64encode(audio_stream).decode('utf-8')
    
    return {
        'statusCode': 200,
        'headers': {
            'Content-Type': 'audio/mp3',
            'Content-Transfer-Encoding': 'base64'
        },
        'body': encoded_audio,
        'isBase64Encoded': True
    }
```

AWS Lambda関数は、対象のテキストを受け取り、Amazon Pollyにリクエストを送り、生成された音声データを返します。

## 4-4 ステップ4: API Gatewayの設定

1. **API Gatewayの作成:** 新しいREST APIを作成します。
2. **リソースとメソッドの追加:** `/synthesize` リソースを作成し、`GET` メソッドを追加します。
3. **Lambda関数の統合:** `GET /synthesize` メソッドに先ほど作成したLambda関数を統合します。
4. **CORSの設定:** クロスオリジンリソース共有(CORS)を設定し、ブラウザからのアクセスを許可します。
5. **デプロイ:** ステージにAPIをデプロイします。

## 4-5 ステップ5: テストと確認

API Gatewayのエンドポイントを使用して、ブラウザ、curl、またはAPIクライアント（如Postman）からテストを行います。

```bash
curl -X GET "https://your-api-endpoint/synthesize?text=Hello%20world"
```

例では、音声データがbase64でエンコードされて返ってくるため、適切なクライアントで音声として再生します。

## 5-1 まとめ

この記事では、Amazon PollyをAWS API GatewayとLambdaを使用して公開する方法を説明しました。この構成により、幅広いアプリケーションで手軽にテキスト読み上げ機能を利用できるようになります。ぜひ、あなたのプロジェクトに音声合成を組み込んでみてください。 [cv:issue_marketplace_engineer]

Amazon Pollyの使い方をAPI Gateway経由で公開する構成

目次

続きを読むには単価診断を受けてください（30秒）