Websocket STS (智能实时对话）

{ "Command": "Finish" }

{
  "NotificationType": "<类型>",
  "TaskId":  "<会话 ID>",
  "<对应字段>": { ... }
}

{
  "NotificationType": "Handshake",
  "TaskId": "app123-xxxxxxxx",
  "HandshakeResult": {
    "Code": 0,
    "Message": "success",
    "Format": "pcm",
    "SampleRate": 16000,
    "Channels": 1,
    "BitDepth": 16,
    "InputFormat": "pcm",
    "InputSampleRate": 16000
  }
}

{
  "NotificationType": "AsrResult",
  "TaskId": "app123-xxxxxxxx",
  "AsrResult": {
    "Text": "你好，现在天气怎么样",
    "SteadyState": true,
    "SentenceId": 3,
    "StartPtsTime": 12.36,
    "EndPtsTime": 14.02
  }
}

{
  "NotificationType": "LLMResult",
  "TaskId": "app123-xxxxxxxx",
  "LLMResult": {
    "Text": "现在是",
    "Finished": false,
    "SentenceId": 3
  }
}

{
  "NotificationType": "ProcessEof",
  "TaskId": "app123-xxxxxxxx",
  "ProcessEofInfo": {
    "Code": 0,
    "Message": "finish"
  }
}

POST {baseURL}/chat/completions?taskId={taskId}
Authorization: Bearer {apiKey}
Content-Type:  application/json
Accept:        text/event-stream

{
  "model": "your-model-name",
  "stream": true,
  "temperature": 0.7,
  "messages": [
    { "role": "system",    "content": "你是一位乐于助人的语音助手。" },
    { "role": "user",      "content": "你好" },
    { "role": "assistant", "content": "你好呀，有什么我可以帮你的吗？" },
    { "role": "user",      "content": "上海今天天气怎么样？" }
  ]
}

data: {"id":"...","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}

data: {"id":"...","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"好"},"finish_reason":null}]}

data: {"id":"...","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]


{
  "error": {
    "code": "invalid_api_key",
    "message": "invalid api key",
    "type": "authentication_error"
  }
}

POST https://llm.example.com/v1/chat/completions?taskId=1258344699-wsss2s-xxxx HTTP/1.1
Authorization: Bearer sk-your-key
Content-Type: application/json
Accept: text/event-stream

{
  "model": "your-model-name",
  "stream": true,
  "messages": [
    { "role": "system", "content": "你是一位乐于助人的语音助手。" },
    { "role": "user",   "content": "上海今天天气怎么样？" }
  ]
}

HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {"choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{"content":"上海"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{"content":"今天多云，"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{"content":"最高 28℃。"},"finish_reason":null}]}

data: {"choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]


{"NotificationType":"LLMResult","LLMResult":{"Text":"上海","Finished":false,"SentenceId":1}}
{"NotificationType":"LLMResult","LLMResult":{"Text":"今天多云，","Finished":false,"SentenceId":1}}
{"NotificationType":"LLMResult","LLMResult":{"Text":"最高 28℃。","Finished":false,"SentenceId":1}}
{"NotificationType":"LLMResult","LLMResult":{"Text":"","Finished":true,"SentenceId":1}}

▶ Client → Server  (WS Upgrade)
  wss://mps.cloud.tencent.com/sts/v1/1258344699/
      ?inputFormat=pcm&inputSampleRate=16000
      &outputFormat=pcm&outputSampleRate=16000
      &lang=zh&voice=xxx
      &timeoutSec=30
      &secretId=AKIDxxx&nonce=1234567890
      &timeStamp=1783603200&expired=1783606800
      &signature=<hex>

◀ Server → Client  (Text)
  { "NotificationType":"Handshake", "TaskId":"...",
    "HandshakeResult":{"Code":0,"Message":"success",
      "Format":"pcm","SampleRate":16000,"Channels":1,"BitDepth":16,
      "InputFormat":"pcm","InputSampleRate":16000} }

▶ Client → Server  (Binary × N)   ← 16kHz/16bit/mono PCM

◀ Server → Client  (Text)
  { "NotificationType":"AsrResult", "TaskId":"...",
    "AsrResult":{"Text":"你好","SteadyState":false,"SentenceId":1} }

◀ Server → Client  (Text)
  { "NotificationType":"AsrResult", "TaskId":"...",
    "AsrResult":{"Text":"你好呀","SteadyState":true,"SentenceId":1,
                 "StartPtsTime":1.20,"EndPtsTime":2.05} }

◀ Server → Client  (Text)
  { "NotificationType":"LLMResult", "TaskId":"...",
    "LLMResult":{"Text":"你好，","Finished":false,"SentenceId":1} }

◀ Server → Client  (Text)
  { "NotificationType":"LLMResult", "TaskId":"...",
    "LLMResult":{"Text":"很高兴见到你。","Finished":false,"SentenceId":1} }

◀ Server → Client  (Text)
  { "NotificationType":"LLMResult", "TaskId":"...",
    "LLMResult":{"Text":"","Finished":true,"SentenceId":1} }

◀ Server → Client  (Binary × M)   ← TTS 音频帧

◀ Server → Client  (Binary, length=0)  ← SentenceEnd 边界

▶ Client → Server  (Text)
  { "Command":"Finish" }

◀ Server → Client  (Text)
  { "NotificationType":"ProcessEof", "TaskId":"...",
    "ProcessEofInfo":{"Code":0,"Message":"finish"} }

✖ Server closes WebSocket