Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateVocabulary
Crea un vocabolario personalizzato.
Quando crei un nuovo vocabolario personalizzato, puoi caricare un file di testo contenente le nuove voci, frasi e termini in un bucket Amazon S3 e includere l'URI nella richiesta. Oppure puoi includere un elenco di termini direttamente nella tua richiesta utilizzando ilPhrases
contrassegno.
Ogni lingua ha un set di caratteri che contiene tutti i caratteri consentiti per quella lingua specifica. Se usi caratteri non supportati, la tua richiesta di vocabolario personalizzato fallisce. Consulta Set di caratteri per vocabolari personalizzati per ottenere il set di caratteri per la tua lingua.
Per ulteriori informazioni, consulta Vocabolari personalizzati.
Sintassi della richiesta
{
"LanguageCode": "string
",
"Phrases": [ "string
" ],
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"VocabularyFileUri": "string
",
"VocabularyName": "string
"
}
Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- LanguageCode
-
Il codice della lingua che rappresenta la lingua delle voci del vocabolario personalizzato. Ogni vocabolario personalizzato deve contenere termini in una sola lingua.
Un vocabolario personalizzato può essere utilizzato solo per trascrivere file nella stessa lingua del vocabolario personalizzato. Ad esempio, se crei un vocabolario personalizzato utilizzando l'inglese americano (
en-US
), puoi applicare questo vocabolario personalizzato solo ai file che contengono audio in inglese.Per un elenco delle lingue supportate e dei codici di lingua associati, consulta la tabella Lingue supportate.
Tipo: String
Valori validi:
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
Campo obbligatorio: sì
- Phrases
-
Usa questo parametro se desideri creare il tuo vocabolario personalizzato includendo tutti i termini desiderati, come valori separati da virgole, nella tua richiesta. L'altra opzione per creare un vocabolario personalizzato consiste nel salvare le voci in un file di testo e caricarle in un bucket Amazon S3, quindi specificare la posizione del file utilizzando il
VocabularyFileUri
parametro.Nota che se includi
Phrases
nella tua richiesta, non puoi usarlaVocabularyFileUri
; devi scegliere l'uno o l'altro.Ogni lingua ha un set di caratteri che contiene tutti i caratteri consentiti per quella lingua specifica. Se utilizzi caratteri non supportati, la richiesta di filtro del vocabolario personalizzato non riesce. Consulta Set di caratteri per vocabolari personalizzati per ottenere il set di caratteri per la tua lingua.
Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello:
.+
Required: No
- Tags
-
Aggiunge uno o più tag personalizzati, ciascuno sotto forma di coppia chiave:valore, a un nuovo vocabolario personalizzato al momento della creazione di questo nuovo vocabolario personalizzato.
Per ulteriori informazioni sull'uso dei tag con Amazon Transcribe, consulta Risorse di tagging.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 200 elementi.
Required: No
- VocabularyFileUri
-
La posizione di Amazon S3 del file di testo che contiene il vocabolario personalizzato. L'URI deve trovarsi nellaRegione AWS stessa posizione della risorsa che stai chiamando.
Ecco un esempio di percorso URI:
s3://DOC-EXAMPLE-BUCKET/my-vocab-file.txt
Nota che se includi
VocabularyFileUri
nella tua richiesta, non puoi usare laPhrases
bandiera; devi scegliere l'una o l'altra.Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 2000 caratteri.
Modello:
(s3://|http(s*)://).+
Required: No
- VocabularyName
-
Un nome unico, scelto da te, per il tuo nuovo vocabolario personalizzato.
Questo nome fa distinzione tra maiuscole e minuscole, non può contenere spazi e deve essere univoco all'interno di unAccount AWS. Se provi a creare un nuovo vocabolario personalizzato con lo stesso nome di un vocabolario personalizzato esistente, ricevi un
ConflictException
errore.Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.
Pattern:
^[0-9a-zA-Z._-]+
Campo obbligatorio: sì
Sintassi della risposta
{
"FailureReason": "string",
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyName": "string",
"VocabularyState": "string"
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- FailureReason
-
In caso
VocabularyState
FAILED
affermativo,FailureReason
contiene informazioni sul motivo per cui la richiesta del vocabolario personalizzato non è riuscita. Vedi anche: Errori comuni.Tipo: String
- LanguageCode
-
Il codice della lingua che hai selezionato per il tuo vocabolario personalizzato.
Tipo: String
Valori validi:
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
-
La data e l'ora in cui hai creato il tuo vocabolario personalizzato.
I timestamp sono nel formato
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC
. Ad esempio,2022-05-04T12:32:58.761000-07:00
rappresenta le 12:32 UTC-7 del 4 maggio 2022.Tipo: Indicatore orario
- VocabularyName
-
Il nome che hai scelto per il tuo vocabolario personalizzato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.
Pattern:
^[0-9a-zA-Z._-]+
- VocabularyState
-
Lo stato di elaborazione del tuo vocabolario personalizzato. Se lo stato è
READY
, puoi utilizzare il vocabolario personalizzato in unaStartTranscriptionJob
richiesta.Tipo: String
Valori validi:
PENDING | READY | FAILED
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- BadRequestException
-
La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempio
IN PROGRESS
). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.Codice di stato HTTP: 400
- ConflictException
-
Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci all'interno di unAccount AWS.
Codice di stato HTTP: 400
- InternalFailureException
-
Si è verificato un errore interno. Controlla il messaggio di errore, correggi il problema e riprova con la richiesta.
Codice di stato HTTP: 500
- LimitExceededException
-
Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: