Conecta-seEntrar na plataforma

Transcrever áudio

Converter fala em texto usando modelos de inteligência artificial.

Lógica e processamentoInteligência artificialConexão: Provedor de IA configurado no workspace

O que faz

Transcreva arquivos de áudio e vídeo para texto usando os principais provedores de IA. Aceita vários idiomas, marcações de tempo e identificação de quem está falando (diarização).

Quando usar: Use quando o seu fluxo precisar converter fala em texto usando modelos de inteligência artificial.

Exemplo de situação: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

Antes de começar

Conexão necessária: Provedor de IA configurado no workspace.

Cadastre a chave do provedor de IA do workspace em Configurações e escolha um modelo disponível.

Passo a passo

  1. Adicione Transcrever áudio ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Cadastre a chave do provedor de IA do workspace em Configurações e escolha um modelo disponível.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Provedor

    Obrigatório

    Escolhe uma das opções aceitas por este campo.

    Opções:
    OpenAI Whisper · Deepgram · AssemblyAI · Google Gemini
    Padrão:
    OpenAI Whisper
  • Modelo

    Obrigatório conforme a operação

    Escolhe o modelo de inteligência artificial que processará a solicitação.

    Quando aparece:
    Quando o campo “Provedor” for “OpenAI Whisper”
    Opções:
    Whisper-1
    Padrão:
    Whisper-1
  • Arquivo de áudio/vídeo

    Obrigatório

    Envie um arquivo de áudio ou vídeo.

    Exemplo:
    (selecione um arquivo de teste)
  • Referência ao arquivo de áudio/vídeo

    ObrigatórioEm campos adicionais

    Use o áudio/vídeo de blocos anteriores.

    Exemplo:
    Use o áudio/vídeo de blocos anteriores
  • URL do áudio/vídeo

    Ou informe uma URL pública do áudio/vídeo.

    Exemplo:
    https://api.exemplo.com/v1/recurso
  • Linguagem

    Obrigatório

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Detectar automaticamente · Inglês · Espanhol · Francês · Alemão · Italiano · Português · Holandês · Russo · Chinês · Japonês · Coreano · Árabe · Híndi · Polonês · Turco · Sueco · Dinamarquês · Norueguês · Finlandês
    Padrão:
    Detectar automaticamente
  • Marcações de tempo

    Obrigatório

    Define a data, o horário ou a programação usada pela operação.

    Opções:
    Nenhum · Por frase · Por palavra
    Padrão:
    Nenhum
  • Identificar quem está falando (diarização)

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Provedor” for “Deepgram” ou “AssemblyAI”
    Exemplo:
    false
  • Traduzir para o inglês

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Provedor” for “OpenAI Whisper”
    Exemplo:
    false
  • Análise de sentimento

    Define a data, o horário ou a programação usada pela operação.

    Quando aparece:
    Quando o campo “Provedor” for “AssemblyAI”
    Exemplo:
    false
  • Detecção de entidades

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Provedor” for “AssemblyAI”
    Exemplo:
    false
  • Ocultar dados pessoais (PII)

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Provedor” for “AssemblyAI”
    Exemplo:
    false
  • Resumo automático

    Ativa ou desativa este comportamento.

    Quando aparece:
    Quando o campo “Provedor” for “AssemblyAI”
    Exemplo:
    false
  • Chave de API

    ObrigatórioDado protegido

    Informe a sua chave de API.

    Padrão:
    Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <transcreveraudio.transcript>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<transcreveraudio.transcript>stringTexto transcrito completo.
<transcreveraudio.segments>arrayTrechos com marcação de tempo e identificação de quem está falando.
<transcreveraudio.language>stringIdioma detectado ou informado.
<transcreveraudio.duration>numberDuração do áudio em segundos.
<transcreveraudio.confidence>numberÍndice geral de confiança.
<transcreveraudio.sentiment>arrayResultados da análise de sentimento.
<transcreveraudio.entities>arrayEntidades detectadas.
<transcreveraudio.summary>stringResumo gerado automaticamente.

Exemplo de uso

Objetivo: Interpretar uma solicitação e produzir uma resposta adequada ao contexto.

InícioTranscrever áudiopróxima etapa
Provedor
OpenAI Whisper
Arquivo de áudio/vídeo
(selecione um arquivo de teste)
Linguagem
Detectar automaticamente
Marcações de tempo
Nenhum
Modelo
Whisper-1
URL do áudio/vídeo
https://api.exemplo.com/v1/recurso

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <transcreveraudio.transcript>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Blocos relacionados