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

# SenseAudio

SenseAudio 透過 OpenClaw 共用的 `tools.media.audio` 管線，轉錄傳入的音訊與語音備忘附件。OpenClaw 會將 multipart 音訊傳送到 OpenAI 相容的轉錄端點，並將回傳文字注入為 `{{Transcript}}` 加上一個 `[Audio]` 區塊。

| 屬性     | 值                                                |
| ------ | ------------------------------------------------ |
| 提供者 id | `senseaudio`                                     |
| 外掛     | bundled, `enabledByDefault: true`                |
| 合約     | `mediaUnderstandingProviders` (audio)            |
| 驗證環境變數 | `SENSEAUDIO_API_KEY`                             |
| 預設模型   | `senseaudio-asr-pro-1.5-260319`                  |
| 預設 URL | `https://api.senseaudio.cn/v1`                   |
| 網站     | [senseaudio.cn](https://senseaudio.cn)           |
| 文件     | [senseaudio.cn/docs](https://senseaudio.cn/docs) |

## 開始使用

<Steps>
  <Step title="設定你的 API 金鑰">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export SENSEAUDIO_API_KEY="..."
    ```
  </Step>

  <Step title="啟用音訊提供者">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      tools: {
        media: {
          audio: {
            enabled: true,
            models: [{ provider: "senseaudio", model: "senseaudio-asr-pro-1.5-260319" }],
          },
        },
      },
    }
    ```
  </Step>

  <Step title="傳送語音備忘">
    透過任何已連接的頻道傳送音訊訊息。OpenClaw 會將音訊上傳到 SenseAudio，並在回覆管線中使用轉錄文字。
  </Step>
</Steps>

## 選項

| 選項         | 路徑                                    | 說明                   |
| ---------- | ------------------------------------- | -------------------- |
| `model`    | `tools.media.audio.models[].model`    | SenseAudio ASR 模型 id |
| `language` | `tools.media.audio.models[].language` | 選用的語言提示              |
| `prompt`   | `tools.media.audio.prompt`            | 選用的轉錄提示              |
| `baseUrl`  | `tools.media.audio.baseUrl` or model  | 覆寫 OpenAI 相容的基底      |
| `headers`  | `tools.media.audio.request.headers`   | 額外的請求標頭              |

<Note>
  SenseAudio 在 OpenClaw 中僅支援批次 STT。Voice Call 即時轉錄會繼續使用支援串流 STT 的提供者。
</Note>

## 相關

* [媒體理解（音訊）](/zh-TW/nodes/audio)
* [模型提供者](/zh-TW/concepts/model-providers)
