> 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.

# Transcript bewerken

> **Note**
>
> **Handleiding** · Hierbij wordt ervan uitgegaan dat je de [Speech to Text- quickstart](/docs/nl/eleven-api/guides/cookbooks/speech-to-text) hebt voltooid.

## Overzicht

> **Warning**
>
> Transcriptbewerking is een experimentele functie en brengt 30% extra kosten boven op de
> basiskosten voor transcriptie met zich mee. Per request wordt minimaal 10 seconden audio in rekening gebracht. Bekijk de [pagina met API- prijzen](https://elevenlabs.io/pricing?price.section=speech_to_text\&price.sections=speech_to_text,speech_to_text#pricing-table)
> voor gedetailleerde prijsinformatie.

Met transcriptbewerking kun je een instructie in natuurlijke taal toevoegen aan een transcriptierequest. Zodra de audio is getranscribeerd, wordt je instructie op het transcript toegepast en wordt de bewerkte tekst naast het origineel geretourneerd.

Hiermee vervang je een aparte nabewerkingsstap in je eigen pipeline. Typische toepassingen zijn het normaliseren van de schrijfwijze van datums, tijden of eenheden, het uitschrijven van afkortingen, het verwijderen van content die je niet nodig hebt, het toepassen van een andere stijl of toon, of het herformatteren van het transcript.

Als je bijvoorbeeld een voicemail transcribeert met de instructie `Write all dates in ISO 8601 format (YYYY-MM-DD)`, krijg je beide versies van de tekst terug:

```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."
  }
}
```

De velden `text` en `words` beschrijven altijd het originele transcript. De bewerkte versie wordt apart geretourneerd in `edited_transcript`.

## Transcriptbewerking integreren

Transcriptbewerking is geïntegreerd in de Speech to Text API door de parameter `transcript_edit` door te geven aan de methode `convert`. De instructie mag maximaal 2000 tekens lang zijn.

```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);
```

Transcriptbewerking werkt met zowel synchrone requests als [webhook](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/webhooks)-requests. Bij webhook-requests wordt `edited_transcript` opgenomen in het object `transcription` van de webhook-payload.

Scribe v2 Realtime ondersteunt dezelfde instructies voor elk vastgelegd transcript. Bekijk de [handleiding voor realtime transcriptbewerking](/docs/nl/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing).

## Instructies schrijven

De instructie wordt op het hele transcript toegepast waar deze relevant is, en elke overeenkomende instantie wordt bewerkt, niet alleen de eerste. Een instructie kan specifieke woorden of zinnen wijzigen en de rest ongewijzigd laten, of de volledige tekst herschrijven of annoteren. Eén instructie kan meerdere bewerkingen combineren.

De volgende voorbeelden illustreren het bereik van ondersteunde instructies:

| Instructie                                                                                              | Effect                                                                                 |
| ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `Write all dates in ISO 8601 format (YYYY-MM-DD)`                                                       | `the twelfth of July twenty twenty-six` wordt `2026-07-12`                             |
| `Write times in 24-hour format`                                                                         | `half past two in the afternoon` wordt `14:30`                                         |
| `Expand abbreviations such as "ETA" and "ASAP" on first use`                                            | `ETA` wordt `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.` wordt `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.` wordt `That was a d*** good call.`                        |
| `Format the transcript as a bulleted list, one sentence per bullet`                                     | Herformatteert het hele transcript                                                     |

> **Note**
>
> Sommige aanpassingen hebben speciale parameters die goedkoper en voorspelbaarder zijn dan een bewerkings-
> instructie. Gebruik [keyterm- prompting](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) om de
> herkenning te sturen naar specifieke namen en termen, `no_verbatim` om stopwoorden en
> haperingen te verwijderen, en `numbers_format` (waar ondersteund) om te kiezen tussen cijfers en woorden. Gebruik
> transcriptbewerking alleen voor wijzigingen die deze opties niet ondersteunen.

Houd bij het schrijven van instructies rekening met het volgende:

* Wees expliciet over de gewenste uitvoer. `Write all dates in ISO 8601 format (YYYY-MM-DD)` is betrouwbaarder dan `fix the dates`.
* De instructie mag in elke taal worden geschreven, al werken instructies in het Engels het beste. Het bewerkte transcript blijft in de taal van het origineel.
* Alleen de instructie wordt uitgevoerd. Content die in de audio wordt uitgesproken, wordt als data behandeld en kan niet veranderen hoe de instructie wordt toegepast.
* Als niets in het transcript door de instructie wordt beïnvloed, is het bewerkte transcript identiek aan het origineel.

## Responseformaat

Wanneer `transcript_edit` is ingesteld, bevat de response een object `edited_transcript`. Het veld `kind` geeft aan of de bewerking is gelukt:

| `kind`       | Velden                                  | Beschrijving                                                                                                                      |
| ------------ | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `transcript` | `text`                                  | Het bewerkte transcript. Identiek aan de oorspronkelijke `text` als er geen bewerkingen zijn uitgevoerd.                          |
| `error`      | `error_type` (`edit_failed`), `message` | De bewerking kon niet worden gemaakt. De transcriptie zelf is gelukt en de oorspronkelijke `text` wordt nog steeds geretourneerd. |

Het veld ontbreekt wanneer er geen `transcript_edit` is aangevraagd.

**`Mislukte bewerking`**

```json title="Mislukte bewerking"
{
  "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."
  }
}
```

Gedrag om rekening mee te houden:

* Het bewerkte transcript is platte tekst. Tijdstempels op woordniveau, sprekerlabels en `additional_formats` blijven het originele transcript beschrijven.
* De bewerking wordt uitgevoerd nadat de transcriptie is voltooid, dus deze voegt latency toe die toeneemt met de lengte van het transcript.
* De toeslag wordt toegepast op de audioduur van de request, waarbij per request minimaal 10 seconden in rekening worden gebracht.

> **Warning**
>
> Transcriptbewerking kan niet worden gecombineerd met `entity_detection`, `entity_redaction` of
> `use_multi_channel`. Requests die deze combineren, worden afgewezen met een foutmelding over ongeldige parameters.

## Volgende stappen

#### [API-referentie](/docs/nl/api-reference/speech-to-text)

Volledige Speech to Text API-referentie en parameters.

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

Ontvang transcripties, inclusief het bewerkte transcript, asynchroon via webhooks.