Skip to Content
모델 사용법GPT 전사

GPT 전사 시리즈

OpenAI의 음성 전사 모델로, POST /v1/audio/transcriptions로 오디오를 업로드하면 텍스트를 반환합니다.

모델 ID（호출 시 그대로 복사）
GPT Transcribeopenai/gpt-transcribe오디오 초 단위 과금
GPT-4o mini Transcribeopenai/gpt-4o-mini-transcribe토큰 단위 과금

API의 공통 파라미터는 Audio Transcriptions API를 참고하십시오. 실시간 가격은 모델 페이지 를 참고하십시오. 단어별 타임스탬프나 화자 분리가 필요하면 ElevenLabs Scribe v2를 사용하십시오.

호출 예시

gpt_transcribe.py
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
with open("meeting.mp3", "rb") as f:
    result = client.audio.transcriptions.create(
        model="openai/gpt-transcribe",
        file=f,
        language="zh",
        prompt="以下是普通话的句子，请使用简体中文。",
    )
print(result.text)
print(result.usage)

파라미터와 과금

핵심표준 중국어（보통화）를 전사할 때는 language와 prompt를 함께 전달해 간체자 사용을 지정하십시오. 그렇지 않으면 번체자로 출력될 수 있습니다.
항목설명
language와 prompt실측에서 gpt-transcribe에 language: "zh"만 전달했을 때 4회 중 1회는 번체로 출력되었습니다. prompt: "以下是普通话的句子，请使用简体中文。"（“다음은 보통화 문장이며, 간체 중국어를 사용하십시오.”라는 뜻）를 함께 전달하자 4회 모두 간체로 출력되었습니다
response_formatjson（기본값）만 지원합니다. verbose_json, text, srt, vtt는 모두 400을 반환합니다
반환 내용text와 usage. 단어별 타임스탬프는 포함되지 않습니다
과금gpt-transcribe는 오디오 초 단위이며 usage는 {"type": "duration", "seconds": ...}입니다. gpt-4o-mini-transcribe는 토큰 단위이며 usage에 input_tokens, output_tokens가 포함됩니다

실측에서 약 9초 분량의 중국어 대화는 전사 결과가 약 2–3초 만에 반환되었습니다.

자주 발생하는 오류

HTTP오류 메시지 원문원인해결 방법
400response_format 'verbose_json' is not compatible with model 'gpt-transcribe'.GPT 전사 모델은 verbose_json을 지원하지 않음json 사용
400Unsupported response_format 'srt'. Only 'json' and 'verbose_json' are supported on this gatewaytext, srt, vtt를 사용함json 사용
400Unsupported file format txt업로드한 파일이 오디오 파일이 아님mp3, wav 등의 오디오 업로드

더 많은 오류는 Audio Transcriptions API를 참고하십시오.

공식 문서

자주 묻는 질문

GPT 전사로 중국어를 전사했더니 번체자로 출력됩니다

language: "zh"와 prompt: "以下是普通话的句子，请使用简体中文。"를 함께 전달하십시오. 실측에서 language만 전달하면 가끔 번체로 출력되었고, prompt를 추가하자 안정적으로 간체로 출력되었습니다.

GPT 전사로 srt 자막을 출력할 수 있습니까?

할 수 없으며 json만 지원합니다. 타임스탬프로 자막을 만들어야 한다면 단어별 시작·종료 시간을 반환하는 ElevenLabs Scribe v2를 사용하십시오.

gpt-transcribe와 gpt-4o-mini-transcribe는 어떻게 과금됩니까?

gpt-transcribe는 오디오 초 단위로, gpt-4o-mini-transcribe는 토큰 단위로 과금되며 사용량은 응답의 usage에서 확인할 수 있습니다. 단가는 모델 페이지를 참고하십시오.

마지막 업데이트
Gemini TTSDeepSeek