> 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 aspetos principais a considerar:

1. Selecionar o melhor modelo de transcrição para o seu caso de uso
2. Como enviar o seu ficheiro de áudio para a 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**

A 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 locutor). Com a capacidade de detetar automaticamente 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 a capacidade de detetar automaticamente 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 locutores esperados numa transcrição, a AssemblyAI é uma excelente escolha para diarização

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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-3fe1b2c20e04d06bc8a706e2ba8f504faaaa2bd5%2Ftranscription-01-step-config.png?alt=media" alt="Transcribe Audio step with the transcription model dropdown open, listing Deepgram models and AssemblyAI (Best for Diarization), with Deepgram Nova 3 (Best Accuracy) selected"><figcaption><p>Escolha um modelo de transcrição para a etapa.</p></figcaption></figure>

### Adicionando o seu Ficheiro à AirOps

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

#### Opção #1: Carregar através da interface de utilizador da AirOps

* Na `Etapa Inicial` do seu Workflow, defina a entrada do Workflow como "Media de Ficheiro"
* Adicione o **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 a ligação" o possa ver:

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

* Adicione uma **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 para transferência:
* <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 o *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 locutores?

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

> Locutor 0:
>
> Locutor 1:
>
> Locutor 0:

> Locutor A:
>
> Locutor B:
>
> Locutor A:

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

### Detetar idioma?

Marque para detetar automaticamente o idioma do ficheiro

### Idioma

Se `Detetar idioma?` não estiver marcado, 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 idiomas são 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.
