As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateVocabulary Cria um novo vocabulário personalizado. Ao criar um novo vocabulário personalizado, você pode carregar um arquivo de texto que contenha suas novas entradas, frases e termos em um bucket do Amazon S3 e incluir o URI em sua solicitação. Ou você pode incluir uma lista de termos diretamente em sua solicitação usando a`Phrases` bandeira. Cada idioma tem um conjunto de caracteres que contém todos os caracteres permitidos para esse idioma específico. Se você usar caracteres não suportados, sua solicitação de vocabulário personalizado falhará. Consulte [Conjuntos de caracteres para vocabulários personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) para obter o conjunto de caracteres para seu idioma. Para obter mais informações, consulte [Vocabulários personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html). ## Sintaxe da solicitação ``` { "LanguageCode": "string", "Phrases": [ "string" ], "Tags": [ { "Key": "string", "Value": "string" } ], "VocabularyFileUri": "string", "VocabularyName": "string" } ``` ## Parâmetros de solicitação Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [LanguageCode](#API_CreateVocabulary_RequestSyntax) ** O código do idioma que representa o idioma das entradas em seu vocabulário personalizado. Cada vocabulário personalizado deve conter termos em apenas um idioma. Um vocabulário personalizado só pode ser usado para transcrever arquivos no mesmo idioma do vocabulário personalizado. Por exemplo, se você criar um vocabulário personalizado usando inglês americano (`en-US`), só poderá aplicar esse vocabulário personalizado a arquivos que contenham áudio em inglês. Para obter uma lista dos idiomas suportados e seus códigos de idioma associados, consulte a tabela de [idiomas suportados](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Tipo: String Valores válidos:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` Obrigatório: Sim ** [Phrases](#API_CreateVocabulary_RequestSyntax) ** Use esse parâmetro se quiser criar seu vocabulário personalizado incluindo todos os termos desejados, como valores separados por vírgula, em sua solicitação. A outra opção para criar seu vocabulário personalizado é salvar suas entradas em um arquivo de texto e enviá-las para um bucket do Amazon S3 e, em seguida, especificar a localização do seu arquivo usando o`VocabularyFileUri` parâmetro. Observe que, se você incluir`Phrases` em sua solicitação, não poderá usar`VocabularyFileUri`; você deve escolher um ou outro. Cada idioma tem um conjunto de caracteres que contém todos os caracteres permitidos para esse idioma específico. Se você usar caracteres não suportados, sua solicitação de filtro de vocabulário personalizado falhará. Consulte [Conjuntos de caracteres para vocabulários personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/charsets.html) para obter o conjunto de caracteres para seu idioma. Tipo: matriz de strings Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 256. Padrão: `.+` Obrigatório: não ** [Tags](#API_CreateVocabulary_RequestSyntax) ** Adiciona uma ou mais tags personalizadas, cada uma na forma de um par chave:valor, a um novo vocabulário personalizado no momento em que você cria esse novo vocabulário personalizado. Para saber mais sobre como usar tags com o Amazon Transcribe, consulte [Recursos de tags](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html). Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 1 item. Número máximo de 200 itens. Obrigatório: não ** [VocabularyFileUri](#API_CreateVocabulary_RequestSyntax) ** O local do Amazon S3 do arquivo de texto que contém seu vocabulário personalizado. O URI deve estar localizado naRegião da AWS mesma que o recurso que você está chamando. Veja um exemplo de caminho de URI:`s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt` Observe que, se você incluir`VocabularyFileUri` em sua solicitação, não poderá usar o`Phrases` sinalizador; deverá escolher um ou outro. Tipo: String Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2000. Padrão: `(s3://|http(s*)://).+` Obrigatório: não ** [VocabularyName](#API_CreateVocabulary_RequestSyntax) ** Um nome exclusivo, escolhido por você, para seu novo vocabulário personalizado. Esse nome diferencia maiúsculas de minúsculas, não pode conter espaços e deve ser exclusivo em umConta da AWS. Se você tentar criar um novo vocabulário personalizado com o mesmo nome de um vocabulário personalizado existente, você receberá um`ConflictException` erro. Tipo: String Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200. Padrão: `^[0-9a-zA-Z._-]+` Obrigatório: Sim ## Sintaxe da resposta ``` { "FailureReason": "string", "LanguageCode": "string", "LastModifiedTime": number, "VocabularyName": "string", "VocabularyState": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200. Os seguintes dados são retornados no formato JSON pelo serviço. ** [FailureReason](#API_CreateVocabulary_ResponseSyntax) ** Em caso`VocabularyState``FAILED` afirmativo,`FailureReason` contém informações sobre por que a solicitação de vocabulário personalizado falhou. Veja também: [Erros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html). Tipo: String ** [LanguageCode](#API_CreateVocabulary_ResponseSyntax) ** O código do idioma que você selecionou para seu vocabulário personalizado. Tipo: String Valores válidos:` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE` ** [LastModifiedTime](#API_CreateVocabulary_ResponseSyntax) ** A data e a hora em que você criou seu vocabulário personalizado. Os carimbos de data e hora estão no formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por exemplo,`2022-05-04T12:32:58.761000-07:00` representa 12h32 UTC-7 em 4 de maio de 2022. Type: timestamp ** [VocabularyName](#API_CreateVocabulary_ResponseSyntax) ** O nome que você escolheu para seu vocabulário personalizado. Tipo: String Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200. Padrão: `^[0-9a-zA-Z._-]+` ** [VocabularyState](#API_CreateVocabulary_ResponseSyntax) ** O estado de processamento do seu vocabulário personalizado. Se o estado for`READY`, você pode usar o vocabulário personalizado em uma`StartTranscriptionJob` solicitação. Tipo: String Valores válidos:` PENDING | READY | FAILED` ## Erros Para obter informações sobre os erros comuns a todas as ações, consulte[Erros comuns](CommonErrors.md). ** BadRequestException ** Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou se está em um estado não terminal (como`IN PROGRESS`). Consulte o campo da mensagem de exceção para obter mais informações. Código de status HTTP: 400 ** ConflictException ** Já existe um recurso com esse nome. Os nomes dos recursos devem ser exclusivos em umConta da AWS. Código de status HTTP: 400 ** InternalFailureException ** Ocorreu um erro interno. Verifique a mensagem de erro, corrija o problema e tente fazer sua solicitação novamente. Código de status HTTP: 500 ** LimitExceededException ** Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Espere antes de repetir sua solicitação ou use um arquivo menor e tente novamente. Código de status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateVocabulary) + [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateVocabulary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateVocabulary)