Transcript bewerken

Overzicht

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:

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

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 object transcription van de webhook-payload.

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

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:

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:

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

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.

Volgende stappen