> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skiesoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 即時語音辨識 WebSocket 連線

> 建立 WebSocket 連線進行即時語音串流辨識。支援低延遲的即時文字轉錄功能。



## OpenAPI

````yaml api-reference/openapi.json get /speech/realtime
openapi: 3.1.0
info:
  title: 軟雲聽有 AI API
  description: Skiesoft「聽有 AI」語音辨識服務 API，支援國台英混合語言辨識、即時串流處理和語音轉文字功能。提供高準確度的語音辨識、說話者分離等進階功能。
  version: 1.0.0
  contact:
    name: 軟雲技術支援
    email: support@skiesoft.com
    url: https://skiesoft.com
  license:
    name: Proprietary
    url: https://skiesoft.com/terms-of-service
  termsOfService: https://skiesoft.com/terms-of-service
servers:
  - url: https://api.skiesoft.com/v1
security:
  - bearerAuth: []
tags:
  - name: 語音辨識
    description: 音訊轉錄和語音辨識功能，支援說話者分離
  - name: 即時語音辨識
    description: WebSocket 即時語音串流辨識，支援低延遲的即時文字轉錄
  - name: 帳號管理
    description: 帳號資訊和使用量查詢
paths:
  /speech/realtime:
    get:
      tags:
        - 即時語音辨識
      summary: 即時語音辨識 WebSocket 連線
      description: 建立 WebSocket 連線進行即時語音串流辨識。支援低延遲的即時文字轉錄功能。
      operationId: connectRealtimeTranscription
      parameters:
        - name: language
          in: query
          description: 語言代碼
          required: false
          schema:
            type: string
            default: mixed
            enum:
              - mixed
              - zh-TW
              - zh-CN
              - en-US
        - name: sampleRate
          in: query
          description: 音訊採樣率
          required: false
          schema:
            type: integer
            default: 16000
            minimum: 8000
            maximum: 48000
        - name: encoding
          in: query
          description: 音訊編碼格式
          required: false
          schema:
            type: string
            default: LINEAR16
            enum:
              - LINEAR16
              - FLAC
              - MULAW
      responses:
        '101':
          description: WebSocket 連線升級成功
          headers:
            Upgrade:
              description: 協定升級為 WebSocket
              schema:
                type: string
                example: websocket
            Connection:
              description: 連線升級
              schema:
                type: string
                example: Upgrade
        '400':
          description: 請求格式錯誤
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: 身份驗證失敗
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 權限不足
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: 請求頻率過高
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
              description: 錯誤的人類可讀描述。
              example: 無效的 API 金鑰
            type:
              type: string
              description: 錯誤類型。
              example: invalid_request_error
            param:
              type: string
              description: 導致錯誤的參數（如果適用）。
              example: file
            code:
              type: string
              description: 錯誤代碼（如果適用）。
              example: invalid_api_key
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 使用 API 金鑰進行身份驗證。格式：Bearer YOUR_API_KEY

````