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

# Modification de transcriptions

> **Note**
>
> **Guide pratique** · Suppose que vous avez suivi le [guide de démarrage rapide de Speech to Text ](/docs/fr/eleven-api/guides/cookbooks/speech-to-text).

## Vue d’ensemble

> **Warning**
>
> La modification de transcriptions est une fonctionnalité expérimentale qui entraîne un coût supplémentaire de 30 % par rapport au
> coût de base de la transcription. La facturation porte sur un minimum de 10 secondes d’audio par requête. Consultez la [page des tarifs de l’API ](https://elevenlabs.io/pricing?price.section=speech_to_text\&price.sections=speech_to_text,speech_to_text#pricing-table)
> pour obtenir des informations détaillées sur les tarifs.

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 utilisations courantes comprennent la normalisation de l’écriture des dates, heures ou unités, le développement d’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, transcrire un message vocal avec l’instruction `Write all dates in ISO 8601 format (YYYY-MM-DD)` renvoie les deux versions du texte :

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

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.

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

La modification de transcriptions fonctionne avec les requêtes synchrones comme avec les requêtes [webhook](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/webhooks). Pour les requêtes webhook, `edited_transcript` est inclus dans l’objet `transcription` de la charge utile du webhook.

Scribe v2 Realtime prend en charge les mêmes instructions pour chaque transcription validée. Consultez le [guide de modification de transcription en temps réel](/docs/fr/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing).

## Rédiger des instructions

L’instruction est appliquée à 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 précis et laisser tout le reste intact, ou réécrire ou annoter l’intégralité du texte. Une seule instruction peut combiner plusieurs modifications.

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

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

> **Note**
>
> Certains ajustements disposent de paramètres dédiés, moins coûteux et plus prévisibles qu’une instruction de
> modification. Utilisez le [prompting de termes clés ](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) pour orienter la
> reconnaissance vers des noms et termes précis, `no_verbatim` pour supprimer les mots de remplissage et les
> disfluences, et `numbers_format` (lorsqu’il est pris en charge) pour choisir entre chiffres et mots. Réservez la
> modification de transcriptions aux changements que ces options ne couvrent pas.

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

* Soyez explicite sur 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, bien que 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 prononcé dans l’audio est traité comme des données et ne peut pas modifier la manière dont l’instruction est appliquée.
* Si aucun élément de la transcription n’est concerné par l’instruction, 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 :

| `kind`       | Champs                                  | Description                                                                                                                     |
| ------------ | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `transcript` | `text`                                  | La transcription modifiée. Identique au champ `text` original lorsqu’aucune modification n’a été effectuée.                     |
| `error`      | `error_type` (`edit_failed`), `message` | La modification n’a pas pu être produite. La transcription elle-même a réussi et le champ `text` original est toujours renvoyé. |

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

**`Modification échouée`**

```json title="Modification échouée"
{
  "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 du 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 après la transcription, elle ajoute donc une latence qui augmente avec la longueur de la transcription.
* Le supplément est appliqué à la durée audio de la requête, avec un minimum de 10 secondes facturées par requête.

> **Warning**
>
> La modification de transcriptions ne peut pas être combinée avec `entity_detection`, `entity_redaction` ou
> `use_multi_channel`. Les requêtes qui les combinent sont rejetées avec une erreur de paramètres non valides.

## Étapes suivantes

#### [Guide de l’API](/docs/fr/api-reference/speech-to-text)

Guide complet de l’API Speech to Text et de ses paramètres.

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

Recevez les transcriptions, y compris la transcription modifiée, de manière asynchrone via des webhooks.