OpenAI API 녹취록에서 제품명을 자꾸 틀리면 어떻게 하나요? 초보자 keywords 사용법

keywords
제품명·약어처럼 녹음에 나올 수 있는 단어나 구절의 목록입니다.

prompt
녹음의 주제와 상황을 설명하는 자유 형식 문맥입니다. 용어 목록과 구분합니다.

languages
예상 입력 언어의 목록입니다. 용어의 철자나 번역할 목표 언어를 정하지 않습니다.

1단계. 틀린 구간과 기준 결과를 남깁니다.
외부 전송이 허용된 짧은 시험 녹음을 고르세요. 기존 gpt-transcribe 파일 전사 결과에서 제품명·약어가 틀린 위치를 표시하고 원음을 다시 듣습니다. 예시 용어인 OpenAI와 Codex는 실제 녹음에 해당 말이 있을 때만 사용하세요.

2단계. 기존 호출에 용어 힌트만 추가합니다.
공식 Python의 client.audio.transcriptions.create 에서 파일과 모델은 유지하고 extra_body={"keywords":["OpenAI","Codex"]} 를 넣습니다. 이미 extra_body가 있다면 다른 항목을 지우지 말고 병합하세요. 이 표기는 전체 실행 예제가 아닌 인수 위치 안내입니다.

3단계. 바뀐 단어와 주변 문장을 대조합니다.
반환된 transcription.text 를 기준 결과·원음과 비교하세요. 대상 용어뿐 아니라 없던 단어가 추가되거나 주변 말이 빠지지 않았는지도 봅니다. 문맥이 더 필요하면 prompt에 실제 녹음 상황을 짧게 적되 한 번에 여러 설정을 바꾸지 않습니다.

위험 신호 1
녹음에 없는 제품명을 긴 목록으로 넣고 모두 등장하기를 기대합니다. 관련 없는 힌트는 빼고 실제로 말했는지부터 확인하세요.

위험 신호 2
화자 구분 모델에도 같은 입력을 넣습니다. 공식 가이드는 gpt-4o-transcribe-diarize가 prompt를 지원하지 않는다고 안내합니다. 모델별 옵션을 따로 확인하세요.

위험 신호 3
prompt에 전사하라는 명령이나 기대 결론을 길게 씁니다. 실제 녹음에 관련된 문맥만 주고, 키·고객명·비공개 용어가 시험 로그에 노출되지 않게 하세요.

설정 구분은 공식 웹 문서에서

Transcription의 품질 개선과 File transcription의 문맥 추가 예시를 함께 읽으세요. prompt·keywords·languages의 역할을 구분한 뒤 필요한 힌트만 고릅니다.

비교는 파일 전사 개발 환경에서

ChatGPT 웹·모바일 앱의 받아쓰기 메뉴가 아닙니다. API를 호출하는 프로그램에서 확인하세요. 키는 환경 변수나 승인된 비밀 저장소에서 불러옵니다. 이 글은 문서 기반 안내이며 실제 전사 품질 향상을 측정한 결과가 아닙니다.