Use o SDK Java para criar, consultar, atualizar e excluir vocabulários personalizados de reconhecimento de fala.
Endpoint
Por padrão, o SDK usa o endpoint da região China (Pequim). Para mudar para outra região, modifique Constants.baseHttpApiUrl antes da inicialização.
- China (Pequim)
- Singapura
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1Substitua {WorkspaceId} pelo seu ID do workspace real.- Singapura
- China (Pequim)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Substitua {WorkspaceId} pelo seu ID do Workspace real.Constants.baseHttpApiUrl antes da inicialização:
- As chaves de API variam conforme a região. Use a chave correspondente à sua região.
- A configuração de região é global e afeta todas as chamadas à API DashScope.
VocabularyService
Pacote: com.alibaba.dashscope.audio.asr.vocabulary.VocabularyService
Descrição: Crie, consulte, atualize e exclua vocabulários personalizados.
Construtor
Parâmetro | Tipo | Descrição |
|---|---|---|
apiKey | String | Chave de API do DashScope |
createVocabulary() - Criar um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
targetModel | String | Sim | Modelo de reconhecimento de fala que usa este vocabulário. Este valor deve corresponder exatamente ao modelo especificado na chamada da API de reconhecimento de fala. |
prefix | String | Sim | Prefixo personalizado para o vocabulário. São permitidos apenas letras minúsculas e dígitos, com comprimento máximo de 10 caracteres. |
vocabulary | JsonArray | Sim | Lista de hotwords. Cada JsonObject contém campos como text, weight e lang. Para mais informações, consulte Estrutura do objeto Hotword. |
Tipo | Descrição |
|---|---|
Vocabulary | Objeto de vocabulário personalizado contendo o ID do vocabulário e outros metadados. |
Exceção | Descrição |
|---|---|
NoApiKeyException | A chave de API está vazia. |
InputRequiredException | Um parâmetro obrigatório está vazio. |
listVocabulary() - Listar vocabulários personalizados
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prefix | String | Não | Prefixo personalizado do vocabulário. Quando especificado, apenas vocabulários com este prefixo são retornados. |
pageIndex | int | Não | Número da página, iniciando em 0. Valor padrão: 0. |
pageSize | int | Não | Quantidade de entradas por página. Valor padrão: 10. |
Tipo | Descrição |
|---|---|
Vocabulary[] | Array de objetos de vocabulário personalizado. |
Campo | Tipo | Descrição |
|---|---|---|
vocabularyId | String | ID do vocabulário. |
gmtCreate | String | Data e hora de criação. |
gmtModified | String | Data e hora da última modificação. |
status | String | Status:
|
Exceção | Descrição |
|---|---|
NoApiKeyException | A chave de API está vazia. |
InputRequiredException | Um parâmetro obrigatório está vazio. |
queryVocabulary() - Consultar um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabularyId | String | Sim | ID do vocabulário personalizado a ser consultado. |
Tipo | Descrição |
|---|---|
Vocabulary | Objeto |
Campo | Tipo | Descrição |
|---|---|---|
vocabulary | JsonArray | Conteúdo do vocabulário personalizado. |
targetModel | String | Modelo de reconhecimento de fala que usa este vocabulário. Este valor deve corresponder exatamente ao modelo especificado na chamada da API de reconhecimento de fala. |
gmtCreate | String | Data e hora de criação. |
gmtModified | String | Data e hora da última modificação. |
status | String | Status:
|
Exceção | Descrição |
|---|---|
NoApiKeyException | A chave de API está vazia. |
InputRequiredException | Um parâmetro obrigatório está vazio. |
updateVocabulary() - Atualizar um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabularyId | String | Sim | ID do vocabulário a ser atualizado. |
vocabulary | JsonArray | Sim | Novo vocabulário. Esta operação substitui completamente as entradas existentes. |
Exceção | Descrição |
|---|---|
NoApiKeyException | A chave de API está vazia. |
InputRequiredException | Um parâmetro obrigatório está vazio. |
deleteVocabulary() - Excluir um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabularyId | String | Sim | ID do vocabulário a ser excluído. |
Exceção | Descrição |
|---|---|
NoApiKeyException | A chave de API está vazia. |
InputRequiredException | Um parâmetro obrigatório está vazio. |
Classe Vocabulary
Pacote: com.alibaba.dashscope.audio.asr.vocabulary.Vocabulary
Descrição: Armazena os metadados e o conteúdo de um vocabulário personalizado.
Métodos
Método | Tipo de retorno | Descrição |
|---|---|---|
getVocabularyId() | String | Retorna o ID do vocabulário. |
getTargetModel() | String | Retorna o modelo de destino. |
getVocabulary() | JsonArray | Retorna o conteúdo do vocabulário personalizado. |
getStatus() | String | Retorna o status. |
getGmtCreate() | String | Retorna a data e hora de criação. |
getGmtModified() | String | Retorna a data e hora da última modificação. |
getData() | JsonObject | Retorna os dados completos em formato JSON. |
Estrutura do objeto Hotword
Campos em cada JsonObject de hotword:
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
text | String | Sim | Texto da entrada do vocabulário. O idioma do texto deve ter suporte no modelo selecionado. Os idiomas suportados variam conforme o modelo. Use palavras reais em vez de combinações arbitrárias de caracteres para melhorar a precisão do reconhecimento. Comprimento máximo: 15 caracteres para texto com caracteres não ASCII ou 7 palavras separadas por espaços para texto exclusivamente ASCII. |
weight | int | Sim | Peso da entrada do vocabulário. Valor recomendado: 4. Valores válidos: 1 a 5. Se a precisão do reconhecimento não melhorar, aumente o peso. Um peso excessivamente alto pode reduzir a precisão no reconhecimento de outras palavras. |
lang | String | Não | Código do idioma do áudio a ser reconhecido. Quando definido, o sistema aprimora o reconhecimento das entradas de vocabulário no idioma especificado. Se não for possível determinar o idioma antecipadamente, deixe este parâmetro indefinido. O modelo detecta o idioma automaticamente. Valores válidos (variam conforme o modelo):
|