Mistral: Voxtral Mini Transcribe
Voxtral Mini Transcribe 2는 화자 분리, 단어별 타임스탬프, 어휘 바이어싱과 함께 녹음을 텍스트로 변환합니다. Mistral은 Voxtral Realtime과 구분되는 이 전사 중심 버전에 대해 13개 언어와 최대 3시간의 녹음을 문서화합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Voxtral Mini Transcribe 2는 제조사 모델 카드에서 voxtral-mini-2602로 식별되는 Mistral AI의 전사 중심 Voxtral 버전입니다. 최초 Voxtral Mini 3B 모델의 폭넓은 질의응답 역할이 아니라 녹음 기반 배치 전사를 위해 설계되었습니다. 입력은 오디오이며 결과는 전사된 텍스트로, 선택적으로 화자 레이블과 시간 정보를 추가할 수 있습니다. 실용적인 용도에는 회의 전사, 인터뷰 분석, 여러 사람이 참여한 통화 기록, 녹화 미디어에 정렬된 텍스트가 포함됩니다.
제조사는 전사문에서 누가 언제 말했는지 표시할 수 있도록 화자 분리와 시작·종료 시간을 문서화합니다. 단어별 타임스탬프는 자막, 오디오 검색, 텍스트 구절과 녹음 위치 사이의 정렬을 지원합니다. 제조사 가이드는 구간 또는 단어 단위 타임스탬프를 허용합니다. 인터뷰에는 시간이 포함된 화자별 구절의 연속이 유용한 산출물이 됩니다. 자막 준비에서는 일반 전사문에서 시간을 추정하도록 하는 대신 단어 또는 구간 시간이 이후 자막 제작 단계를 안내할 수 있습니다.
컨텍스트 바이어싱은 이름, 기술 용어, 도메인별 어휘를 의도한 철자로 인식하도록 최대 100개의 단어 또는 구절을 받습니다. Mistral은 이 기능이 영어에 최적화되어 있으며 다른 언어 지원은 실험적이라고 설명합니다. 무관한 용어집 대신 녹음 주제에 집중한 어휘 목록을 준비하세요. 예를 들어 기술 논의에 나올 가능성이 높은 프로젝트 이름과 전문 용어를 제공하고 완성된 전사문에서 철자를 확인할 수 있습니다.
이 버전은 영어, 중국어, 힌디어, 스페인어, 아랍어, 프랑스어, 포르투갈어, 러시아어, 독일어, 일본어, 한국어, 이탈리아어, 네덜란드어의 13개 언어를 지원합니다. 제조사는 잡음에 대한 견고성과 단일 요청에서 최대 3시간의 녹음도 문서화합니다. 이는 Mini Transcribe 2의 녹음 워크플로에 속하며 최초 2507 오디오 이해 모델의 컨텍스트와 길이 설명은 다른 릴리스를 다룹니다. 자동 언어 감지를 사용할 수 있고 가이드는 알려진 오디오 언어를 명시적으로 제공하면 전사 정확도가 향상될 수 있다고 설명합니다.
문서화된 제조사 워크플로에서는 오디오를 업로드된 파일, 이전에 업로드한 파일의 식별자, 참조된 녹음으로 제공할 수 있습니다. 함께 제공되는 업로드 시연은 MP3, WAV, M4A, FLAC, OGG 녹음을 받습니다. 시연된 업로드 워크플로에는 이 중 하나를 선택하세요. 녹음을 디코딩할 수 있는 상태로 유지하고 관련 음성을 포함하세요. 긴 자료에서는 이후 발췌나 편집도 원본으로 추적할 수 있도록 식별자와 시간 기준점을 유지하세요.
전사 참조 문서는 텍스트와 감지된 언어, 요청 시 구간을 반환하며 스트리밍 전사 이벤트도 별도로 문서화합니다. 화자 분리는 선택 사항이고 기본값은 false입니다. 가이드는 현재 timestamp_granularities와 명시적인 language 설정이 호환되지 않는다고 설명합니다. 둘을 결합하는 대신 원하는 시간 정보 워크플로나 수동 언어 힌트를 선택하세요. 화자 레이블 전사, 어휘 바이어싱, 시간 정보는 기본 요청에서 당연히 제공된다고 가정하지 말고 의도한 결과에 따라 선택해야 합니다.
겹쳐 말하기는 실질적인 한계입니다. Mistral은 화자들의 발화가 겹칠 때 모델이 일반적으로 한 화자만 전사한다고 설명합니다. 따라서 화자 레이블이 있는 전사문을 동시에 이루어진 모든 발화의 완전한 기록으로 취급해서는 안 됩니다. 회의 기록에서는 어려운 겹침 구간과 중요한 이름 또는 수치를 녹음과 대조하세요. 모델의 목적은 전사이며 요약, 번역, 분석은 전사문을 바탕으로 별도 작업으로 수행할 수 있습니다. Voxtral Realtime은 실시간 전사 지연 시간 특성이 별도로 있고 음성 생성은 다른 모델에 속합니다.
결과를 다음 용도에 맞게 준비하세요. 회의 워크플로에서는 별도 단계에서 결정을 추출하기 전에 전사문, 화자 레이블, 시간을 보존할 수 있습니다. 미디어 워크플로는 시간 정보를 사용해 구절을 찾고 자막 초안을 작성할 수 있습니다. 전문 용어가 많은 녹음에는 집중된 컨텍스트 바이어싱 목록과 결과 철자 검토를 포함할 수 있습니다. 유용한 산출물은 원본 녹음과 설정된 메타데이터에 연결된 텍스트이며 이 번호가 붙은 전사 버전을 최초 Mini 모델 및 계속 바뀌는 latest 이름과 구분해 유지해야 합니다.
Ailoot Ultra · 음성 전사 POST /v1/audio/transcriptions mistralai/voxtral-mini-transcribe
mistralai/voxtral-mini-transcribe
mistralai/voxtral-mini-transcribe시작하기
Voxtral Mini Transcribe 2는 화자 분리, 단어별 타임스탬프, 어휘 바이어싱과 함께 녹음을 텍스트로 변환합니다. Mistral은 Voxtral Realtime과 구분되는 이 전사 중심 버전에 대해 13개 언어와 최대 3시간의 녹음을 문서화합니다.
- 허용 입력
- 오디오
- 결과
- 텍스트
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 전사 POST /v1/audio/transcriptions
- 입력
audio- 출력
text
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 mistralai/voxtral-mini-transcribe | 기본값— |
필드input_audio | 유형object | 요건필수 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, input_audio |
매개변수material_types | 명세audio |
매개변수material_conditions | 명세이 예제는 비어 있지 않은 실제 PCM WAV 파일을 읽고, 파일의 전체 바이트를 base64로 인코딩한 다음 input_audio.format을 wav로 전송합니다. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 기존 소유 미디어 기록의 정확한 task_id
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 오디오(초) | 요금표— | 과금 단위입력 오디오 초당 | 요금 입력 · 입력 오디오(초) $0.0001 입력 오디오 초당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 음성 전사
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import base64, io, json, os, wave
from pathlib import Path
audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()
if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):
raise SystemExit('Supply your actual PCM WAV audio file')
with wave.open(io.BytesIO(audio), 'rb') as recording:
if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:
raise SystemExit('Supply a nonempty PCM WAV recording')
request = {'model': 'mistralai/voxtral-mini-transcribe', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}
Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete original response, headers and actual X-Client-Request-ID.
# Read existing owned records for recovery; do not resubmit an uncertain operation.
결과 수신 및 저장
Ailoot Ultra · 음성 전사
원본 응답 본문 전체, 상태 및 전달된 헤더입니다. 이 핸들러는 공통 JSON 구조, 텍스트 필드 또는 작업 바깥 구조를 추가하지 않습니다.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
실제 X-Client-Request-ID와 응답 전체를 보존하세요. 원래 소유 자산과 해당 자산의 정확한 서명된 콘텐츠 URL을 조회하세요. 생성 여부가 불확실한 요청을 절대로 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 |
|---|---|
필드text (when present) | 유형 |
필드usage (when present) | 유형 |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건JSON 본문 또는 명시적인 표준 모델 ID가 유효하지 않습니다. | 다음 단계응답을 보존하고 표시된 요청 필드를 수정하세요. |
응답401 · authentication_error | 조건Ailoot API 키가 유효하지 않습니다. | 다음 단계사용 권한이 있는 Ailoot API 키를 사용하세요. |
응답403 · permission_error | 조건이 키 그룹은 해당 메서드를 허용하지 않습니다. | 다음 단계반환된 오류 세부 정보를 보존하세요. |
응답404 · not_found_error | 조건선택한 메서드에는 허용된 경로가 없습니다. | 다음 단계반환된 오류 세부 정보를 보존하세요. |
응답422 · price_unavailable | 조건승인된 요금제에서 필요한 입력 수량 또는 상한을 확보할 수 없습니다. | 다음 단계응답을 보존하세요. 승인된 요금제에서 요구하는 입력 표현 형식을 사용하세요. |
응답503 · | 조건필요한 저장소, 경로, 메서드 요금 또는 예약을 사용할 수 없습니다. | 다음 단계원본 응답 전체를 보존하세요. 예약 여부가 불확실하다고 해서 다시 제출할 수 있는 것은 아닙니다. |
응답502 · server_error | 조건원래 결과, 사용량 또는 정산을 확인해야 합니다. | 다음 단계실제 요청 ID와 원본 응답을 보존하세요. 기존 소유 기록을 조회하고 생성을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot Ultra mistralai/voxtral-mini-transcribe
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Mistral: Voxtral Mini Transcribe
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/transcriptions·mistralai/voxtral-mini-transcribe:audio→text- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/transcriptions·mistralai/voxtral-mini-transcribe:model,input_audio