Opties voor getallen en talen

Overzicht

Scribe v3 voegt twee optionele parameters toe aan de batch Speech to Text API:

• numbers_format bepaalt of getallen in het transcript als cijfers (42) of als woorden (forty-two) worden geschreven.
• secondary_language_codes geeft andere talen weer die naast language_code in de audio kunnen worden gesproken. Dit verbetert de nauwkeurigheid voor audio waarin sprekers tussen talen wisselen.

Beide parameters worden alleen ondersteund door scribe_v3. Als je een van beide met een ander model verstuurt, wordt de fout invalid_parameters geretourneerd.

Getallen opmaken

Stel numbers_format in op digits of words. Wanneer de parameter wordt weggelaten, kiest het model de notatie.

import os
from io import BytesIO
import requests
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio_url = "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
audio_data = BytesIO(requests.get(audio_url).content)
transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    request_options={
        "additional_body_parameters": {
            "numbers_format": "digits",
        },
    },
)
print(transcription.text)

numbers_format bepaalt hoe het model getallen transcribeert. Gebruik transcriptbewerking voor andere wijzigingen in de schrijfwijze van datums, tijden of eenheden.

Secundaire talen opgeven

Stel language_code in op de hoofdtaal van de audio en secondary_language_codes op de andere talen die je verwacht. Beide accepteren ISO-639-1- of ISO-639-3-codes.

secondary_language_codes is een lijst. Herhaal het formulierveld eenmaal per taal. Een JSON-array die als één tekenreeks wordt verstuurd, wordt niet geaccepteerd.

In het volgende voorbeeld wordt Engelse audio getranscribeerd die ook Spaans en Frans bevat:

transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    language_code="en",
    request_options={
        "additional_body_parameters": {
            "secondary_language_codes": ["es", "fr"],
        },
    },
)

Scribe v3 transcribeert spraak in de taal waarin deze wordt gesproken. Het vertaalt niet tussen de hoofd- en secundaire talen.

Combineren met andere parameters

Beide parameters kunnen samen en met andere batchparameters worden gebruikt, zoals keyterms, diarize en no_verbatim. Bekijk keyterm prompting om transcriptie te sturen naar specifieke termen.

Volgende stappen