メインコンテンツへスキップ

​
概要

このエンドポイントは、リアルタイム音声認識、音声合成、音声翻訳、リアルタイムマルチモーダルモデルのセッションに使用します。通常の GET はメタデータを返し、WebSocket アップグレードは選択された上流セッションへプロキシされます。
エージェントは /v1/models で realtime 対応モデルを確認してから socket を開いてください。

​
接続

​
model
string
必須
リアルタイムモデル ID。公開契約で realtime をサポートするモデルを使用してください。
​
Authorization
string
必須
Bearer API キー。WebSocket クライアントはアップグレード要求で Authorization: Bearer sk-your-api-key を送信します。
import WebSocket from 'ws';

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

socket.on('open', () => {
  socket.send(JSON.stringify({ type: 'session.start' }));
});

socket.on('message', (data) => {
  console.log('realtime event', data.toString());
});

​
メッセージ

TokenLab はクライアントとルーティングされたリアルタイムプロバイダーの間で WebSocket メッセージを転送します。選択したモデルの公式イベント形式を使い、model はクエリ文字列で指定します。

​
課金と終了

リアルタイムセッションは同じ API キー残高を使用します。TokenLab は接続時に少額を事前控除し、終了時に精算または返金します。 セッション完了後はクライアント socket を閉じてください。上流が先に閉じた場合、TokenLab は可能な限り close code を転送します。