AssemblyAI: Universal-3.5 Pro

Universal-3.5 Pro는 짧은 오디오 클립을 한 번의 응답으로 완성된 전사문으로 변환하는 AssemblyAI의 음성 텍스트 변환 모델입니다. Sync 프로필은 음성 입력과 눌러서 말하기 워크플로를 위해 단어 신뢰도, 선택적 단어 타임스탬프, 어휘 힌트, 이전 대화 컨텍스트를 추가합니다.

Ailoot Ultra · 음성 전사 POST /v1/audio/transcriptions assemblyai/universal-3-5-pro

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Universal-3.5 Pro는 녹음된 음성을 텍스트로 변환하는 AssemblyAI의 음성 인식 모델입니다. Sync 프로필에서는 짧은 오디오 클립으로부터 한 번의 응답으로 완성된 전사문을 생성합니다. 이는 음성 메시지, 눌러서 말하기 입력, 애플리케이션이 녹음 종료 시점을 이미 알고 있는 개별 대화 턴에 적합합니다.

오디오를 범위가 정해진 클립으로 준비하세요. AssemblyAI의 Sync 요구 사항은 80밀리초에서 120초까지의 길이를 허용하며, 최대 파일 크기는 40 MB입니다. 지원 형식은 WAV 또는 부호 있는 16비트 리틀 엔디언 원시 PCM입니다. 오디오는 모노나 스테레오일 수 있으며, 스테레오는 내부적으로 다운믹스됩니다. 지원 샘플 레이트는 8, 16, 22.05, 24, 32, 44.1, 48 kHz입니다. WAV 헤더는 샘플 레이트와 채널 수를 제공하며, 원시 PCM에서는 이 값을 전사 설정에 별도로 제공해야 합니다.

발화 전체를 녹음하고 말의 시작과 끝을 온전히 유지하세요. 유용한 원본 작업 예시는 제품 이름, 주문 식별자, 요청을 담은 짧은 제품 지원 음성 메시지입니다. 중요한 세부 사항을 전사문과 대조할 수 있도록 원본 클립을 보존하세요. 더 긴 녹음에는 장문 전사에 적합한 워크플로를 준비하세요. 짧은 클립의 길이 제한을 모델 전체의 오디오 처리 용량으로 해석해서는 안 됩니다.

결과에는 전체 전사문, 단어별 신뢰도가 있는 단어 목록, 0에서 1 사이의 전체 신뢰도가 포함됩니다. 제출한 오디오의 길이와 요청 식별자도 제공되므로 텍스트를 원본 클립과 연결해 유지할 수 있습니다. 단어 신뢰도를 이용해 청취 검토가 필요한 구절을 찾으세요. 특히 애플리케이션에서 중요한 이름, 숫자, 분야별 어휘를 살펴보세요.

단어 타임스탬프는 선택 사항이며 기본값은 꺼짐입니다. 요청하면 정렬된 각 단어에 클립 시작을 기준으로 한 시작 및 종료 시점이 밀리초 단위로 포함될 수 있습니다. 제작사의 프로필은 단어를 정렬할 수 없을 때 대략적인 시간을 만들어 넣는 대신 해당 값을 비워둡니다. 타임스탬프 정확도는 영어 오디오에서 가장 높습니다. 단어 강조 표시, 검색 가능한 파형, 자막 정렬을 준비할 때 누락된 타이밍을 명시적으로 유지하고, 완성된 자막 트랙으로 사용하기 전에 텍스트를 녹음과 비교하세요.

컨텍스트 프롬프트는 녹음이 무엇에 관한 것인지 설명합니다. 분야, 상황, 애플리케이션이 이미 알고 있는 구체적인 세부 사항을 지정할 수 있으며 최대 길이는 6000자입니다. 특정 기기에 관한 기술 지원 대화처럼 오디오에 맞는 짧은 설명으로 시작하세요. 프롬프트는 인식 컨텍스트를 제공합니다. 화자의 메시지를 다른 문서로 다시 쓰라는 요청은 아닙니다.

별도의 주요 용어 목록은 특정 어휘를 우선적으로 인식하도록 유도합니다. Sync 프로필은 최대 100개 용어와 목록 전체에 걸쳐 8000자를 허용합니다. 드문 이름, 약어, 제품 용어는 정확한 철자를 사용하고, 일반적으로 잘 인식되는 단어는 목록에서 제외하세요. 크거나 불필요한 용어 목록은 과도한 교정을 유발할 수 있으므로 녹음에서 중요한 단어에 집중하세요. 컨텍스트 설명과 어휘 목록은 함께 사용할 수 있습니다.

이전 대화도 짧은 답변을 해석하는 데 도움을 줄 수 있습니다. 이전 발화를 오래된 것부터 최신 순으로 제공하되, 현재 오디오는 전사 대상 턴으로 유지하세요. 문서에 명시된 컨텍스트 허용량은 500턴 또는 총 16,000자입니다. 이 한도나 사용 가능한 모델 컨텍스트를 초과하면 가장 오래된 항목부터 제거됩니다. 짧은 답변에 앞선 질문으로부터 의미가 정해지는 식별자나 지시 표현이 들어 있을 때 유용합니다.

언어 선택은 하나 이상의 예상 언어를 우선적으로 인식하도록 유도합니다. 현재 Sync 인터페이스는 32개 언어 코드를 허용하며, 언어를 지정하지 않으면 영어가 기본값입니다. 언어가 섞인 오디오에서는 예상 언어를 나열하세요. 사용자 정의 컨텍스트 프롬프트는 관리형 기본 프롬프트를 대체하고 별도의 언어 코드 유도 설정보다 우선하므로, 언어와 상황 컨텍스트가 모두 필요하면 해당 프롬프트 안에 예상 언어를 명시하세요. 전사를 번역 지침으로 취급하지 말고 실제로 말한 언어로 전사문을 유지하세요.

이 모델은 다른 AssemblyAI 전사 워크플로에도 등장하지만, Sync 프로필의 짧은 클립 요구 사항과 결과 필드는 이 특정 인터페이스에 속합니다. 제작사의 Dictation 워크플로는 별도의 텍스트 정리 단계를 추가합니다. 전사문과 다시 쓴 메시지는 서로 다른 결과물입니다. 이후 편집이나 요약 단계에서 정리된 버전을 만들더라도 인식된 음성을 보존해 원래 표현을 계속 비교할 수 있도록 하세요.

유용한 결과물로는 음성 메시지 전사문, 어시스턴트용으로 완성된 턴, 짧고 검색 가능한 오디오 텍스트, 검토 인터페이스용 시간 정보가 포함된 단어 목록이 있습니다. 결정적인 단어를 녹음과 대조하고 누락된 정렬을 보존하며, 반환된 텍스트와 클립의 연결을 유지하세요. 인식 결과는 다음 애플리케이션 단계에 원본 근거가 있는 전사문을 제공합니다. 요청에 답하거나 메시지를 편집하는 작업은 주변 워크플로에 속합니다.

Ailoot Ultra · 음성 전사 POST /v1/audio/transcriptions assemblyai/universal-3-5-pro

assemblyai/universal-3-5-pro

AssemblyAI /assemblyai/universal-3-5-pro

시작하기

허용 입력: 오디오
결과: 텍스트

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 음성 전사 POST /v1/audio/transcriptions

입력: audio
출력: text

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 assemblyai/universal-3-5-pro	기본값—
필드`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.00025 입력 오디오 초당

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 음성 전사

curl · 실제 WAV 파일과 원본 결과 전체

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': 'assemblyai/universal-3-5-pro', '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}/content
GET /v1/media/assets
GET /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 assemblyai/universal-3-5-pro

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

AssemblyAI: Universal-3.5 Pro