即時對話

# 依賴: pip install "openai[realtime]"
import asyncio
import base64
from openai import AsyncOpenAI

# 重用官方 SDK 只需兩處適配:
#   1) websocket_base_url 指向 AiHubMix 閘道(而非 OpenAI 預設位址)
#   2) connect() 顯式傳 model,閘道握手必需(對話端點不需要 intent)
client = AsyncOpenAI(
    api_key="sk-***",  # 替換為你的 AiHubMix API 金鑰
    websocket_base_url="wss://aihubmix.com/v1",
)

async def main():
    async with client.realtime.connect(model="gpt-realtime-2.1") as conn:
        # 1) 設定工作階段: 系統指令 + 音色 + 開啟 VAD(自動斷句)
        await conn.session.update(session={
            "type": "realtime",
            "instructions": "You are a helpful voice assistant. Keep answers concise.",
            "audio": {
                "input": {
                    "format": {"type": "audio/pcm", "rate": 24000},
                    "turn_detection": {"type": "server_vad"},
                },
                "output": {
                    "format": {"type": "audio/pcm", "rate": 24000},
                    "voice": "alloy",
                },
            },
        })

        # 2) 發送一則文字訊息並請求回覆(音訊輸入見原生範例的 append/commit)
        await conn.conversation.item.create(item={
            "type": "message",
            "role": "user",
            "content": [{"type": "input_text", "text": "What is the capital of France?"}],
        })
        await conn.response.create()

        # 3) 接收本輪回覆: 文字走轉寫增量, 語音走音訊增量
        async for event in conn:
            if event.type == "response.output_audio_transcript.delta":
                print(event.delta, end="", flush=True)  # 回覆文字(輸出含語音時)
            elif event.type == "response.output_audio_transcript.done":
                print()  # 本輪文字稿結束
            elif event.type == "response.output_text.delta":
                print(event.delta, end="", flush=True)  # 純文字輸出時
            elif event.type == "response.output_text.done":
                print()
            elif event.type == "response.output_audio.delta":
                pass  # base64 PCM16 音訊片段, 可解碼後播放
            elif event.type == "input_audio_buffer.speech_started":
                pass  # 使用者打斷: 停播後呼叫 conn.conversation.item.truncate(...) 截斷
            elif event.type == "response.done":
                print("\n[本輪完成]", event.response.usage)
                break
            elif event.type == "error":
                print("\n[錯誤]", event.to_dict())
                break

asyncio.run(main())

import asyncio
import base64
import json
import websockets

API_KEY = "sk-***"  # 替換為你的 AiHubMix API 金鑰
URL = "wss://aihubmix.com/v1/realtime?model=gpt-realtime-2.1"

async def main():
    # websockets >= 13 用 additional_headers；舊版本用 extra_headers
    async with websockets.connect(
        URL, additional_headers={"Authorization": f"Bearer {API_KEY}"}
    ) as ws:
        # 1) 設定工作階段(關閉 VAD, 手動控制回覆時機)
        await ws.send(json.dumps({
            "type": "session.update",
            "session": {
                "type": "realtime",
                "instructions": "You are a helpful voice assistant.",
                "audio": {
                    "input": {
                        "format": {"type": "audio/pcm", "rate": 24000},
                        "turn_detection": None,
                    },
                    "output": {
                        "format": {"type": "audio/pcm", "rate": 24000},
                        "voice": "alloy",
                    },
                },
            },
        }))

        # 2) 讀取本機 PCM16 / 24kHz / 單聲道 裸音訊,分塊發送,再 commit + 請求回覆
        async def send_audio():
            with open("audio_pcm16_24k.raw", "rb") as f:
                pcm = f.read()
            chunk = 24000 * 2 // 10  # 100ms = 取樣率 × 2 位元組 ÷ 10
            for i in range(0, len(pcm), chunk):
                await ws.send(json.dumps({
                    "type": "input_audio_buffer.append",
                    "audio": base64.b64encode(pcm[i:i + chunk]).decode(),
                }))
                await asyncio.sleep(0.1)  # 模擬即時節奏
            # 關閉 VAD 時手動提交並請求回覆
            await ws.send(json.dumps({"type": "input_audio_buffer.commit"}))
            await ws.send(json.dumps({"type": "response.create"}))

        asyncio.create_task(send_audio())

        # 3) 接收回覆
        async for msg in ws:
            evt = json.loads(msg)
            etype = evt.get("type", "")
            if etype == "response.output_audio_transcript.delta":
                print(evt.get("delta", ""), end="", flush=True)  # 回覆文字(輸出含語音時)
            elif etype == "response.output_audio_transcript.done":
                print()  # 本輪文字稿結束
            elif etype == "response.output_text.delta":
                print(evt.get("delta", ""), end="", flush=True)  # 純文字輸出時
            elif etype == "input_audio_buffer.speech_started":
                pass  # 使用者打斷: 停播後傳送 conversation.item.truncate 截斷
            elif etype == "response.output_audio.delta":
                pass  # base64 PCM16 音訊片段, 可解碼後播放
            elif etype == "response.done":
                print("\n[本輪完成]", evt.get("response", {}).get("usage"))
                break
            elif etype == "error":
                print("\n[錯誤]", evt.get("error"))
                break

asyncio.run(main())

# 依賴: pip install openai-agents
import asyncio
from agents.realtime import (
    OpenAIRealtimeWebSocketModel,
    RealtimeAgent,
    RealtimeSession,
)

agent = RealtimeAgent(
    name="Assistant",
    instructions="You are a helpful voice assistant. Keep answers concise.",
)

async def main():
    session = RealtimeSession(
        OpenAIRealtimeWebSocketModel(),
        agent,
        None,
        model_config={
            "api_key": "sk-***",  # 替換為你的 AiHubMix API 金鑰
            "url": "wss://aihubmix.com/v1/realtime?model=gpt-realtime-2.1",
        },
        run_config={
            "model_settings": {
                "modalities": ["audio"],
                "output_audio_format": "pcm16",
                # 必須關閉: 預設開啟的輸入音訊轉寫本 API 暫不支援, 不關閉工作階段會被 1008 關閉
                "input_audio_transcription": None,
            },
        },
    )
    async with session:
        await session.send_message("What is the capital of France?")
        async for event in session:
            if getattr(event, "type", "") == "raw_model_event":
                data = getattr(event, "data", None)
                if getattr(data, "type", "") == "transcript_delta":
                    print(getattr(data, "delta", ""), end="", flush=True)
                elif getattr(data, "type", "") == "turn_ended":
                    print("\n[本輪完成]")
                    return

asyncio.run(main())

# 用 wscat 快速驗證連線性與鑑權（需先 npm i -g wscat）
wscat -c "wss://aihubmix.com/v1/realtime?model=gpt-realtime-2.1" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

# 連線成功後，貼上一幀 session.update 設定，再發文字訊息 + response.create 即可開始