> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/ai-steps/transcription.md).

# Transcrever ficheiro de áudio

Transcreva ficheiros de áudio ou vídeo para texto

## Como Configurar a Etapa de Transcrição

Ao configurar uma Etapa de Transcrição, há dois elementos principais a considerar:

1. Selecionar o melhor modelo de transcrição para o seu caso de utilização
2. Como passar o seu ficheiro de áudio para o AirOps

Assim que estiver pronto para começar, pode clicar no botão "Configurar" da sua Etapa de Transcrição para definir estes valores.

{% @arcade/embed url="<https://app.arcade.software/share/zw6zMG4DZf8rLDhjlrPC>" flowId="zw6zMG4DZf8rLDhjlrPC" %}

### **Modelo de Transcrição**

O AirOps oferece os seguintes modelos de transcrição:

* [**Deepgram Whisper Large**](https://deepgram.com/learn/improved-whisper-api)**:** transcrição rápida e fiável que inclui diarização integrada (identificação de orador). Com capacidade de autodetetar o idioma ou definir o idioma [código](https://developers.deepgram.com/docs/languages-overview)
* [**Deepgram Nova**](https://deepgram.com/learn/nova-speech-to-text-whisper-api)**:** o modelo mais rápido até à data
* [**Deepgram Nova 2**](https://deepgram.com/learn/nova-2-speech-to-text-api)**:** oferece o melhor valor global
* **Deepgram Nova 3:** o mais recente modelo Nova da Deepgram. Escolha o Nova 3 quando quiser a maior precisão de transcrição da Deepgram e puder aceitar uma latência ligeiramente superior à do Nova 2.
* [**Deepgram Enhanced**](https://deepgram.com/changelog/introducing-new-enhanced-model)**:** maior precisão e melhor reconhecimento de palavras. Com capacidade de autodetetar o idioma ou definir o idioma [código](https://developers.deepgram.com/docs/languages-overview)
* [**AssemblyAI**](https://www.assemblyai.com/blog/conformer-2/)**:** Com a capacidade de selecionar o número de oradores esperados numa transcrição, a AssemblyAI é uma excelente escolha para diarização

{% hint style="warning" %}
Tenha em conta: a Deepgram tem um **2GB** limite de tamanho de ficheiro e a AssemblyAI tem um **5GB** limite de tamanho de ficheiro
{% endhint %}

### Adicionar o Seu Ficheiro ao AirOps

Atualmente, há dois métodos para enviar os seus ficheiros de áudio ou vídeo para o AirOps.

#### Opção #1: Carregar através da IU do AirOps

* No `Etapa Inicial` do seu Workflow, defina a entrada do Workflow como "File Media"
* Adicione a **entrada** como o `Ficheiro a transcrever`

{% @arcade/embed url="<https://app.arcade.software/share/T7L31xTdI3bTIzyQIFL4>" flowId="T7L31xTdI3bTIzyQIFL4" %}

#### Opção #2: Carregar através do Google Drive

* No Google Drive, configure o seu ficheiro de áudio ou vídeo para que "Qualquer pessoa com o link" o possa ver:

<figure><img src="https://files.readme.io/cc901be-image.png" alt="" width="375"><figcaption></figcaption></figure>

* Adicione um **entrada** com o nome da variável `google_drive_link`
* Adicione uma **etapa de código** com o seguinte JavaScript para converter o URL partilhável do Google Drive num URL descarregável:
* <pre><code><strong>const fileID = google_drive_link.match(/[-\w]{25,}/);
  </strong>
  return `https://drive.google.com/uc?export=download&#x26;id=${fileID[0]}&#x26;confirm=t`
  </code></pre>
* Adicione a *saída da etapa de código* como o `Ficheiro a transcrever`

{% @arcade/embed url="<https://app.arcade.software/share/taddcde90KVBzgX6iSJA>" flowId="taddcde90KVBzgX6iSJA" %}

### Vários oradores?

Se selecionado, o modelo detetará automaticamente vários oradores. Isto resultará nas seguintes saídas do modelo.

> Orador 0:
>
> Orador 1:
>
> Orador 0:

> Orador A:
>
> Orador B:
>
> Orador A:

{% hint style="info" %}
Apenas a AssemblyAI permite selecionar o número de oradores esperados. Sem selecionar o número de oradores, a transcrição poderá detetar mais (ou menos) oradores do que o esperado
{% endhint %}

### Detetar idioma?

Marque para detetar automaticamente o idioma do ficheiro

### Idioma

Se `Detetar idioma?` estiver desmarcado, pode especificar o idioma que pretende detetar.

{% hint style="danger" %}
Nem todos os modelos suportam vários idiomas. Consulte a documentação de cada modelo abaixo para determinar quais os idiomas suportados
{% endhint %}

{% embed url="<https://developers.deepgram.com/docs/languages-overview>" %}

{% embed url="<https://www.assemblyai.com/docs/concepts/supported-languages>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/ai-steps/transcription.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.