StartMedicalStreamTranscription - Transcribe
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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.

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

É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.

Valeurs valides : PHI

EnableChannelIdentification

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 incluezEnableChannelIdentification dans votre demande, vous devez également inclureNumberOfChannels.

Pour de plus amples informations, veuillez consulter Transcription de l'audio multicanal.

LanguageCode

Spécifiez le code de langue qui représente la langue parlée dans votre fichier audio.

Important

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

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.

Valeurs valides : pcm | ogg-opus | flac

Obligatoire : oui

MediaSampleRateHertz

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

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 incluezNumberOfChannels dans votre demande, vous devez également inclureEnableChannelIdentification.

Plage valide : Valeur minimum de 2.

SessionId

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

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).

Specialty

Spécifiez la spécialité médicale contenue dans votre fichier audio.

Valeurs valides : PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY

Obligatoire : oui

Type

Spécifiez le type d'entrée audio. Par exemple, optezDICTATION pour un professionnel de la santé qui dicte les notes du patient etCONVERSATION pour un dialogue entre un patient et un professionnel de la santé.

Valeurs valides : CONVERSATION | DICTATION

Obligatoire : oui

VocabularyName

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

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.

Type : objet AudioStream

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

Indique si l'identification du contenu a été activée pour votre transcription.

Valeurs valides : PHI

EnableChannelIdentification

Indique si l'identification des chaînes a été activée pour votre transcription.

LanguageCode

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

Fournit le codage multimédia que vous avez spécifié dans votre demande.

Valeurs valides : pcm | ogg-opus | flac

MediaSampleRateHertz

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

Fournit le nombre de chaînes que vous avez indiqué dans votre demande.

Plage valide : Valeur minimum de 2.

RequestId

Fournit l'identifiant de votre demande de streaming.

SessionId

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

Indique si le partitionnement des haut-parleurs a été activé pour votre transcription.

Specialty

Fournit la spécialité médicale que vous avez spécifiée dans votre demande.

Valeurs valides : PRIMARYCARE | CARDIOLOGY | NEUROLOGY | ONCOLOGY | RADIOLOGY | UROLOGY

Type

Fournit le type de son que vous avez spécifié dans votre demande.

Valeurs valides : CONVERSATION | DICTATION

VocabularyName

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

Fournit des informations détaillées sur votre session de streaming.

Type : objet MedicalTranscriptResultStream

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, reportez-vous à la sectionErreurs courantes.

BadRequestException

Un ou plusieurs arguments en faveur de l'StartCallAnalyticsStreamTranscriptionopérationStartStreamTranscriptionStartMedicalStreamTranscription, ou n'étaient pas valides. Par exemple,MediaEncoding ou vous avezLanguageCode 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 :