メインコンテンツへスキップ
オーディオ処理は二つに分かれます。テキスト読み上げ、文字起こし、音声翻訳のようなファイル型の処理は Audio endpoint を使います。低遅延の対話音声やリアルタイムのマルチモーダルイベントが必要な場合は Realtime WebSocket を使います。

​
ワークフローを選ぶ

ワークフローEndpoint使う場面
テキスト読み上げPOST /v1/audio/speechテキストから音声ファイルを作る場合。
文字起こしPOST /v1/audio/transcriptions音声ファイルからテキストを得る場合。
音声翻訳POST /v1/audio/translations音声ファイルから翻訳済みテキストを得る場合。
リアルタイムセッションGET /v1/realtime双方向ストリーミング音声またはリアルタイムイベントが必要な場合。

​
モデルを確認する

モデル一覧をクライアントに固定しないでください。音声生成と文字起こしは推奨モデルを使い、リアルタイム対応は socket を開く前にモデル詳細で確認します。 
curl "https://api.tokenlab.sh/v1/models?recommended_for=tts" \
  -H "Authorization: Bearer sk-your-api-key"

curl "https://api.tokenlab.sh/v1/models?recommended_for=stt" \
  -H "Authorization: Bearer sk-your-api-key"

​
同期オーディオリクエスト

音声生成、文字起こし、翻訳は HTTP リクエスト内で直接返ります。大きな入力は一般的なクライアントの timeout を超えることがあるため、余裕のある timeout と request ID の保存を推奨します。 
curl -X POST "https://api.tokenlab.sh/v1/audio/speech" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1-hd",
    "voice": "nova",
    "input": "Welcome to TokenLab."
  }' \
  --output speech.mp3

​
リアルタイムセッション

WebSocket では query string に model、Authorization header に API key を入れます。選択したリアルタイムモデルのドキュメントに沿ったイベント形式を使い、完了時に socket を閉じます。 
import WebSocket from 'ws';

const socket = new WebSocket('wss://api.tokenlab.sh/v1/realtime?model=gpt-realtime', {
  headers: { Authorization: 'Bearer sk-your-api-key' }
});

socket.on('message', (event) => console.log(event.toString()));

​
状態管理

  • 生成済み音声ファイルを保存し、更新時に同じリクエストを再実行しない。
  • 文字起こしと翻訳は同期でもアップロード中・処理中の状態を表示する。
  • リアルタイムでは close イベントを処理し、ユーザーが新しいセッションを始めた時だけ再接続する。
  • API key、非公開 URL、アカウント秘密情報を音声テキスト入力に入れない。

​
API リファレンス

トピックリファレンス
音声を作成音声を作成
文字起こしを作成文字起こしを作成
翻訳を作成翻訳を作成
Realtime WebSocketRealtime WebSocket
モデル一覧モデル一覧
請求と価格請求と価格