Use o SDK Python para criar, listar, consultar, atualizar e excluir vocabulários personalizados de reconhecimento de fala.
Endpoint
Por padrão, o SDK conecta-se ao endpoint da China (Pequim). Para usar outra região, especifique o parâmetro region ao construir o dashscope.Client (por exemplo, ap-southeast-1 para a região de Singapura).
- 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.- As chaves de API variam conforme a região. Use a chave correspondente à sua região.
- A configuração de região é uma definição em nível de instância do
dashscope.Cliente afeta apenas as chamadas de API feitas por esse client.
client.audio.vocabularies
Entrada do recurso: recurso client.audio.vocabularies da instância dashscope.Client
Descrição: gerencie o ciclo de vida dos vocabulários personalizados (criação, consulta, atualização e exclusão).
Construção
api_key não for passado, o SDK lerá automaticamente o valor da variável de ambiente DASHSCOPE_API_KEY.
create() - Criar um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
target_model | str | 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 | str | Sim | Prefixo personalizado para o vocabulário. Aceita apenas letras minúsculas e dígitos, com limite de 10 caracteres. |
vocabulary | List[dict] | Sim | Lista de palavras-chave. Cada entrada é um dicionário com os campos text, weight e lang. Para mais detalhes, consulte Estrutura do dicionário de palavras-chave. |
Tipo | Descrição |
|---|---|
Vocabulary | Objeto de vocabulário; obtenha o ID do vocabulário criado pelo campo |
list() - Listar vocabulários personalizados
Corresponde à ação da API HTTP action: list_vocabulary.
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
prefix | str | Não | Prefixo personalizado do vocabulário. Se especificado, a resposta incluirá apenas vocabulários com este prefixo. |
page_index | int | Não | Número da página, começando em 0. Valor padrão: 0. |
page_size | int | Não | Quantidade de itens por página. Valor padrão: 10. |
Tipo | Descrição |
|---|---|
VocabularyList | Objeto de paginação de vocabulários; o campo |
Campo | Tipo | Descrição |
|---|---|---|
vocabulary_id | str | ID do vocabulário. |
gmt_create | str | Data e hora de criação. |
gmt_modified | str | Data e hora da última modificação. |
status | str | Status:
|
get() - Consultar um vocabulário personalizado
Corresponde ao query_vocabulary() do SDK 1.x.
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabulary_id | str | Sim | ID do vocabulário personalizado a consultar. |
Tipo | Descrição |
|---|---|
Vocabulary | Objeto com os detalhes do vocabulário, contendo vocabulary, target_model, gmt_create, gmt_modified e status. |
Campo | Tipo | Descrição |
|---|---|---|
vocabulary | List[dict] | Conteúdo da lista de palavras-chave. |
target_model | str | 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. |
gmt_create | str | Data e hora de criação. |
gmt_modified | str | Data e hora da última modificação. |
status | str | Status:
|
update() - Atualizar um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabulary_id | str | Sim | ID do vocabulário a atualizar. |
vocabulary | List[dict] | Sim | Novo vocabulário. Esta lista substitui integralmente as entradas existentes. |
delete() - Excluir um vocabulário personalizado
Assinatura do método:
Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
vocabulary_id | str | Sim | ID do vocabulário a excluir. |
Estrutura do dicionário de palavras-chave
Campos em cada dicionário de vocabulário:
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
text | str | Sim | Texto da entrada do vocabulário. O idioma do texto deve ser compatível com o modelo selecionado. Os idiomas suportados variam conforme o modelo. Use palavras reais em vez de combinações arbitrárias de caracteres para aumentar a precisão do reconhecimento. Limite máximo: 15 caracteres para textos com caracteres não ASCII ou 7 palavras separadas por espaços para textos 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 | str | Não | Código do idioma do áudio a reconhecer. Quando definido, o sistema aprimora o reconhecimento das entradas do vocabulário no idioma especificado. Caso não seja possível determinar o idioma antecipadamente, deixe este parâmetro indefinido. O modelo detecta o idioma automaticamente. Valores válidos (variam conforme o modelo):
|