오디오 전사(Audio Transcription) - 퀵스타트

Cohere Transcribe 모델로 오디오를 전사(transcribe)하는 퀵스타트 가이드예요.

출처: 문서

본문

Audio Transcriptions API란

Audio Transcriptions API는 업로드된 오디오 파일을 위한 전용 음성-텍스트(speech-to-text) 엔드포인트를 제공해요. 다음 특징을 갖고 있어요:

낮은 WER(word error rate)을 가진 우수한 오디오 전사 성능
간단한 multipart 업로드 흐름
다국어 지원

사전 준비

무료 트라이얼 키를 TRIAL_KEY 환경 변수로 저장해 두세요

오디오 파일 준비하기

Audio Transcriptions 엔드포인트는 25MB 이하의 FLAC, MP3, MPEG, MPGA, OGG, WAV 파일을 받아들여요. 이 퀵스타트에서는 다음 WAV 예제를 사용할 거예요.

이미 오디오 파일이 없다면, 예제를 다운로드해서 따라 해 보세요.

오디오 파일 전달하기

다음 코드로 오디오 파일을 Audio Transcription 엔드포인트에 전달해요.

curl

curl -X POST "https://api.cohere.com/v2/audio/transcriptions" \
  -H "Authorization: Bearer ***" \
  -F "model=cohere-transcribe-03-2026" \
  -F "language=en" \
  -F "file=@./transcribe-model-sample-derrida-mashup.wav" \

Cohere Transcribe Arabic을 사용하는 경우 다음 스니펫을 사용해요. 참고: 이 퀵스타트의 샘플 오디오는 영어이므로 language가 en으로 설정되어 있어요. 오디오 파일의 주요 언어가 아랍어라면 language를 ar로 설정하는 걸 잊지 마세요.

curl -X POST "https://api.cohere.com/v2/audio/transcriptions" \
  -H "Authorization: Bearer ***" \
  -F "model=cohere-transcribe-arabic-07-2026" \
  -F "language=en" \
  -F "file=@./transcribe-model-sample-derrida-mashup.wav" \

Python

최신 Cohere SDK를 설치해요.

pip -U install cohere

ClientV2 클래스를 import하고 인스턴스화한 다음, 그 create 메서드를 사용해서 오디오 파일을 전달해요.

from cohere import ClientV2
import os

api_key = os.environ["TRIAL_KEY"]
client = ClientV2(api_key)

with open("transcribe-model-sample-derrida-mashup.wav", "rb") as f:
    response = client.audio.transcriptions.create(
        model="cohere-transcribe-03-2026", language="en", file=f
    )

print(response)

Cohere Transcribe Arabic을 사용하는 경우 이 단계는 다음과 같아져요. 참고: 이 퀵스타트의 샘플 오디오는 영어이므로 language가 en으로 설정되어 있어요. 오디오 파일의 주요 언어가 아랍어라면 language를 ar로 설정하는 걸 잊지 마세요.

from cohere import ClientV2
import os

api_key = os.environ["TRIAL_KEY"]
client = ClientV2(api_key)

with open("transcribe-model-sample-derrida-mashup.wav", "rb") as f:
    response = client.audio.transcriptions.create(
        model="cohere-transcribe-arabic-07-2026",
        language="en",
        file=f,
    )

print(response)

응답 받기

다음과 비슷한 응답이 반환될 거예요.

curl

{"text":"I speak only one language, and it's not my own, but the poet is a man of metaphor."}

Python

text="I speak only one language, and it's not my own, but the poet is a man of metaphor."

더 알아보기 (Learn more)

Cohere 문서

오디오 전사(Audio Transcription) - 퀵스타트