Use o SDK C# para chamar o Qwen-LiveTranslate-Realtime via WebSocket e traduzir a fala em texto e áudio no idioma de destino.
Instale o SDK
Baixe e extraia Bailian.DashScope-1.1.0.zip. Para usar o SDK em um projeto C#, instale-o a partir da fonte local do NuGet.
Início rápido
- Obtenha uma chave de API e defina a variável de ambiente
DASHSCOPE_API_KEY. Use uma chave de API da mesma região que seu espaço de trabalho. - Crie um projeto de console .NET 10 e instale o SDK como descrito acima.
- Coloque
input.pcmno diretório do projeto. Use áudio PCM bruto, mono, de 16 bits em little-endian com taxa de amostragem de 16 kHz. Converta os arquivos WAV em PCM bruto primeiro.
WorkspaceId pelo ID do seu espaço de trabalho. Consulte as regiões e os endpoints disponíveis em Acesso por WebSocket.
Exemplo em C#
O programa transmite uma gravação PCM bruta em tempo real, aguarda a conclusão da resposta e grava o áudio em output.pcm. Substitua o conteúdo de Program.cs pelo código a seguir.
Referência da API
Use DashScope.Qwen.QwenLiveTranslator com QwenLiveTranslateOptions. Algumas configurações de sessão e alguns campos de eventos variam entre as versões 3.5 e 3.8. Consulte a referência de eventos do cliente para o seu modelo.
Opções de conexão e tradução
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
ApiKey | string? | null | Chave de API do Model Studio. Quando omitida, o SDK lê DASHSCOPE_API_KEY. |
Url | string | wss://dashscope.aliyuncs.com/api-ws/v1/realtime | Endpoint WebSocket. O SDK adiciona Model como parâmetro de consulta model. |
WorkspaceId | string? | null | ID do espaço de trabalho enviado no cabeçalho X-DashScope-WorkSpace. Para usar o endpoint do seu espaço de trabalho, defina o endereço completo em Url. |
ConnectTimeout | TimeSpan | 10 s | Tempo limite para abrir a conexão WebSocket. |
StartTimeout | TimeSpan | 10 s | Tempo limite para receber session.created. |
StopTimeout | TimeSpan | 10 s | Tempo limite para receber session.finished quando o modo de encerramento aguarda esse evento. |
FinishMode | QwenRealtimeFinishMode? | null | Quando omitido, o SDK escolhe o modo de encerramento de acordo com o modelo. Consulte FinishMode na instância para saber qual modo está em uso. |
Model | string | qwen3.5-livetranslate-flash-realtime | ID do modelo. |
Modalities | IList<string> | ["text", "audio"] | Modalidades de saída. Use ["text"] para receber apenas texto traduzido. |
Voice | string? | null | Voz do áudio traduzido. Quando omitida, o servidor seleciona a voz padrão. Ao gerar áudio com a versão 3.8, especifique uma voz compatível com o modelo. |
EnableVoiceClone | bool? | null | Habilita a clonagem de voz para áudio traduzido. |
VoiceCloneFrequency | string | once | once clona a voz no início da sessão, always faz isso para cada frase e never utiliza um ID de voz clonada existente. Verifique quais modos seu modelo suporta. |
SampleRate | int | 16000 | Taxa de amostragem de entrada em Hz. Escolha uma taxa de amostragem compatível com seu modelo. |
InputAudioFormat | string | pcm | Formato de áudio de entrada. A opção do SDK aceita pcm ou opus. Consulte a referência de eventos do cliente para os formatos compatíveis com seu modelo. |
OutputAudioFormat | string? | null | Formato de áudio de saída, como pcm. Quando omitido, o servidor usa seu padrão. |
TranscriptionModel | string? | qwen3-asr-flash-realtime | Modelo para reconhecimento de fala de origem. Com qwen3.5-livetranslate-flash-realtime, defina esta opção e SourceLanguage como null para omitir input_audio_transcription. O reconhecimento de fala de origem está sempre habilitado na versão 3.8. |
SourceLanguage | string? | null | Código de idioma de origem, como zh. Quando omitido, o servidor detecta o idioma. |
TargetLanguage | string | en | Código de idioma de destino, como en. |
SkipSameLanguageText | bool? | null | Pula o texto traduzido quando os idiomas de origem e destino forem iguais. Verifique se sua versão do modelo suporta esta opção. |
SkipSameLanguageAudio | bool? | null | Pula o áudio traduzido quando os idiomas de origem e destino forem iguais. Verifique se sua versão do modelo suporta esta opção. |
CorpusPhrases | IDictionary<string, string>? | null | Glossário de tradução que mapeia termos de origem para termos de destino em translation.corpus.phrases. |
VadThreshold | double? | 0.5 | Limiar de VAD do servidor de -1,0 a 1,0. |
VadSilenceMs | int | 1000 | Duração de silêncio em milissegundos antes de o servidor detectar o fim da fala. |
EnableDebugInfo | bool? | null | Solicita informações de depuração do servidor. |
session.input_modalities como ["audio", "video"], conforme indicado em Acesso por WebSocket. Em seguida, envie quadros de imagem junto com o áudio. AppendImageAsync envia quadros de imagem. Use SendRawEventAsync para enviar eventos completos do cliente quando precisar definir campos sem opção correspondente no SDK.
Métodos
Os métodos abaixo retornam Task, exceto por DisposeAsync. ct é um token de cancelamento opcional.
| Método | Descrição |
|---|---|
ConnectAsync(CancellationToken ct = default) | Abre a conexão, aguarda session.created e envia session.update. |
AppendAudioAsync(ReadOnlyMemory<byte> pcm, CancellationToken ct = default) | Envia um quadro de áudio. O SDK codifica os bytes com Base64 e envia um evento input_audio_buffer.append. |
AppendImageAsync(string imageBase64, CancellationToken ct = default) | Envia um quadro de imagem Base64 em input_image_buffer.append. Selecione um modelo que suporte entrada de imagem e habilite a entrada de áudio e imagem primeiro. |
SendRawEventAsync(string frameJson, CancellationToken ct = default) | Envia o JSON completo do evento do cliente conforme fornecido. Use este método para eventos sem um método SDK dedicado. |
FinishAsync(CancellationToken ct = default) | Encerra a sessão usando o FinishMode ativo. |
AbortAsync() | Fecha a conexão imediatamente e descarta resultados pendentes. |
DisposeAsync() | Libera recursos de forma assíncrona e retorna um ValueTask. |
Eventos
| Evento | Argumento do evento | Quando é disparado |
|---|---|---|
SessionReady | string? | A sessão está pronta. O valor é session.id. |
SourceTranscriptUpdated | QwenTranscriptEventArgs | Transcrição parcial da fala original. O evento ocorre quando o reconhecimento da fala original está habilitado. |
SourceTranscriptCompleted | QwenTranscriptEventArgs | Transcrição final de um trecho da fala original. |
TranslationTextDelta | QwenTextDeltaEventArgs | Delta de tradução. Leia TranslationCompleted para a tradução final. |
TranslationCompleted | QwenTranscriptEventArgs | Tradução completa do trecho de fala. |
TranslatedAudioChunk | QwenAudioChunkEventArgs | Trecho de áudio traduzido. O formato e taxa de amostragem dependem da configuração da sessão e da resposta do modelo. |
TranslatedAudioCompleted | EventArgs | Todo o áudio traduzido para a rodada chegou. |
ResponseCompleted | QwenResponseSummary | response.done chegou com status e uso. |
RawServerEvent | QwenServerEventArgs | Evento bruto do servidor com seu tipo e objeto JSON. |
ErrorOccurred | DashScopeErrorEventArgs | Ocorreu um erro no servidor ou falha na conexão. |
Encerramento da sessão
Depois de enviar todo o áudio, chame FinishAsync para encerrar a sessão e receber o texto e o áudio traduzidos restantes. Por padrão, o LiveTranslate usa FinishAndWait, que envia session.finish e aguarda session.finished.