Transkribieren mit demAWS CLI

Wenn Sie die verwenden,AWS CLI um eine Transkription zu starten, können Sie alle Befehle auf CLI-Ebene ausführen. Oder Sie können den Befehl ausführen, den Sie verwenden möchten, gefolgt von demAWS-Region und dem Speicherort einer JSON-Datei, die einen Anforderungstext enthält. In diesem Handbuch finden Sie Beispiele für beide Methoden. Dieser Abschnitt konzentriert sich jedoch auf die erstere Methode.

Das unterstütztAWS CLI keine Streaming-Transkriptionen.

Bevor Sie fortfahren, stellen Sie sicher, dass Sie:

• Deine Mediendatei wurde in einenAmazon S3 Bucket hochgeladen. Wenn Sie sich nicht sicher sind, wie Sie einenAmazon S3 Bucket erstellen oder Ihre Datei hochladen, finden Sie weitere Informationen unter Erstellen Sie Ihren erstenAmazon S3 Bucket und Laden Sie ein Objekt in Ihren Bucket hoch.

• Installierte die AWS CLI.

Sie finden alleAWS CLI Befehle fürAmazon Transcribe in der AWS CLIBefehlsreferenz.

Einen neuen Transkriptionsjob starten

Verwenden Sie denstart-transcription-job Befehl, um eine neue Transkription zu starten.

1. Geben Sie in einem Terminalfenster den folgenden Befehl ein:

   aws transcribe start-transcription-job \

   In der nächsten Zeile erscheint ein> '', und Sie können nun mit dem Hinzufügen der erforderlichen Parameter fortfahren, wie im nächsten Schritt beschrieben.

   Sie können das '\' auch weglassen und alle Parameter anhängen, indem Sie sie jeweils durch ein Leerzeichen trennen.

2. Mit demstart-transcription-job Befehl müssen Sie,regiontranscription-job-namemedia, und entwederlanguage-code oder einschließenidentify-language.

   Wenn Sie einen Ausgabeort angeben möchten, fügen Sie diesoutput-bucket-name in Ihre Anfrage ein. Wenn Sie einen Unterordner des angegebenen Ausgabe-Buckets angeben möchten, schließen Sie auch einoutput-key.

   aws transcribe start-transcription-job \
    --region us-west-2 \
    --transcription-job-name my-first-transcription-job \
    --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \
    --language-code en-US

   Wenn alle Parameter angehängt werden, sieht diese Anfrage wie folgt aus:

   aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac --language-code en-US

   Wenn Sie sich dafür entscheiden, keinen Ausgabe-Bucket mit anzugebenoutput-bucket-name,Amazon Transcribe platziert Ihre Transkriptionsausgabe in einem vom Service verwalteten Bucket. In einem vom Service verwalteten Bucket gespeicherte Transkripte laufen nach 90 Tagen ab.

   Amazon Transcribeantwortet mit:

   {
       "TranscriptionJob": {
           "TranscriptionJobName": "my-first-transcription-job",
           "TranscriptionJobStatus": "IN_PROGRESS",
           "LanguageCode": "en-US",
           "Media": {
               "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
           },
           "StartTime": "2022-03-07T15:03:44.246000-08:00",
           "CreationTime": "2022-03-07T15:03:44.229000-08:00"
       }
   }

Ihr Transkriptionsauftrag ist erfolgreich, wenn der TranscriptionJobStatusWechsel vonIN_PROGRESS zu erfolgtCOMPLETED. Um die Aktualisierung zu sehen TranscriptionJobStatus, verwenden Sie denlist-transcription-job Befehlget-transcription-job or, wie im folgenden Abschnitt gezeigt.

Abrufen des den Status eines Abtrags

Verwenden Sie denget-transcription-job Befehl, um Informationen über Ihren Transkriptionsjob zu erhalten.

Die einzigen erforderlichen Parameter für diesen Befehl sind derAWS-Region Ort, an dem sich der Job befindet, und der Name des Jobs.

aws transcribe get-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Amazon Transcribeantwortet mit:

{
    "TranscriptionJob": {
        "TranscriptionJobName": "my-first-transcription-job",
        "TranscriptionJobStatus": "COMPLETED",
        "LanguageCode": "en-US",
        "MediaSampleRateHertz": 48000,
        "MediaFormat": "flac",
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
        },
        "Transcript": {
            "TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
        },
        "StartTime": "2022-03-07T15:03:44.246000-08:00",
        "CreationTime": "2022-03-07T15:03:44.229000-08:00",
        "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
        "Settings": {
            "ChannelIdentification": false,
            "ShowAlternatives": false
        }
    }
}

Wenn Sie Ihren eigenenAmazon S3 Bucket für Ihre Transkriptionsausgabe ausgewählt haben, wird dieser Bucket mit aufgeführtTranscriptFileUri. Wenn Sie einen vom Service verwalteten Bucket ausgewählt haben, wird eine temporäre URI bereitgestellt. Verwenden Sie diese URI, um Ihr Transkript herunterzuladen.

Anmerkung

Temporäre URIs für vom Service verwalteteAmazon S3 Buckets sind nur 15 Minuten gültig. Wenn Sie bei der Verwendung der URI eineAccesDenied Fehlermeldung erhalten, führen Sie dieget-transcription-job Anfrage erneut aus, um eine neue temporäre URI zu erhalten.

Deine Transkriptionsjobs auflisten

Verwenden Sie denlist-transcription-jobs Befehl, um alle Ihre Transkriptionsaufträge in einem bestimmtenAWS-Region Verzeichnis aufzulisten.

Der einzige erforderliche Parameter für diesen Befehl ist der,AWS-Region in dem sich Ihre Transkriptionsaufträge befinden.

aws transcribe list-transcription-jobs \
 --region us-west-2

Amazon Transcribeantwortet mit:

{
    "NextToken": "A-very-long-string",
    "TranscriptionJobSummaries": [
        {
            "TranscriptionJobName": "my-first-transcription-job",
            "CreationTime": "2022-03-07T15:03:44.229000-08:00",
            "StartTime": "2022-03-07T15:03:44.246000-08:00",
            "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
            "LanguageCode": "en-US",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        }        
    ]
}

Löschen Ihres Transkriptionsauftrags

Verwenden Sie dendelete-transcription-job Befehl, um Ihren Transkriptionsauftrag zu löschen.

Die einzigen erforderlichen Parameter für diesen Befehl sind derAWS-Region Ort, an dem sich der Job befindet, und der Name des Jobs.

aws transcribe delete-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Um zu bestätigen, dass Ihre Löschanfrage erfolgreich war, können Sie denlist-transcription-jobs Befehl ausführen. Ihr Job sollte nun nicht mehr in der Liste angezeigt werden.