Transcriptbewerking

Overzicht

Met transcriptbewerking kun je een instructie in natuurlijke taal aan een transcriptierequest toevoegen. Nadat de audio is getranscribeerd, passen we je instructie toe op het transcript en retourneren we de bewerkte tekst naast het origineel.

Hiermee vervang je een afzonderlijke nabewerkingsstap in je eigen pipeline. Veelvoorkomende 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), worden beide versies van de tekst geretourneerd:

{
  "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 oorspronkelijke transcript. De bewerkte versie wordt afzonderlijk 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.

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)

Transcriptbewerking werkt met zowel synchrone requests als webhook-requests. Bij webhook-requests wordt edited_transcript opgenomen in het transcription-object van de webhook-payload.

Scribe v2 Realtime ondersteunt dezelfde instructies voor elk bevestigd transcript. Bekijk de handleiding voor realtime transcriptbewerking.

Instructies schrijven

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

De volgende voorbeelden laten zien welke instructies worden ondersteund:

Houd rekening met het volgende bij het schrijven van instructies:

• Wees expliciet over de gewenste uitvoer. Write all dates in ISO 8601 format (YYYY-MM-DD) is betrouwbaarder dan fix the dates.
• De instructie kan 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.

Responseformat

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

Het veld ontbreekt wanneer er geen transcript_edit is aangevraagd.

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

Let op het volgende gedrag:

• Het bewerkte transcript is platte tekst. Timestamps op woordniveau, sprekerlabels en additional_formats blijven het oorspronkelijke transcript beschrijven.
• De bewerking wordt uitgevoerd nadat de transcriptie is voltooid en voegt dus latency toe die toeneemt met de lengte van het transcript.
• De toeslag wordt toegepast op de audioduur van de request, met een minimum van 10 seconden per request.

Volgende stappen