Gemini 3.5 Transcribe
음성 인식, 언어 감지, 화자 분리, 단어 타임스탬프를 위한 Google 모델입니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Gemini 3.5 Transcribe는 오디오 파일을 텍스트로 변환합니다. 전사 외에도 언어 감지, 화자 구분, 개별 단어의 타임스탬프, 전문 용어 사전, 지능형 텍스트 정리를 지원합니다.
언어와 길이
러시아어를 포함한 85개가 넘는 언어와 녹음 안에서의 언어 전환을 지원합니다. 언어는 자동으로 감지됩니다. 일반 요청은 최대 1시간 길이의 오디오를 처리합니다. 화자 분리 또는 단어 타임스탬프를 활성화하면 제한이 30분으로 줄어듭니다.
출력에는 전체 전사문과 해당 모드에서의 개별 단어 주석이 포함됩니다. 모델은 파일 처리를 위한 것입니다. 연속적인 실시간 인식은 별도 버전 gemini-3.5-transcribe-live에 해당합니다.
전사 모드
기본값은 말한 그대로 옮기는 전사입니다. 지능형 모드는 간투사를 제거하고, 화자의 자기 수정을 반영하며, 텍스트 형식을 정리합니다. 이 모드는 화자 분리와 단어 타임스탬프를 함께 사용할 수 없습니다.
음성 분리는 최대 8명의 화자를 지원합니다. 화자가 3명 이상일 때 누가 발화했는지를 판단하는 기능은 실험적 상태입니다. 타임스탬프는 텍스트를 녹음과 연결하는 데 도움이 되지만, 활성화하면 인식 정확도가 낮아질 수 있습니다.
용어와 파일
사용자 정의 용어 사전은 최대 1 000개 항목을 수용합니다. Google은 일반적으로 약 백 개 정도로 제한하는 것이 좋다고 설명합니다. 이 사전은 화자 분리 및 단어 타임스탬프와 호환되지 않습니다. 따라서 전문 용어가 중요한지, 참여자와 시간의 상세 표기가 중요한지에 따라 모드를 선택해야 합니다.
지원 오디오 형식에는 WAV, MP3, AIFF, AAC, OGG, FLAC, MPEG, M4A, L16, Opus, A-law, mu-law, WebM이 있습니다. 파일 처리에는 길이 제한과 모드 조합이 공개되어 있습니다. Transcribe 제품군 설명에는 96K토큰의 컨텍스트와 32K토큰의 텍스트 출력도 명시되어 있습니다. 이러한 제품군 특성이 선택한 호출 방식의 파일 제한을 대체하지는 않습니다.
컨텍스트 캐싱, 코드 실행, 파일 검색, 함수 호출, 이미지 생성, Thinking은 지원하지 않습니다. 이 모델은 새로운 음성을 생성하는 것이 아니라 소리에서 텍스트와 주석을 얻는 데 특화되어 있습니다.
Ailoot · 음성 텍스트 변환 POST /v1/audio/transcriptions gemini-3.5-transcribe
gemini-3.5-transcribe시작하기
음성 인식, 언어 감지, 화자 분리, 단어 타임스탬프를 위한 Google 모델입니다.
- 허용 입력
- 오디오
- 결과
- 텍스트
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot · 음성 텍스트 변환 POST /v1/audio/transcriptions
- 입력
audio- 출력
text- 출력 형식
- json
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 gemini-3.5-transcribe | 기본값— |
필드file | 유형file | 요건필수 | 값과 한도 최대 바이트 수: 67,108,864 파일 형식: wav, mp3, m4a, ogg, webm, flac 콘텐츠 유형: multipart/form-data 최대 길이(초): 600 | 기본값— |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 json | 기본값— |
입력 자료 조합
speech_to_text · 필수: actual audio file
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수material_types | 명세audio |
매개변수required | 명세null |
매개변수optional_controls | 명세null |
수명 주기: 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}
메서드 형식과 ID는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다.
요금
Ailoot 메서드 요금
POST /v1/audio/transcriptions- 입력
- US$0.01 분당(분 미만의 나머지도 한 분으로 계산)
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot · 음성 텍스트 변환
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set your actual MP3 recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import os
from pathlib import Path
f=Path(os.environ["AILOOT_AUDIO_FILE"])
if not f.is_file() or f.suffix.lower()!=".mp3":raise SystemExit("Choose your actual MP3 recording")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--form-string model=gemini-3.5-transcribe -F "file=@$AILOOT_AUDIO_FILE" \
-D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
PY_RESULT
결과 수신 및 저장
Ailoot · 음성 텍스트 변환
json
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
텍스트만이 아니라 JSON 전체를 보존하세요. 사용 가능한 모든 구간/화자/타임스탬프와 실제 작업/자산 식별자를 유지하세요.
원래 응답을 확인해야 할 경우
다시 제출하지 말고 정산 대조를 위해 최초 operation_id/X-Client-Request-ID를 보관하세요. 전용 오디오 폴링 라우트는 없습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드text | 유형string |
필드segments[] | 유형object |
필드task_id | 유형string |
필드asset_url | 유형string |
필드usage | 유형object |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
응답server_error | 조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다 | 다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot gemini-3.5-transcribe
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Gemini 3.5 Transcribe
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/transcriptions·gemini-3.5-transcribe:audio→text- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/transcriptions·gemini-3.5-transcribe:model,file,response_format