Source: https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/ Canonical: https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/ Language: ko # OpenAI: GPT-4o Mini Transcribe [Markdown](https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/index.md) · [JSON](https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/facts.json) ## [OpenAI: GPT-4o Mini Transcribe](https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/) GPT-4o Mini Transcribe는 GPT-4o Mini를 기반으로 하는 OpenAI의 음성 인식 모델입니다. 오디오를 JSON 전사로 바꾸고 녹음에 고유한 텍스트 프롬프트와 파일 결과 스트리밍을 지원하며, 확인할 부분을 좁혀 전사를 검토하도록 토큰 로그 확률을 반환할 수 있습니다. - [**Ailoot Ultra · 음성 전사** `POST /v1/audio/transcriptions` `openai/gpt-4o-mini-transcribe`](https://ailoot.ai/models/ko/openai-gpt-4o-mini-transcribe/#method-0) 모델 소개 이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다. GPT-4o Mini Transcribe는 GPT-4o Mini를 기반으로 하는 OpenAI의 음성 인식 모델입니다. 선택적인 텍스트 안내와 함께 오디오를 입력받아 인식한 텍스트를 출력합니다. GPT-4o를 사용하는 GPT-4o Transcribe 및 별도의 키워드·다국어 힌트 필드를 갖춘 새로운 GPT Transcribe 프로필과 구분되는 모델입니다. 여기서 유용한 산출물은 검색, 검토, 이후 콘텐츠 처리 단계를 위해 준비한 녹음의 원래 발화 전사입니다. #### 녹음 준비하기 OpenAI의 파일 전사 가이드는 최대 25 MB의 오디오 업로드를 입력받습니다. 현재 엔드포인트 참조 문서는 FLAC, MP3, MP4, MPEG, MPGA, M4A, OGG, WAV, WebM과 오디오 형식을 식별하기에 충분한 파일명·콘텐츠 유형 메타데이터를 명시합니다. 더 큰 녹음은 압축하거나 25 MB 이하의 부분으로 나눌 수 있습니다. 나눌 때 문장 경계를 유지하고 각 부분을 원본 녹음 및 위치에 연결해 나중에 텍스트를 올바른 순서로 조합할 수 있게 하세요. 음성 메모에는 녹음마다 식별 가능한 전사 하나를 보관하고, 텍스트로 작업을 만들기 전에 이름이나 숫자를 확인하세요. 말로 설명한 튜토리얼에는 게시용으로 편집하기 전에 인식한 표현을 원래 지시와 비교합니다. 유용한 준비 지시서는 발화 언어와 잘못 들을 수 있는 용어를 밝힙니다. 단어를 전사하는 것이 첫 단계이며, 해석·요약·번역은 이후 확인한 전사를 사용할 수 있습니다. #### 프롬프트 안내와 단일 언어 힌트 기존 GPT-4o Mini Transcribe 통합은 자유 형식 프롬프트를 지원합니다. OpenAI는 이름, 약어, 녹음별 어휘, 문장 부호, 대소문자, 군더더기 말, 선호하는 표기 체계를 위한 프롬프트를 설명합니다. 엔드포인트 참조 문서는 프롬프트가 오디오 언어와 일치해야 하며 앞선 오디오 구간의 맥락을 포함할 수 있다고 명시합니다. 전사 프롬프트를 제한 없는 채팅 지시처럼 동작하게 요청하지 말고 관련 표기나 주제에 관한 짧은 설명을 포함하세요. 이 모델의 기존 언어 힌트는 단수형 language 필드를 사용합니다. 개발사 참조 문서는 en 같은 ISO 639-1 입력 언어 코드를 명시합니다. 별도의 keywords 필드와 복수형 languages 필드는 GPT Transcribe용으로 문서화되어 있으며 이 Mini 프로필에는 포함되지 않습니다. 여러 녹음에는 의도한 발화 언어 설정을 각 입력과 함께 보관하고, 결과를 번역하라는 요청으로 해석하지 마세요. #### JSON 결과와 선택적인 토큰 확률 현재 엔드포인트 참조 문서는 GPT-4o Mini Transcribe가 지원하는 응답 형식으로 JSON을 명시합니다. 인식한 표현은 text 필드에 표시됩니다. 요청하면 JSON 응답에 토큰 로그 확률을 포함할 수 있습니다. 이 값은 모델의 토큰 확률을 나타내고 더 자세히 검토할 자료를 찾는 데 도움이 되지만, 이름·숫자·문장이 소리와 일치한다는 사실을 입증하지 않습니다. 의심스러운 단어를 고칠지는 녹음을 사용해 판단하세요. 일반 Mini 전사 프로필은 이 JSON 규격을 통해 기본 SRT, VTT, 상세한 단어 타임스탬프, 화자 레이블 출력을 제공하지 않습니다. OpenAI는 이러한 기능을 위한 전문 모델과 형식을 문서화합니다. 의도한 산출물이 자막 트랙이라면 텍스트 전용 결과에 자막 경계가 이미 있다고 가정하지 말고, 검토한 전사를 별도의 시간 지정 작업 흐름에 사용할 수 있도록 보관하세요. #### 파일 출력 스트리밍과 문서화된 모드 개발사의 음성 인식 가이드는 기존 GPT-4o Mini Transcribe 통합이 파일 스트리밍을 지원한다고 명시적으로 설명합니다. 완료된 녹음을 처리하는 동안 부분 전사 텍스트가 나온 뒤 최종 결과가 생성될 수 있습니다. 완료된 산출물로 최종 전사를 보관하세요. 부분 텍스트가 나타난다고 파일 작업 흐름이 실시간 마이크 오디오를 계속 입력받는 것은 아닙니다. 모델 카드는 전사 및 Realtime 엔드포인트 계열을 별도로 명시합니다. 이러한 개발사 인터페이스가 다른 전사 모델의 모든 세션 필드를 여기에 적용할 수 있다는 의미는 아닙니다. #### 컨텍스트, 출력 한도, 유용한 점검 OpenAI의 현재 모델 사양에는 16,000토큰의 컨텍스트 창, 2,000토큰의 최대 출력, 2024년 6월 1일의 지식 기준일이 명시되어 있습니다. 이는 모델 사양 수치이며 오디오 녹음에 보편적으로 적용되는 분 단위 시간이 아닙니다. 파일 크기 규칙과 토큰 한도는 서로 다른 제약을 설명합니다. 긴 자료에는 문서화된 파일 작업 흐름에 맞춰 녹음을 준비하고, 관련 맥락을 부분 사이에 전달하며, 최종 텍스트에 원본의 끝부분이 포함되어 있는지 확인하세요. 유용한 Mini Transcribe 결과는 표현과 녹음의 관계를 보존하고 선택적인 확률 데이터와 편집상 수정을 구분합니다. 원본 오디오를 확인할 수 있는 상태로 낯선 어휘, 억양, 배경 소음, 언어 변화, 겹치는 발화를 검토하세요. 읽기 쉽게 텍스트를 수정할 때는 편집본과 인식된 전사를 구별해, 이후 사용자가 어떤 표현이 녹음에서 나왔고 어떤 표현이 준비 과정에서 바뀌었는지 알 수 있게 합니다. **Ailoot Ultra · 음성 전사** `POST /v1/audio/transcriptions` `openai/gpt-4o-mini-transcribe` [`openai/gpt-4o-mini-transcribe`](https://ailoot.ai/models/ko/#m=openai%2Fgpt-4o-mini-transcribe&route=Ultra&caller=openai%2Fgpt-4o-mini-transcribe&fmt=transcriptions) OpenAI /`openai/gpt-4o-mini-transcribe` ### 시작하기 GPT-4o Mini Transcribe는 GPT-4o Mini를 기반으로 하는 OpenAI의 음성 인식 모델입니다. 오디오를 JSON 전사로 바꾸고 녹음에 고유한 텍스트 프롬프트와 파일 결과 스트리밍을 지원하며, 확인할 부분을 좁혀 전사를 검토하도록 토큰 로그 확률을 반환할 수 있습니다. 허용 입력 오디오 결과 텍스트 ### Ailoot에서 사용 가능 · 입력 및 메서드 **Ailoot Ultra · 음성 전사** `POST /v1/audio/transcriptions` 입력 `audio` 출력 `text` | 필드 | 유형 | 요건 | 값과 한도 | 기본값 | | --- | --- | --- | --- | --- | | 필드`model` | 유형`string` | 요건필수 | 값과 한도 openai/gpt-4o-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 토큰 | | 설정입력 토큰 | 요금표— | 과금 단위/ 1K 토큰 | 요금 입력 **$0.0025** / 1K 토큰 | | 설정출력 토큰 | 요금표— | 과금 단위/ 1K 토큰 | 요금 출력 **$0.01** / 1K 토큰 | Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/) ### 요청 예제 #### Ailoot Ultra · 음성 전사 curl · 실제 WAV 파일과 원본 결과 전체 ```bash 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': 'openai/gpt-4o-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}/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** [`openai/gpt-4o-mini-transcribe`](https://ailoot.ai/models/ko/#m=openai%2Fgpt-4o-mini-transcribe&route=Ultra&caller=openai%2Fgpt-4o-mini-transcribe&fmt=transcriptions) #### 메서드 경로 별칭 위에 표시된 메서드 경로를 사용하세요. #### 관련 호출용 ID [`openai/gpt-4o-mini-transcribe`](https://ailoot.ai/models/ko/#m=openai%2Fgpt-4o-mini-transcribe&route=Ultra&caller=openai%2Fgpt-4o-mini-transcribe&fmt=transcriptions) FAQ · OpenAI: GPT-4o Mini Transcribe 어떤 입력과 결과를 사용할 수 있나요? `POST /v1/audio/transcriptions` · `openai/gpt-4o-mini-transcribe`: `audio` → `text` 요청은 어떤 필드를 사용하나요? `POST /v1/audio/transcriptions` · `openai/gpt-4o-mini-transcribe`: `model`, `input_audio` Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요. ## 회사와 그 프로젝트 포트폴리오 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. ## 할인받아 토큰을 구매하세요. 정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드. 구독 정기 요청에 맞는 할인 요금제를 선택하세요. 최대 50% 프로모션 코드 구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다. 이력의 지출 요청마다 모델, 토큰, 금액을 저장합니다. [구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/) ## 판매하는 제품에 API를 연결하세요. Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요. 상업용 앱 서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요. 리셀러 라이선스 프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요. 사이트의 문서 연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다. [리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko) ## Ailoot · 회사와 그 프로젝트 포트폴리오 Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다. 회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출. Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.