Transcribir conAWS CLI - Amazon Transcribe
Comenzar un nuevo trabajo de transcripciónObtención del estado de un trabajo de transcripciónListar tus trabajos de transcripciónEliminar tu trabajo de transcripción

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Transcribir conAWS CLI

Al utilizar elAWS CLI para iniciar una transcripción, puede ejecutar todos los comandos en el nivel de la CLI. O bien, puede ejecutar el comando que desee utilizar, seguido del archivo JSONRegión de AWS y la ubicación de un archivo JSON que contiene el cuerpo de una solicitud. Los ejemplos de esta guía muestran ambos métodos; sin embargo, esta sección se centra en el método anterior.

NoAWS CLI admite transcripciones en streaming.

Antes de continuar, asegúrate de haber hecho lo siguiente:

Encontrará todos losAWS CLI comandosAmazon Transcribe en la Referencia deAWS CLI comandos.

Comenzar un nuevo trabajo de transcripción

Para iniciar una nueva transcripción, utilice elstart-transcription-job comando.

  1. En una ventana de terminal, escriba lo siguiente:

    aws transcribe start-transcription-job \

    Aparece una> '' en la siguiente línea y ahora puede continuar añadiendo los parámetros necesarios, tal y como se describe en el paso siguiente.

    También puede omitir el '\' y añadir todos los parámetros, separándolos con un espacio.

  2. Con elstart-transcription-job comando, debe incluirregiontranscription-job-name,media, ylanguage-code oidentify-language.

    Si desea especificar una ubicación de salida,output-bucket-name inclúyala en su solicitud; si desea especificar una subcarpeta del depósito de salida especificado, inclúyala tambiénoutput-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

    Si se añaden todos los parámetros, esta solicitud tiene el siguiente aspecto:

    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

    Si decide no especificar un depósito de salida medianteoutput-bucket-name,Amazon Transcribe coloca el resultado de la transcripción en un depósito administrado por el servicio. Las transcripciones almacenadas en un bucket administrado por el servicio caducan a los 90 días.

    Amazon Transcriberesponde con:

    {
    "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"
    }
}

Su trabajo de transcripción es exitoso si TranscriptionJobStatuscambia deIN_PROGRESS aCOMPLETED. Para ver la actualización TranscriptionJobStatus, utilice ellist-transcription-job comandoget-transcription-job or, como se muestra en la siguiente sección.

Obtención del estado de un trabajo de transcripción

Para obtener información sobre su trabajo de transcripción, utilice elget-transcription-job comando.

Los únicos parámetros necesarios para este comando son elRegión de AWS lugar donde se encuentra el trabajo y el nombre del trabajo.

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

Amazon Transcriberesponde con:

{
    "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
        }
    }
}

Si ha seleccionado su propioAmazon S3 depósito para el resultado de la transcripción, este depósito aparece en la lista conTranscriptFileUri. Si ha seleccionado un bucket administrado por el servicio, se proporciona un URI temporal; utilice este URI para descargar su transcripción.

nota

Los URI temporales de losAmazon S3 buckets gestionados por el servicio solo son válidos durante 15 minutos. SiAccesDenied aparece un error al utilizar el URI, ejecuta laget-transcription-job solicitud de nuevo para obtener un nuevo URI temporal.

Listar tus trabajos de transcripción

Para enumerar todos sus trabajos de transcripción en un determinadoRegión de AWS momento, utilice ellist-transcription-jobs comando.

El único parámetro obligatorio para este comando es el lugarRegión de AWS en el que se encuentran los trabajos de transcripción.

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

Amazon Transcriberesponde con:

{
    "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"
        }        
    ]
}

Eliminar tu trabajo de transcripción

Para eliminar tu trabajo de transcripción, usa eldelete-transcription-job comando.

Los únicos parámetros necesarios para este comando son elRegión de AWS lugar donde se encuentra el trabajo y el nombre del trabajo.

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

Para confirmar que la solicitud de eliminación se ha realizado correctamente, puede ejecutar ellist-transcription-jobs comando. Su trabajo debería aparecer en la lista.