숫자 및 언어 옵션

개요

Scribe v3는 배치 텍스트 음성 변환 API에 두 가지 선택적 파라미터를 추가합니다.

• numbers_format은 전사문의 숫자를 숫자(42) 또는 단어(forty-two)로 작성할지 설정합니다.
• secondary_language_codes는 language_code와 함께 오디오에서 사용될 수 있는 다른 언어를 나열합니다. 화자가 여러 언어를 전환하는 오디오의 정확도를 높여 줍니다.

두 파라미터는 모두 scribe_v3에서만 지원됩니다. 다른 모델과 함께 둘 중 하나를 전송하면 invalid_parameters 오류가 반환됩니다.

숫자 형식 지정

numbers_format을 digits 또는 words로 설정하세요. 파라미터를 생략하면 모델이 형식을 선택합니다.

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은 모델이 숫자를 전사하는 방식을 제어합니다. 날짜, 시간 또는 단위의 표기 방식을 추가로 변경하려면 전사문 편집을 사용하세요.

보조 언어 지정

language_code는 오디오의 기본 언어로, secondary_language_codes는 예상되는 다른 언어로 설정하세요. 둘 다 ISO-639-1 또는 ISO-639-3 코드를 허용합니다.

secondary_language_codes는 목록입니다. 언어마다 양식 필드를 한 번씩 반복하세요. 단일 문자열로 전송한 JSON 배열은 허용되지 않습니다.

다음 예시는 스페인어와 프랑스어도 포함된 영어 오디오를 전사합니다.

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는 음성이 발화된 언어로 전사합니다. 기본 언어와 보조 언어 간 번역은 수행하지 않습니다.

다른 파라미터와 함께 사용

두 파라미터는 keyterms, diarize, no_verbatim 등의 다른 배치 파라미터와 함께 사용할 수 있습니다. 특정 용어에 맞춰 전사 결과를 유도하는 방법은 키텀 프롬프팅을 참조하세요.

다음 단계