OpenAI: Whisper 1
Whisper 1은 녹음이 완료된 오디오 파일을 텍스트로 전사하며, 다국어 인식과 단어 또는 세그먼트 타임스탬프를 제공합니다. 제작사는 자막 형식과 별도의 영어 번역 흐름을 지원합니다. 전사 결과는 녹음의 언어를 유지합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Whisper 1은 OpenAI의 범용 음성 인식 API 모델로, 문서에 따르면 오픈 소스 Whisper V2 모델로 구동됩니다. 오디오 파일을 받아 텍스트를 반환합니다. 제조사는 다국어 인식, 언어 식별, 별도의 음성 번역 작업을 설명합니다. 전사는 발화 언어를 유지하며, 제작사의 별도 번역 인터페이스는 영어 텍스트를 반환합니다.
실용적인 활용 사례는 인터뷰, 음성 메모, 녹음된 대화를 나중에 검색하고 편집할 수 있도록 준비하는 것입니다. 녹음이 완료된 파일을 제공하고 입력 언어를 알고 있다면 함께 지정하세요. OpenAI는 98개 지원 언어를 명시하며 언어에 따라 인식 정확도가 다르다고 설명합니다. 단일 언어 힌트에는 ISO 639-1 코드를 사용합니다. 다른 전사 모델의 새로운 다중 언어 및 키워드 필드는 별도의 제어 항목입니다.
제작사의 파일 전사 흐름은 MP3, MP4, MPEG, MPGA, M4A, WAV, WebM 형식의 최대 25 MB 파일을 받습니다. 더 큰 녹음은 압축 형식을 사용하거나 한도 안의 청크로 나누세요. 문장 경계와 청크 순서를 보존해 합친 전사문이 원본 녹음과 계속 연결되도록 하세요. 이 작업에서 영상 컨테이너는 시각적 설명 입력이 아니라 오디오를 제공합니다.
프롬프트에는 이름, 약어, 녹음에 특화된 어휘, 앞선 세그먼트의 맥락을 제공할 수 있습니다. Whisper의 프롬프트 한도는 224토큰이며 프롬프트 언어는 오디오의 언어와 일치해야 합니다. 제조사는 Whisper가 범용 텍스트 모델처럼 지시를 따르지 않는다고 설명합니다. 프롬프트를 관련 전사 맥락으로 사용하고 중요한 표기는 녹음과 대조하세요. 용어 목록을 화자가 반드시 말한 단어로 취급해서는 안 됩니다.
제작사는 JSON, 일반 텍스트, SRT, VTT, verbose JSON 전사 형식을 문서화했습니다. 단어 및 세그먼트 타임스탬프에는 verbose JSON이 필요하며, 둘 중 하나 또는 두 수준을 모두 요청할 수 있습니다. API 참조는 세그먼트 타임스탬프에는 추가 지연이 없지만 단어 타임스탬프에는 추가 처리가 필요하다고 설명합니다. 이러한 출력은 자막 제작과 편집 중 문단 찾기에 도움이 됩니다. 화자 분리 주석은 다른 전문 모델에 속합니다.
Whisper 1은 파일 전사 스트리밍을 지원하지 않습니다. 참조 문서는 0~1의 샘플링 온도도 설명하며, 0일 때는 디코딩 임계값에 따라 모델이 온도를 자동으로 올릴 수 있습니다. 이는 제작사의 처리 제어를 설명하는 것이며 모든 녹음에서 동일하거나 완벽하게 정확한 전사문이 나온다는 약속은 아닙니다.
최종 결과물을 정하세요. 검색용 전사문, 자막 파일, 단어·세그먼트 시간 정보가 있는 텍스트 중 필요한 형태를 지정합니다. 원본 녹음, 청크 순서, 관련 원본 시간 참조를 결과와 함께 보관하세요. 후속 텍스트 편집으로 철자를 고치거나 요약을 만들 수 있지만 변경 사항을 오디오와 비교해 화자의 의미를 보존하세요. 인식된 텍스트는 발화된 질문에 대해 생성한 답변이 아니라 다음 작업의 근거가 됩니다.
Ailoot Ultra · 음성 인식 POST /v1/audio/transcriptions openai/whisper-1
openai/whisper-1시작하기
Whisper 1은 녹음이 완료된 오디오 파일을 텍스트로 전사하며, 다국어 인식과 단어 또는 세그먼트 타임스탬프를 제공합니다. 제작사는 자막 형식과 별도의 영어 번역 흐름을 지원합니다. 전사 결과는 녹음의 언어를 유지합니다.
- 허용 입력
- 오디오
- 결과
- transcription
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 음성 인식 POST /v1/audio/transcriptions
- 입력
audio- 출력
transcription- 출력 형식
- json
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 openai/whisper-1 | 기본값— |
필드file | 유형file | 요건필수 | 값과 한도 콘텐츠 유형: multipart/form-data | 기본값— |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 json | 기본값— |
필드input_audio.data | 유형base64_string | 요건필수 | 값과 한도 적용 조건: WhisperOR JSON 입력 | 기본값— |
필드input_audio.format | 유형string | 요건필수 | 값과 한도 wav, mp3, flac, ogg, m4a, webm 적용 조건: WhisperOR JSON 입력 | 기본값— |
입력 자료 조합
· 필수: model, file
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수contours | 명세{"content_types":["application/json","multipart/form-data"],"required_json":["model","input_audio.data","input_audio.format"],"required_multipart":["model","file"],"file_formats":["wav","mp3","flac","ogg","m4a","webm"],"response_format_optional":["json"]}, {"content_types":["multipart/form-data"],"required":["model","file"],"file_formats":["mp3"],"response_format_option":false} |
매개변수max_bytes | 명세26214400 |
매개변수material_types | 명세audio |
수명 주기: 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 및 시간 정보를 보존하세요.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 오디오(초) | 요금표— | 과금 단위입력 오디오 초당 | 요금 입력 · 입력 오디오(초) $0.0002 입력 오디오 초당 |
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
OpenAI: Whisper 1
설정별 가격
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정OpenAI: Whisper 1 · 기본 설정 | 과금 조건기본 설정 | 요금 입력 · 입력 오디오(초) US$0.0002 입력 오디오 초당 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 음성 인식
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual MP3 recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import os
from pathlib import Path
p=Path(os.environ["AILOOT_AUDIO_FILE"])
if not p.is_file() or p.suffix.lower()!=".mp3":raise SystemExit("Choose an existing 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=openai/whisper-1 -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())))
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 음성 인식
json
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
텍스트만이 아니라 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 Ultra openai/whisper-1
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · OpenAI: Whisper 1
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/transcriptions·openai/whisper-1:audio→transcription- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/transcriptions·openai/whisper-1:model,file,response_format