Modification de transcriptions

Vue d’ensemble

La modification de transcriptions vous permet d’ajouter une instruction en langage naturel à une requête de transcription. Une fois l’audio transcrit, votre instruction est appliquée à la transcription et le texte modifié est renvoyé avec l’original.

Elle remplace une étape distincte de post-traitement dans votre propre pipeline. Les cas d’usage courants incluent la normalisation de l’écriture des dates, heures ou unités, le développement des abréviations, la suppression de contenu inutile, l’application d’un style ou d’un ton différent, ou le reformatage de la transcription.

Par exemple, la transcription d’un message vocal avec l’instruction Write all dates in ISO 8601 format (YYYY-MM-DD) renvoie les deux versions du texte :

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

Les champs text et words décrivent toujours la transcription originale. La version modifiée est renvoyée séparément dans edited_transcript.

Intégrer la modification de transcriptions

La modification de transcriptions s’intègre à l’API Speech to Text en transmettant le paramètre transcript_edit à la méthode convert. L’instruction peut contenir jusqu’à 2 000 caractères.

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_v3",
        # 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)

La modification de transcriptions fonctionne avec les requêtes synchrones et les requêtes webhook. Pour les requêtes webhook, edited_transcript est inclus dans l’objet transcription de la charge utile du webhook.

Scribe v3 Live et Scribe v2 Realtime prennent en charge les mêmes instructions pour chaque transcription validée. Consultez le guide de modification de transcriptions en temps réel.

Rédiger des instructions

L’instruction s’applique à l’ensemble de la transcription partout où elle est pertinente, et chaque occurrence correspondante est modifiée, pas seulement la première. Une instruction peut modifier des mots ou expressions spécifiques sans toucher au reste, ou réécrire ou annoter le texte complet. Une seule instruction peut combiner plusieurs modifications.

Les exemples suivants illustrent l’éventail des instructions prises en charge :

Gardez les points suivants à l’esprit lors de la rédaction d’instructions :

• Indiquez explicitement le résultat souhaité. Write all dates in ISO 8601 format (YYYY-MM-DD) est plus fiable que fix the dates.
• L’instruction peut être rédigée dans n’importe quelle langue, même si les instructions en anglais donnent les meilleurs résultats. La transcription modifiée reste dans la langue de l’original.
• Seule l’instruction est exécutée. Le contenu énoncé dans l’audio est traité comme des données et ne peut pas modifier l’application de l’instruction.
• Si l’instruction n’affecte aucun élément de la transcription, la transcription modifiée est identique à l’originale.

Format de réponse

Lorsque transcript_edit est défini, la réponse contient un objet edited_transcript. Son champ kind indique si la modification a réussi :

Le champ est absent lorsqu’aucun transcript_edit n’a été demandé.

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

Comportements à connaître :

• La transcription modifiée est en texte brut. Les horodatages au niveau des mots, les étiquettes de locuteurs et additional_formats continuent de décrire la transcription originale.
• La modification s’exécute une fois la transcription terminée. Elle ajoute donc une latence qui augmente avec la longueur de la transcription.
• Le supplément s’applique à la durée audio de la requête, avec un minimum de 10 secondes facturées par requête.

Étapes suivantes