Skip to Content
API 레퍼런스OpenAI 호환 프로토콜Audio Transcriptions

Audio Transcriptions API

오디오를 텍스트로 변환합니다. OpenAI의 POST /v1/audio/transcriptions와 호환되며, multipart/form-data로 오디오 파일을 업로드합니다.

시리즈모델설명
GPT 전사openai/gpt-transcribe, openai/gpt-4o-mini-transcribe, openai/gpt-4o-transcribe-diarizeGPT 전사 참고
ElevenLabselevenlabs/scribe_v2단어별 타임스탬프와 화자 분리를 지원합니다. ElevenLabs 참고

빠른 시작

base_urlhttps://api.ofox.ai/v1
엔드포인트https://api.ofox.ai/v1/audio/transcriptions
모델 IDopenai/gpt-transcribe
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)

요청 파라미터

file필수file

오디오 파일입니다(예: mp3, wav). 오디오가 아닌 파일은 400이 반환됩니다.

model필수string

모델 ID입니다. 위 표를 참고하십시오.

languagestring

오디오의 언어입니다(예: zh, en). 생략하면 자동으로 감지합니다.

promptstring

표기 습관이나 고유 명사를 지정하기 위한 힌트 텍스트로, GPT 전사 모델에 적용됩니다. 표준 중국어(보통화)를 전사할 때는 language: "zh"와 함께 “以下是普通话的句子，请使用简体中文。“(다음은 표준 중국어 문장이니 간체자를 사용하라는 뜻)를 전달하는 것을 권장합니다. 그렇지 않으면 번체자로 출력될 수 있습니다.

response_formatstring· 기본값 json· 허용 값jsonverbose_json

json과 verbose_json만 지원하며, text, srt, vtt는 400이 반환됩니다. verbose_json은 ElevenLabs Scribe에만 적용됩니다.

provider_optionsstring

공급자 전용 파라미터로, JSON 문자열을 폼 필드로 전달합니다. 예: {"elevenlabs": {"diarize": true}}. 각 시리즈 페이지를 참고하십시오.

응답

{
  "text": "今天天气很好，我们下午三点在会议室讨论新功能。",
  "usage": { "type": "duration", "seconds": 9 }
}
textstring

전사된 텍스트입니다.

usageobject

과금 기준입니다. type이 duration이면 오디오 초 단위(seconds)로, tokens이면 토큰 단위(input_tokens, output_tokens)로 과금됩니다.

ElevenLabs Scribe는 이 밖에도 words(단어별 텍스트와 시작·종료 시간), language, duration 등의 필드를 반환합니다. ElevenLabs를 참고하십시오. 자막 파일이 필요하면 words의 타임스탬프로 직접 생성할 수 있습니다.

자주 발생하는 오류

HTTP오류 원문원인해결 방법
400Unsupported response_format 'srt'. Only 'json' and 'verbose_json' are supported on this gatewaytext, srt, vtt를 사용함json을 사용하고, 자막은 타임스탬프로 생성
400response_format 'verbose_json' is not compatible with model 'gpt-transcribe'. Use 'json' or 'text' instead.GPT 전사 모델은 verbose_json을 지원하지 않음json을 사용
400Unsupported file format txt업로드한 파일이 오디오가 아님mp3, wav 등 오디오를 업로드
400Model 'openai/gpt-5.4' is not supported on /v1/audio/transcriptions. Supported: ...선택한 모델이 전사 모델이 아님오류 메시지에 나열된 모델을 사용
400You must provide a model parameter.폼이 아닌 JSON으로 요청을 보냄multipart/form-data로 파일을 업로드

전체 오류 코드 설명은 오류 처리를 참고하십시오.

마지막 업데이트
Audio Speech