Um único comando invoca as capacidades de síntese e reconhecimento de voz do Bailian a partir do terminal, com gerenciamento de vocabulários de palavras-chave para melhor precisão.
Anexe --help a qualquer comando para obter detalhes completos dos parâmetros, por exemplo: bl speech synthesize --help. Todos os parâmetros que aceitam uma URL de arquivo também aceitam um caminho local — a CLI faz o upload automático para armazenamento temporário (válido por 48 horas), portanto, você nunca precisa hospedar arquivos como URLs. Os detalhes dos comandos nesta página são verificados com o bl 2.8.0.
Síntese de voz
bl speech synthesize
Sintetiza voz a partir de texto. Requer autenticação com chave de API.
Uso
bl speech synthesize --text <text> [flags]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--text <text> | string | Não | Texto a ser sintetizado em voz (ou use --text-file) |
--text-file <path> | string | Não | Leia o texto de um arquivo em vez de --text |
--model <model> | string | Não | ID do modelo (padrão: modelo TTS configurado no Perfil, caso contrário: cosyvoice-v3-flash). Vozes do sistema variam conforme o modelo |
--voice <voice> | string | Não | ID da voz. Use --list-voices para o modelo selecionado (por exemplo, qwen-audio-3.0-tts-plus/flash, cosyvoice-v3-flash); para v3.5-flash forneça um ID de voz clone/design |
--list-voices | switch | Não | Liste as vozes do sistema embutidas para o modelo selecionado e saia (link do console exibido na saída) |
--format <format> | string | Não | Formato de áudio: mp3, pcm, wav, opus (padrão: mp3; padrão streaming: pcm) |
--sample-rate <rate> | string | Não | Taxa de amostragem de áudio em Hz (por exemplo, 24000) |
--volume <volume> | string | Não | Volume de 0 a 100 (padrão: 50) |
--rate <rate> | string | Não | Taxa de fala de 0,5 a 2,0 (padrão: 1,0) |
--pitch <pitch> | string | Não | Multiplicador de tom de 0,5 a 2,0 (padrão: 1,0) |
--seed <seed> | string | Não | Semente aleatória de 0 a 65535 para síntese reprodutível |
--language <lang> | string | Não | Dica de idioma (por exemplo, zh, en, ja, ko, fr, de) |
--instruction <text> | string | Não | Instrução em linguagem natural para controlar o estilo de fala (por exemplo, "Use um tom suave") |
--enable-ssml | switch | Não | Habilita análise de marcação SSML no texto de entrada |
--out <path> | string | Não | Salve o áudio em arquivo (padrão: gera automaticamente no diretório temporário) |
--stream | switch | Não | Transmita áudio PCM bruto para stdout (redirecione para um tocador) |
--concurrent <n> | number | Não | Execute N solicitações paralelas (padrão: 1) |
Exemplo: Sintetize voz a partir de texto usando um modelo TTS
bl speech synthesize --list-voices --model qwen-audio-3.0-tts-plus
--model auto roteia modelos AIGC automaticamente pelo MCP desenvolvido pela Bailian e usa apenas os parâmetros de texto e voz suportados pelas ferramentas MCP. Parâmetros incompatíveis, como --format, --sample-rate e --stream, falham com erro de uso em vez de recorrer ao REST.
- Para solicitar saída JSON com streaming, especifique um arquivo com
--out para que os dados de áudio e os resultados JSON não se misturem no mesmo fluxo de saída.
Reconhecimento de voz
bl speech recognize
Reconheça voz a partir de arquivos de áudio (FunAudio-ASR / Qwen-ASR Flash). Requer autenticação com chave de API.
Uso
bl speech recognize --url <audio-url> [flags]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--url <url> | array | Sim | URL do arquivo de áudio ou caminho de arquivo local (repetível, máximo 100) |
--model <model> | string | Não | ID do modelo (padrão: modelo ASR configurado no Perfil, caso contrário: fun-asr). Assíncrono: fun-asr / -filetrans / paraformer-; síncrono: qwen3-asr-flash* / fun-asr-flash* / qwen-audio-*-asr-flash |
--language <lang> | string | Não | Dica de idioma (por exemplo, zh, en, ja). Clássico assíncrono/entrada de áudio: language_hints; qwen3-filetrans: language; qwen3 síncrono: asr_options.language |
--diarization | switch | Não | Habilita diarização automática de falantes |
--speaker-count <n> | number | Não | Número esperado de falantes (requer --diarization) |
--vocabulary-id <id> | string | Não | ID do vocabulário de palavras-chave pré-construído (crie-o via speech vocabulary create). Seu target_model deve corresponder exatamente a --model, caso contrário será ignorado silenciosamente. Suporte a modelos mais amplo que --vocabulary, incluindo Fun-ASR e Paraformer |
--vocabulary <json> | string | Não | Palavras-chave instantâneas como objeto JSON word→weight, por exemplo '{"Fendouzhe":4}'. Peso de 1 a 5 (recomendado: 4; valores maiores podem prejudicar outras palavras), 50 para palavra-chave super forte. Nenhum vocabulário pré-construído necessário. Tem efeito apenas nos modelos Qwen-Audio-3.0-ASR-Flash |
--context <text> | string | Não | Lista de palavras de melhoria de contexto para aumentar a precisão em nomes próprios; deve conter as palavras-alvo em si (uma descrição de tópico sozinha tem pouco efeito); máximo 400 caracteres. Tem efeito apenas nos modelos Qwen-Audio-3.0-ASR-Flash e Fun-ASR-Flash |
--channel-id <n> | number | Não | ID do canal de áudio (padrão: 0) |
--out <path> | string | Não | Salve o resultado completo da transcrição em arquivo JSON |
--async | switch | Não | Retorne o ID da tarefa assíncrona sem esperar |
--poll-interval <seconds> | number | Não | Intervalo de sondagem em segundos (padrão: 2) |
Exemplo: Reconheça voz a partir de uma URL de arquivo de áudio
bl speech recognize --url https://example.com/audio.mp3
--model auto roteia modelos AIGC automaticamente pelo MCP desenvolvido pela Bailian, usa apenas os parâmetros suportados pelas ferramentas MCP e simplifica a saída de texto. Parâmetros incompatíveis falham com erro de uso em vez de recorrer ao REST.O áudio deve ser um URL http(s) público; use --model <id> para reconhecer arquivos locais com um modelo específico.
- A saída JSON preserva a resposta completa e a transcrição. Quando nenhuma transcrição é retornada, as informações da tarefa ainda são incluídas.
Gerenciamento de vocabulários de palavras-chave
Gerencie vocabulários de palavras-chave pré-construídos reutilizáveis para melhorar a precisão do ASR em nomes próprios.
bl speech vocabulary create
Crie um vocabulário de palavras-chave pré-compilado para ASR. Requer autenticação com chave de API.
Uso
bl speech vocabulary create --model <model> --prefix <prefix> (--words <json> | --words-file <path>) [flags]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--model <model> | string | Sim | Modelo ASR para o qual este vocabulário é criado. Deve corresponder exatamente ao --model passado posteriormente em speech recognize, caso contrário o vocabulário será ignorado silenciosamente |
--prefix <prefix> | string | Sim | Prefixo personalizado para o vocabulário. Apenas dígitos e letras minúsculas, máximo 10 caracteres |
--words <json> | string | Não | Palavras-chave como objeto JSON word→weight, por exemplo '{"Fendouzhe":4}'; ou a matriz de entrada da API para linguagem por entrada. Peso de 1 a 5 (recomendado: 4); quando o target_model do vocabulário for um modelo da série Qwen-Audio-3.0-ASR-Flash, 50 também é permitido como palavra-chave super forte. Ou use --words-file |
--words-file <path> | string | Não | Arquivo JSON com as palavras-chave (use - para stdin) |
--lang <code> | string | Não | Código de idioma aplicado a cada palavra-chave ao usar formato objeto (opcional; ignorado para formato de matriz). Paraforme: zh/en/ja/yue/ko/de/fr/ru; Fun-ASR: zh/en/ja |
Exemplo: Crie um vocabulário de palavras-chave para ASR com palavras personalizadas
bl speech vocabulary create --model fun-asr --prefix demo --words '{"Fendouzhe":4,"Jingluo":4}'
- O --model deve corresponder exatamente ao --model usado posteriormente com
speech recognize --vocabulary-id; uma discrepância causa falha silenciosa sem erro.
bl speech vocabulary list
Liste vocabulários de palavras-chave pré-compilados. Requer autenticação com chave de API.
Uso
bl speech vocabulary list [--prefix <prefix>] [--page <n>] [--page-size <n>]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--prefix <prefix> | string | Não | Filtrar por prefixo de vocabulário |
--page <n> | number | Não | Número da página, baseado em 1 (padrão: 1). Mapeado para page_index da API (baseado em 0) como page - 1 |
--page-size <n> | number | Não | Resultados por página (padrão: 10) |
Exemplo: Liste vocabulários de palavras-chave pré-compilados por prefixo
bl speech vocabulary list --prefix demo
- As respostas da lista não incluem target_model; use
speech vocabulary get para inspecionar o modelo para o qual um vocabulário foi criado.
- Vocabulários com status UNDEPLOYED são ignorados silenciosamente pelo ASR.
bl speech vocabulary get
Obtenha detalhes de um vocabulário de palavras-chave pré-compilado. Requer autenticação com chave de API.
Uso
bl speech vocabulary get --id <id>
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--id <id> | string | Sim | ID do vocabulário de palavras-chave |
Exemplo: Recupere detalhes de um vocabulário de palavras-chave específico
bl speech vocabulary get --id vocab-demo-xxx
- Use este comando para confirmar target_model antes de chamar
speech recognize --vocabulary-id; uma discrepância de modelo causa falha silenciosa.
bl speech vocabulary update
Substitua o conteúdo de um vocabulário de palavras-chave pré-compilado. Requer autenticação com chave de API.
Uso
bl speech vocabulary update --id <id> (--words <json> | --words-file <path>) [flags]
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--id <id> | string | Sim | ID do vocabulário de palavras-chave |
--words <json> | string | Não | Palavras-chave como objeto JSON word→weight, por exemplo '{"Fendouzhe":4}'; ou a matriz de entrada da API para linguagem por entrada. Peso de 1 a 5 (recomendado: 4); quando o target_model do vocabulário for um modelo da série Qwen-Audio-3.0-ASR-Flash, 50 também é permitido como palavra-chave super forte. Ou use --words-file |
--words-file <path> | string | Não | Arquivo JSON com as palavras-chave (use - para stdin) |
--lang <code> | string | Não | Código de idioma aplicado a cada palavra-chave ao usar formato objeto (opcional; ignorado para formato de matriz). Paraforme: zh/en/ja/yue/ko/de/fr/ru; Fun-ASR: zh/en/ja |
--yes | switch | Não | Confirme esta operação de alto risco |
Esta substitui completamente todas as palavras-chave no vocabulário. Entradas não listadas serão descartadas e não poderão ser desfeitas.
Exemplo: Visualize a atualização do vocabulário de palavras-chave com palavras especificadas
bl speech vocabulary update --id vocab-demo-xxx --words '{"Fendouzhe":4}' --dry-run
- update é uma substituição completa, não uma adição. Prefira --dry-run primeiro para visualizar o vocabulário completo que será escrito.
bl speech vocabulary delete
Exclui um vocabulário de palavras-chave pré-compiladas. Requer autenticação com chave de API.
Uso
bl speech vocabulary delete --id <id>
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
--id <id> | string | Sim | ID do vocabulário de palavras-chave |
--yes | switch | Não | Confirme esta operação de alto risco |
Esta ação exclui permanentemente o vocabulário de palavras-chave especificado e não pode ser desfeita.
Exemplo: Visualize a exclusão do vocabulário de palavras-chave
bl speech vocabulary delete --id vocab-demo-xxx --dry-run