使用 API Key、OpenAI 兼容语音转写与第三方工具接入

在所有兼容 OpenAI 语音协议的客户端中，统一使用以下核心配置参数：

以下主流生产力工具与 AI 客户端均原生支持 OpenAI 语音转写协议，可在 1 分钟内完成 Vowise 接入：

在 **Orca** 中，只需在运行 Orca 服务的机器上创建或编辑 `~/.orca/speech-config.json`，桌面端与手机端（Mobile Web）聊天输入框的麦克风按钮即可直接调用 Vowise 转写与词典纠错：

{
  "apiKey": "vowise_YOUR_API_KEY",
  "baseUrl": "https://api.vowise.com/v1",
  "model": "vowise-pro",
  "language": "zh"
}

在 **Paseo** 中，编辑 `~/.paseo/config.json` 中的 `providers.openai` 与 `features.dictation` 字段并重启 daemon：

{
  "providers": {
    "openai": {
      "apiKey": "vowise_YOUR_API_KEY",
      "baseUrl": "https://api.vowise.com/v1"
    }
  },
  "features": {
    "dictation": {
      "enabled": true,
      "stt": {
        "provider": "openai",
        "model": "vowise-pro",
        "language": "zh"
      }
    }
  }
}

你可以直接使用 `curl` 在终端测试，或在自己的脚本中直接使用 OpenAI 官方 Python / Node.js SDK：

curl -X POST "https://api.vowise.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer vowise_YOUR_API_KEY" \
  -F "[email protected]" \
  -F "model=vowise-pro" \
  -F "language=zh"

from openai import OpenAI

client = OpenAI( base_url="https://api.vowise.com/v1", api_key="vowise_YOUR_API_KEY", )

with open("sample.wav", "rb") as audio: tx = client.audio.transcriptions.create( model="vowise-pro", file=audio, language="zh", ) print(tx.text) ```

文档可以展示请求结构，但示例和截图应始终使用占位符，不要包含真实密钥、可复用密码或内部私有 URL。