翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK ライブ文字起こしの開始と停止
<a name="initiate-transcription"></a>

Amazon Chime SDK の [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html) API を使用して、`TranscriptionConfiguration` を会議に適用することで会議の文字起こしを開始します。Amazon Chime SDK コントローラは、設定を会議に非同期的に転送します。会議の文字起こしの成否は、Amazon Simple Service (Amazon SNS) と Amazon EventBridge を介したメッセージによって通知されます。

**文字起こしを開始する**  
この例は、Amazon Transcribe でライブ文字起こしを開始する方法を示しています。

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{
    "TranscriptionConfiguration": {
        "EngineTranscribeSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "en-US",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "tag",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "profanity",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "lingo",
            "Region": "us-east-1"
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": true,  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "high",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "ALL",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "language-model"
        }
    }
}
```

この例は、Amazon Transcribe Medical でライブ文字起こしを開始する方法を示しています。

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{  
    "TranscriptionConfiguration": {
        "EngineTranscribeMedicalSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "en-US",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PRIMARYCARE",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "CONVERSATION",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "lingo",
            "Region": "us-east-1",
           "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PHI", 
        }
   }
}
```

`StartMeetingTranscription` – 会議の文字起こしを開始します。  
`meetingId` – [CreateMeeting API](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax) によって返される会議の ID。  
`TranscriptionConfiguration` – ライブ文字起こしのパラメータをカプセル化します。設定は 1 つだけ (`EngineTranscribeSettings` または `EngineTranscribeMedicalSettings`) 指定する必要があります。

`EngineTranscribeSettings` – Amazon Transcribe の使用を指定し、その設定を [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters) に渡します。  
`LanguageCode` – 必須。  
`VocabularyFilterMethod` - オプション。  
`VocabularyFilterName` - オプション。  
`VocabularyName` - オプション。  
`Region` - オプション。  
`EnablePartialResultsStabilization` - オプション。  
`PartialResultsStability` - オプション。  
` ContentIdentificationType` - オプション。  
`ContentRedactionType` - オプション。  
`PiiEntityTypes ` - オプション。  
`LanguageModelName` - オプション。

`EngineTranscribeMedicalSettings` – Amazon Transcribe Medical の使用を指定し、その設定を [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters) に渡します。  
`LanguageCode` – 必須。  
`Speciality` – 必須。  
`Type` – 必須。  
`VocabularyName` - オプション。  
`Region` - オプション。  
` ContentIdentificationType` - オプション。

**レスポンス**  
Amazon Transcribe と Amazon Transcribe Medical は、以下のレスポンスを返します。
+ 会議に `TranscriptionConfiguration` が正常に適用された場合、`OK` (200) と空の本文。

**エラーメッセージ**  
Amazon Transcribe と Amazon Transcribe Medical は、以下のエラーメッセージを表示します。
+ **BadRequestException (400):** 入力パラメータがサービスの制限と一致しません。
+ **ForbiddenException (403):** このクライアントはリクエストの実行を永続的に禁止されています。
+ **NotFoundException (404):** `meetingId` は存在しません。
+ **ResourceLimitExceededException (400):** リクエストがリソースの制限を超えています。例えば、ライブ文字起こしが有効になっている会議が多すぎます。
+ **ServiceFailureException (500):** サービス中に予期しないエラーが発生しました。
+ **ServiceUnavailableException (503):** 現在、このサービスは利用できません。
+ **ThrottledClientException (429):** クライアントがリクエストレートの制限を超えました。
+ **UnauthorizedClientException (401):** クライアントは現在、リクエストを行う権限がありません。

`StartMeetingTranscription` の 2 回目の呼び出しにより、会議に適用されている `TranscriptionConfiguration` が更新されます。

**文字起こしの停止**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html) API を使用して、特定の `meetingID` の `TranscriptionConfiguration` を削除して、会議の文字起こしを終了します。会議を終了すると、文字起こしは自動的に停止します。

この例は、`StopMeetingTranscription` を呼び出すリクエスト構文を示しています。

```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```

**レスポンス**  
Amazon Transcribe と Amazon Transcribe Medical は、以下のレスポンスを返します。
+ 会議から `TranscriptionConfiguration` が正常に削除された場合、`OK` (200) と空の本文。

**エラーメッセージ**  
Amazon Transcribe と Amazon Transcribe Medical は、以下のエラーメッセージを表示します。
+ **BadRequestException (400):** 入力パラメータがサービスの制限と一致しません。
+ **ForbiddenException (403):** このクライアントはリクエストの実行を永続的に禁止されています。
+ **NotFoundException (404):** `meetingId` は存在しません。
+ **ServiceFailureException (500):** サービス中に予期しないエラーが発生しました。
+ **ServiceUnavailableException (503):** 現在、このサービスは利用できません。
+ **ThrottledClientException (429):** クライアントがリクエストレートの制限を超えました。
+ **UnauthorizedClientException (401):** クライアントは現在、リクエストを行う権限がありません。