Transcribir Audio
Usa esta acción cuando tengas un archivo de audio en el storage de tu empresa y quieras generar una transcripción de él.
Mejor para
- Transcribir un archivo que el propio workflow acaba de crear, como el resultado de Subir a Storage o Descargar a Storage
- Convertir notas de voz o grabaciones de llamadas en texto para pasos posteriores
- Producir archivos de subtítulos (
srt,vtt) junto con la transcripción simple
Para transcribir un audio que ya está en una conversación, usa Ejecutar función en documento con la función de transcripción del propio mensaje — está hecha para ese caso.
Campos principales
| Campo | Qué hace |
|---|---|
| Archivo | El audio a transcribir, normalmente step(0).file de un paso anterior |
| Bucket y Ruta completa | Alternativa a Archivo cuando quieras apuntar directamente al objeto |
| Perfil de transcripción | Qué configuración de transcripción usar. Déjalo vacío para usar el valor por defecto de la empresa |
| Idioma | Sobrescribe el idioma del perfil, por ejemplo pt-BR |
| Formats | Qué salidas generar: txt, srt, vtt, json. Las cuatro por defecto |
| Propósito | Etiqueta opcional de para qué es este paso, mostrada en los logs |
Qué pueden usar los pasos posteriores
| Valor | Qué es |
|---|---|
step(N).jobId | El ID del trabajo de transcripción |
step(N).jobStatus | El estado del trabajo al encolarse — normalmente pending |
step(N).enginePath | Cómo se procesará el audio |
step(N).providerType | Qué proveedor de transcripción lo ejecutará |
step(N).diarized | Si la transcripción identificará quién habla |
Esta acción encola el trabajo — no espera por él
El paso devuelve un ID de trabajo y termina de inmediato. Una transcripción real tarda minutos, así que se ejecuta en segundo plano.
Eso significa que la transcripción no queda disponible para el siguiente paso de la misma ejecución. Para obtener el resultado:
- Abre el panel de transcripciones en la aplicación, o
- Consulta el trabajo por su ID en otra ejecución de workflow, más tarde
También recibes una notificación cuando el trabajo termina.
Consejos
- Puedes encolar hasta 10 trabajos de transcripción a la vez. Más allá de eso el paso falla hasta que terminen los trabajos anteriores.
- La transcripción cuenta para el uso de tu plan. Los perfiles que usan tus propias claves de proveedor se registran, pero no se cobran.
- Lee el resultado del trabajo en
step(N).jobStatus, no enstep(N).status—statusestá reservado para códigos de estado HTTP y no contiene el estado del trabajo.