> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Edição de transcrições

> **Note**
>
> **Guia prático** · Pressupõe que você concluiu o [guia de início rápido do Speech to Text ](/docs/pt/eleven-api/guides/cookbooks/speech-to-text).

## Visão geral

> **Warning**
>
> A edição de transcrições é um recurso experimental e tem um custo adicional de 30% sobre o
> custo base de transcrição, cobrado para no mínimo 10 segundos de áudio por solicitação. Consulte a [página de preços da API](https://elevenlabs.io/pricing?price.section=speech_to_text\&price.sections=speech_to_text,speech_to_text#pricing-table)
> para informações detalhadas sobre preços.

A edição de transcrições permite adicionar uma instrução em linguagem natural a uma solicitação de transcrição. Depois que o áudio é transcrito, sua instrução é aplicada à transcrição, e o texto editado é retornado junto com o original.

Isso substitui uma etapa separada de pós-processamento no seu próprio pipeline. Os usos mais comuns incluem padronizar a forma como datas, horários ou unidades são escritos, expandir abreviações, remover conteúdo desnecessário, aplicar um estilo ou tom diferente ou reformatar a transcrição.

Por exemplo, transcrever uma mensagem de voz com a instrução `Write all dates in ISO 8601 format (YYYY-MM-DD)` retorna as duas versões do texto:

```json maxLines=0
{
  "language_code": "eng",
  "language_probability": 0.9912,
  "text": "Hi, this is Jill. Your appointment is confirmed for the twelfth of July twenty twenty-six, and the follow-up is on the third of August.",
  "words": [
    { "text": "Hi,", "start": 0.12, "end": 0.38, "type": "word", "logprob": 0.0 },
    { "text": " ", "start": 0.38, "end": 0.41, "type": "spacing", "logprob": 0.0 },
    { "text": "this", "start": 0.41, "end": 0.55, "type": "word", "logprob": 0.0 },
    ...
  ],
  "transcription_id": "Y2ZX8AxHUzTPCIualYiE",
  "edited_transcript": {
    "kind": "transcript",
    "text": "Hi, this is Jill. Your appointment is confirmed for 2026-07-12, and the follow-up is on 2026-08-03."
  }
}
```

Os campos `text` e `words` sempre descrevem a transcrição original. A versão editada é retornada separadamente em `edited_transcript`.

## Como integrar a edição de transcrições

A edição de transcrições é integrada à API de Speech to Text ao passar o parâmetro `transcript_edit` para o método `convert`. A instrução pode ter até 2.000 caracteres.

```python maxLines=0
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs

load_dotenv()

elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)

with open("voicemail.mp3", "rb") as audio_file:
    transcription = elevenlabs.speech_to_text.convert(
        file=audio_file,
        model_id="scribe_v2",
        # Natural-language instruction applied to the finished transcript.
        transcript_edit="Write all dates in ISO 8601 format (YYYY-MM-DD)",
    )

print("Original:", transcription.text)
print("Edited:", transcription.edited_transcript)
```

```typescript maxLines=0
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";
import { readFile } from "node:fs/promises";

const elevenlabs = new ElevenLabsClient({
  apiKey: process.env.ELEVENLABS_API_KEY,
});

const audioBlob = new Blob([await readFile("voicemail.mp3")], { type: "audio/mp3" });

const transcription = await elevenlabs.speechToText.convert({
  file: audioBlob,
  modelId: "scribe_v2",
  // Natural-language instruction applied to the finished transcript.
  transcriptEdit: "Write all dates in ISO 8601 format (YYYY-MM-DD)",
});

console.log("Original:", transcription.text);
console.log("Edited:", transcription.editedTranscript);
```

A edição de transcrições funciona tanto com solicitações síncronas quanto com solicitações de [webhook](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/webhooks). Para solicitações de webhook, `edited_transcript` é incluído no objeto `transcription` da carga útil do webhook.

O Scribe v2 Realtime oferece suporte às mesmas instruções em cada transcrição confirmada. Consulte o [guia de edição de transcrições em tempo real](/docs/pt/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing).

## Como escrever instruções

A instrução é aplicada à transcrição inteira sempre que for relevante, e todas as ocorrências correspondentes são editadas, não apenas a primeira. Uma instrução pode alterar palavras ou frases específicas e deixar todo o resto intacto, ou pode reescrever ou anotar o texto completo. Uma única instrução pode combinar várias edições.

Os exemplos a seguir ilustram a variedade de instruções compatíveis:

| Instrução                                                                                               | Efeito                                                                                    |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `Write all dates in ISO 8601 format (YYYY-MM-DD)`                                                       | `the twelfth of July twenty twenty-six` torna-se `2026-07-12`                             |
| `Write times in 24-hour format`                                                                         | `half past two in the afternoon` torna-se `14:30`                                         |
| `Expand abbreviations such as "ETA" and "ASAP" on first use`                                            | `ETA` torna-se `estimated time of arrival (ETA)`                                          |
| `Add the sentiment of every sentence in brackets at the end. Choose from [positive, negative, neutral]` | `Thanks, that was really helpful.` torna-se `Thanks, that was really helpful. [positive]` |
| `Redact every curse word with its first letter followed by stars, e.g. s***`                            | `That was a damn good call.` torna-se `That was a d*** good call.`                        |
| `Format the transcript as a bulleted list, one sentence per bullet`                                     | Reformata toda a transcrição                                                              |

> **Note**
>
> Alguns ajustes têm parâmetros específicos que são mais baratos e previsíveis do que uma instrução
> de edição. Use [keyterm prompting](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) para favorecer o
> reconhecimento de nomes e termos específicos, `no_verbatim` para remover palavras de preenchimento e
> disfluências, e `numbers_format` (quando compatível) para escolher entre dígitos e palavras. Reserve a
> edição de transcrições para alterações que essas opções não abrangem.

Lembre-se do seguinte ao escrever instruções:

* Seja explícito sobre o resultado desejado. `Write all dates in ISO 8601 format (YYYY-MM-DD)` é mais confiável do que `fix the dates`.
* A instrução pode ser escrita em qualquer idioma, embora as instruções em inglês funcionem melhor. A transcrição editada permanece no idioma do original.
* Apenas a instrução é executada. O conteúdo falado no áudio é tratado como dados e não pode alterar a forma como a instrução é aplicada.
* Se nada na transcrição for afetado pela instrução, a transcrição editada será idêntica à original.

## Formato da resposta

Quando `transcript_edit` é definido, a resposta contém um objeto `edited_transcript`. O campo `kind` indica se a edição foi bem-sucedida:

| `kind`       | Campos                                  | Descrição                                                                                                     |
| ------------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `transcript` | `text`                                  | A transcrição editada. Idêntica ao `text` original quando nenhuma edição foi feita.                           |
| `error`      | `error_type` (`edit_failed`), `message` | Não foi possível produzir a edição. A transcrição em si foi concluída, e o `text` original ainda é retornado. |

O campo não está presente quando nenhum `transcript_edit` foi solicitado.

**`Edição com falha`**

```json title="Edição com falha"
{
  "text": "Hi, this is Jill. Your appointment is confirmed for ...",
  "edited_transcript": {
    "kind": "error",
    "error_type": "edit_failed",
    "message": "The transcript could not be edited. Please try again."
  }
}
```

Comportamentos importantes:

* A transcrição editada é texto simples. Os timestamps no nível das palavras, os rótulos de falante e `additional_formats` continuam descrevendo a transcrição original.
* A edição é executada após a conclusão da transcrição, portanto adiciona latência que aumenta conforme o tamanho da transcrição.
* A cobrança adicional é aplicada à duração do áudio da solicitação, com um mínimo de 10 segundos cobrados por solicitação.

> **Warning**
>
> A edição de transcrições não pode ser combinada com `entity_detection`, `entity_redaction` ou
> `use_multi_channel`. As solicitações que os combinam são rejeitadas com um erro de parâmetros inválidos.

## Próximas etapas

#### [Referência da API](/docs/pt/api-reference/speech-to-text)

Referência e parâmetros completos da API de Speech to Text.

#### [Webhooks](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/webhooks)

Receba transcrições, incluindo a transcrição editada, de forma assíncrona por webhooks.