openai-whisper-api은(는) 무엇을 하나요?
OpenAI 오디오 전사 API를 curl로 호출; gpt-4o-transcribe, mini, diarize 또는 whisper-1 모델 지원.
개요
이 스킬은 OpenAI의 오디오 전사(Transcription) API를 curl 명령어를 통해 직접 호출하는 방법을 제공합니다. 별도의 SDK나 라이브러리 없이도 오디오 파일을 텍스트로 변환할 수 있습니다.
지원 모델
| 모델 | 설명 |
|---|---|
whisper-1 | OpenAI Whisper 기반 기본 전사 모델 |
gpt-4o-transcribe | GPT-4o 기반 고급 전사 모델 |
gpt-4o-mini-transcribe | GPT-4o의 경량화된 전사 모델 |
gpt-4o-transcribe (diarize) | 화자 분리 기능이 포함된 GPT-4o 전사 모델 |
사전 요구 사항
- OpenAI API 키 (환경 변수
OPENAI_API_KEY에 설정) - curl 명령어 사용 가능
사용 예시
기본 전사 (whisper-1 사용)
curl -X POST https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "model=whisper-1"
GPT-4o 전사 모델 사용
curl -X POST https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "model=gpt-4o-transcribe"
GPT-4o 미니 전사 모델 사용
curl -X POST https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "model=gpt-4o-mini-transcribe"
화자 분리(Diarization) 활성화
curl -X POST https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "model=gpt-4o-transcribe" \
-F "diarize=true"
추가 옵션
| 옵션 | 설명 | 기본값 |
|---|---|---|
language | 오디오 언어 코드 (예: ko, en) | 자동 감지 |
response_format | 응답 형식 (json, text, srt, vtt) | json |
temperature | 샘플링 온도 (0-1) | 0 |
timestamp_granularities | 타임스탬프 세분화 (word, segment, 또는 둘 다) | segment |
언어 지정 및 자막 형식 예시
curl -X POST https://api.openai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "model=whisper-1" \
-F "language=ko" \
-F "response_format=srt"
환경 변수
OPENAI_API_KEY: OpenAI API 키 (필수)
참고 사항
- 지원되는 오디오 형식:
flac,m4a,mp3,mp4,mpeg,mpga,oga,ogg,wav,webm - 최대 파일 크기: 25MB (더 큰 파일은 분할 필요)
- 화자 분리 기능은
gpt-4o-transcribe모델에서만 지원됩니다.