Qwen-Omni-Realtime WebSocket アクセス
適用範囲
このドキュメントは Qwen-Omni-Realtime を対象とします。サンプルモデルは qwen3.8-omni-flash-realtime です。qwen3.5-omni-plus-realtime と qwen3.5-omni-flash-realtime の設定は、イベントリファレンスをご覧ください。旧モデル qwen3-omni-flash-realtime-2025-09-15 のパラメーターは、Python SDKで説明します。
- 選択したリージョンとワークスペースに対応する API キーとワークスペース IDを使用してください。
- 北京のドメイン：
{WorkspaceId}.cn-beijing.maas.aliyuncs.com。シンガポールのドメイン：{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com。 - 長期 API キーはサーバーに保存し、ブラウザーやモバイルアプリケーションに含めないでください。
アドレスと認証
北京：wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtime
シンガポール：wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtime
qwen3.8-omni-flash-realtime はワークスペース専用ドメインを使用する必要があります。旧モデルは従来のドメインを引き続き使用できます。北京は wss://dashscope.aliyuncs.com、シンガポールは wss://dashscope-intl.aliyuncs.com です。詳細は、Python SDKをご覧ください。
WebSocket ハンドシェイクのリクエストヘッダーに Authorization: Bearer <API_KEY> を設定します。ワークスペース ID と実際のモデル名を置き換えてください。長期 API キーをブラウザーやモバイルアプリに含めないでください。
任意のリクエストヘッダー user-agent はクライアントの識別に使用します。汎用 WebSocket アクセスドキュメントには、X-DashScope-WorkSpace（ワークスペース ID）と X-DashScope-DataInspection（データコンプライアンス検査の設定）も記載されています。モデルの要件に応じて使用します。
一時 API キーの生成手順と権限は、一時 API キーの生成をご覧ください。
セッション設定
接続を確立して session.created を受信したら、session.update を送信します。確認の session.updated を受信してから入力を送信し、error イベントでエラーを処理します。
次の例は qwen3.8-omni-flash-realtime に対応します。その他のバージョンは、それぞれのイベントリファレンスの設定を使用し、フィールドの階層を混在させないでください。
{
"type": "session.update",
"session": {
"modalities": [
"text",
"audio"
],
"voice": "Tina",
"turn_detection": {
"type": "server_vad"
}
}
}
入力、結果、終了
音声は input_audio_buffer.append で送信します。入力形式、コミット条件、画像入力の制限は、クライアントイベントをご覧ください。サーバーイベントで結果、状態、エラーを処理します。接続の確立を業務リクエストの完了とみなさないでください。
自動ターン、Manual モード、Function Calling、MCP のタイミングは、対話フローで説明します。必要な結果の受信後に WebSocket 接続を閉じます。
エラー処理
ハンドシェイクに失敗した場合は、ドメイン、リージョン、ワークスペース、API キー、モデル名、モデルの有効化状態と権限を確認します。接続後は error イベントに基づいて問題を特定し、エラーコードを参照します。調査用にイベント ID を保存してください。応答がないことだけを理由に、プロトコルが未対応と判断しないでください。