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.io/v1
エンドポイントhttps://api.ofox.io/v1/audio/transcriptions
モデル IDopenai/gpt-transcribe
transcribe.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.io/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 でのみ使えます。

プロバイダー固有のパラメーター。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 でファイルをアップロードする

エラーコードの詳細はエラー処理を参照してください。

最終更新日