Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # StartMedicalStreamTranscription Lance un HTTP/2 ou un WebSocket flux bidirectionnel où l'audio est diffusé en continu vers Amazon Transcribe Medical et les résultats de la transcription sont diffusés sur votre application. Les paramètres suivants sont obligatoires : + `language-code` + `media-encoding` + `sample-rate` Pour plus d'informations sur le streaming avec Amazon Transcribe Medical, consultez la section [Transcription du streaming audio](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html). ## Syntaxe de la demande ``` POST /medical-stream-transcription HTTP/2 x-amzn-transcribe-language-code: LanguageCode x-amzn-transcribe-sample-rate: MediaSampleRateHertz x-amzn-transcribe-media-encoding: MediaEncoding x-amzn-transcribe-vocabulary-name: VocabularyName x-amzn-transcribe-specialty: Specialty x-amzn-transcribe-type: Type x-amzn-transcribe-show-speaker-label: ShowSpeakerLabel x-amzn-transcribe-session-id: SessionId x-amzn-transcribe-enable-channel-identification: EnableChannelIdentification x-amzn-transcribe-number-of-channels: NumberOfChannels x-amzn-transcribe-content-identification-type: ContentIdentificationType Content-type: application/json { "AudioStream": { "AudioEvent": { "AudioChunk": blob } } } ``` ## Paramètres de demande URI La demande utilise les paramètres URI suivants. ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Étiquette tous les renseignements personnels sur la santé (PHI) identifiés sur votre relevé de notes. L'identification du contenu est effectuée au niveau du segment ; le PHI est signalé lors de la transcription complète d'un segment audio. Pour plus d'informations, voir [Identification des informations personnelles sur la santé (PHI) dans une transcription](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html). Valeurs valides :` PHI` ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Permet l'identification des canaux audio multicanaux. L'identification des canaux transcrit le son sur chaque canal indépendamment, puis ajoute la sortie de chaque canal dans une seule transcription. Si vous utilisez un son multicanal et que vous n'activez pas l'identification des canaux, votre audio est transcrit de manière continue et votre transcription n'est pas séparée par canal. Si vous incluez`EnableChannelIdentification` dans votre demande, vous devez également inclure`NumberOfChannels`. Pour de plus amples informations, veuillez consulter [Transcription de l'audio multicanal](https://docs.aws.amazon.com/transcribe/latest/dg/channel-id.html). ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez le code de langue qui représente la langue parlée dans votre fichier audio. Amazon Transcribe Medical ne prend en charge que l'anglais américain (`en-US`). Valeurs valides :` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH` Obligatoire : oui ** [MediaEncoding](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez l'encodage utilisé pour l'entrée audio. Formats pris en charge : + FLAC + Audio codé OPUS dans un conteneur Ogg + PCM (uniquement formats audio Little-Endian 16 bits signés, qui n'incluent pas le WAV) Pour de plus amples informations, veuillez consulter [Formats de média](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio). Valeurs valides :` pcm | ogg-opus | flac` Obligatoire : oui ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Fréquence d'échantillonnage du signal audio d'entrée (en hertz). Amazon Transcribe Medical prend en charge une plage de 16 000 Hz à 48 000 Hz. Notez que la fréquence d'échantillonnage que vous spécifiez doit correspondre à celle de votre audio. Plage valide : Valeur minimum de 8 000. Valeur maximum de 48 000. Obligatoire : oui ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez le nombre de canaux dans votre flux audio. Cette valeur doit être égale à`2`, car seuls deux canaux sont pris en charge. Si votre audio ne contient pas plusieurs canaux, n'incluez pas ce paramètre dans votre demande. Si vous incluez`NumberOfChannels` dans votre demande, vous devez également inclure`EnableChannelIdentification`. Plage valide : Valeur minimum de 2. ** [SessionId](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez un nom pour votre session de transcription. Si vous n'incluez pas ce paramètre dans votre demande, Amazon Transcribe Medical génère un identifiant et le renvoie dans la réponse. Contraintes de longueur : longueur fixe de 36. Modèle : `[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` ** [ShowSpeakerLabel](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Active le partitionnement des haut-parleurs (diarisation) dans votre sortie de transcription. Le partitionnement des haut-parleurs étiquette le discours émis par chaque locuteur dans votre fichier multimédia. Pour de plus amples informations, veuillez consulter [Partitionnement des enceintes (Diarisation)](https://docs.aws.amazon.com/transcribe/latest/dg/diarization.html). ** [Specialty](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez la spécialité médicale contenue dans votre fichier audio. Valeurs valides :` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY` Obligatoire : oui ** [Type](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez le type d'entrée audio. Par exemple, optez`DICTATION` pour un professionnel de la santé qui dicte les notes du patient et`CONVERSATION` pour un dialogue entre un patient et un professionnel de la santé. Valeurs valides :` CONVERSATION | DICTATION` Obligatoire : oui ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Spécifiez le nom du vocabulaire personnalisé que vous souhaitez utiliser lors du traitement de votre transcription. Notez que les noms de vocabulaire sont sensibles à la casse. Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200. Modèle : `^[0-9a-zA-Z._-]+` ## Corps de la demande Cette demande accepte les données suivantes au format JSON. ** [AudioStream](#API_streaming_StartMedicalStreamTranscription_RequestSyntax) ** Un flux codé de blobs audio. Les flux audio sont codés sous forme de HTTP/2 ou de trames de WebSocket données. Pour de plus amples informations, veuillez consulter [Transcription de l'audio en continu](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html). Type : objet [AudioStream](API_streaming_AudioStream.md) Obligatoire : oui ## Syntaxe de la réponse ``` HTTP/2 200 x-amzn-request-id: RequestId x-amzn-transcribe-language-code: LanguageCode x-amzn-transcribe-sample-rate: MediaSampleRateHertz x-amzn-transcribe-media-encoding: MediaEncoding x-amzn-transcribe-vocabulary-name: VocabularyName x-amzn-transcribe-specialty: Specialty x-amzn-transcribe-type: Type x-amzn-transcribe-show-speaker-label: ShowSpeakerLabel x-amzn-transcribe-session-id: SessionId x-amzn-transcribe-enable-channel-identification: EnableChannelIdentification x-amzn-transcribe-number-of-channels: NumberOfChannels x-amzn-transcribe-content-identification-type: ContentIdentificationType Content-type: application/json { "TranscriptResultStream": { "BadRequestException": { }, "ConflictException": { }, "InternalFailureException": { }, "LimitExceededException": { }, "ServiceUnavailableException": { }, "TranscriptEvent": { "Transcript": { "Results": [ { "Alternatives": [ { "Entities": [ { "Category": "string", "Confidence": number, "Content": "string", "EndTime": number, "StartTime": number } ], "Items": [ { "Confidence": number, "Content": "string", "EndTime": number, "Speaker": "string", "StartTime": number, "Type": "string" } ], "Transcript": "string" } ], "ChannelId": "string", "EndTime": number, "IsPartial": boolean, "ResultId": "string", "StartTime": number } ] } } } } ``` ## Eléments de réponse Si l'action aboutit, le service renvoie une réponse HTTP 200. La réponse renvoie les en-têtes HTTP suivants. ** [ContentIdentificationType](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Indique si l'identification du contenu a été activée pour votre transcription. Valeurs valides :` PHI` ** [EnableChannelIdentification](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Indique si l'identification des chaînes a été activée pour votre transcription. ** [LanguageCode](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit le code de langue que vous avez spécifié dans votre demande. Il doit être `en-US`. Valeurs valides :` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH` ** [MediaEncoding](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit le codage multimédia que vous avez spécifié dans votre demande. Valeurs valides :` pcm | ogg-opus | flac` ** [MediaSampleRateHertz](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit la fréquence d'échantillonnage que vous avez spécifiée dans votre demande. Plage valide : Valeur minimum de 8 000. Valeur maximum de 48 000. ** [NumberOfChannels](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit le nombre de chaînes que vous avez indiqué dans votre demande. Plage valide : Valeur minimum de 2. ** [RequestId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit l'identifiant de votre demande de streaming. ** [SessionId](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit l'identifiant de votre session de transcription. Contraintes de longueur : longueur fixe de 36. Modèle : `[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` ** [ShowSpeakerLabel](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Indique si le partitionnement des haut-parleurs a été activé pour votre transcription. ** [Specialty](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit la spécialité médicale que vous avez spécifiée dans votre demande. Valeurs valides :` PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY` ** [Type](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit le type de son que vous avez spécifié dans votre demande. Valeurs valides :` CONVERSATION | DICTATION` ** [VocabularyName](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit le nom du vocabulaire personnalisé que vous avez spécifié dans votre demande. Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200. Modèle : `^[0-9a-zA-Z._-]+` Les données suivantes sont renvoyées au format JSON par le service. ** [TranscriptResultStream](#API_streaming_StartMedicalStreamTranscription_ResponseSyntax) ** Fournit des informations détaillées sur votre session de streaming. Type : objet [MedicalTranscriptResultStream](API_streaming_MedicalTranscriptResultStream.md) ## Erreurs Pour plus d'informations sur les erreurs communes à toutes les actions, reportez-vous à la section[Erreurs courantes](CommonErrors.md). ** BadRequestException ** Un ou plusieurs arguments en faveur de l'`StartCallAnalyticsStreamTranscription`opération`StartStreamTranscription``StartMedicalStreamTranscription`, ou n'étaient pas valides. Par exemple,`MediaEncoding` ou vous avez`LanguageCode` utilisé des valeurs non prises en charge. Vérifiez les paramètres spécifiés et réessayez votre demande. Code d'état HTTP : 400 ** ConflictException ** Un nouveau flux a commencé avec le même identifiant de session. Le flux actuel a été interrompu. Code d'état HTTP : 409 ** InternalFailureException ** Un problème est survenu lors du traitement de l'audio. Amazon Transcribe a mis fin au traitement. Code d'état HTTP : 500 ** LimitExceededException ** Votre client a dépassé l'une des limites d'Amazon Transcribe. Il s'agit généralement de la limite de longueur audio. Divisez votre flux audio en petits morceaux et réessayez votre demande. Code d'état HTTP : 429 ** ServiceUnavailableException ** Le service est actuellement indisponible. Réessayez votre demande plus tard. HTTP Status Code: 503 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes : + [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription) + [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-streaming-2017-10-26/StartMedicalStreamTranscription)