使用文件 / 開始使用

第一次設定

ZeroType 只需要知道兩件事:要連到哪個 AI provider,以及要用哪個金鑰。

最後更新

兩個必填項目

  1. 要連到哪個 AI provider(OpenAI、Groq、Azure OpenAI 或任何 OpenAI 相容服務)
  2. 要用哪個金鑰

最簡單的方式是在偏好設定裡填寫,ZeroType 會把它寫進 appsettings.Local.json,金鑰本體則存進 Windows 認證管理員或 macOS 鑰匙圈。

最快的設定路徑

如果你已經有 OpenAI 金鑰:

  1. 打開偏好設定(Windows 從系統匣選 設定 ZeroType,macOS 從選單列選 ZeroType 偏好設定)。
  2. 在「模型設定」頁選擇供應商(例如 OpenAI),填入 API base 與金鑰名稱,按金鑰下拉選單的 新增金鑰... 把金鑰存進 Windows 認證管理員或 macOS 鑰匙圈。
  3. 轉錄模型填供應商支援的轉錄模型(OpenAI 可用 gpt-transcribe 或 whisper-1);AI 校正模型填一個你帳號可用的對話模型。
  4. 按「測試連線」確認兩邊都通。

用設定檔設定

也可以直接編輯 appsettings.Local.json。檔案是巢狀結構,常用的幾個區塊長這樣:

{
  "OpenAI": {
    "ApiBase": "https://api.openai.com/v1",
    "CredentialName": "預設 OpenAI"
  },
  "Transcription": {
    "Engine": "Remote",
    "Model": "gpt-transcribe",
    "ResponseFormat": "json"
  },
  "AiPrompt": {
    "Model": "gpt-4.1-mini",
    "Temperature": 0
  },
  "Input": {
    "Mode": "SmartPaste",
    "RecordingHotkey": "RightAlt"
  }
}

CredentialName 是金鑰的名字,不是金鑰本身;金鑰必須另外存進認證管理員或鑰匙圈。Input.RecordingHotkey 的預設值兩平台不同:Windows 是 RightAlt,macOS 是 RightOption。

整份檔案還有更多欄位,建議先從偏好設定存一次產生完整結構,再手動調整需要的值。

供應商怎麼選

需求 建議
想要最穩定的品質 OpenAI 或 Azure OpenAI
想要低延遲、成本低 Groq
想要完全本機辨識 macOS 26 以上選 Apple 裝置端轉錄
已經有自架服務 任何 OpenAI 相容端點都可以填

更多說明見 供應商與模型選用。

金鑰放哪裡才安全

不要把金鑰寫進 USER.md 或任何提示詞檔案。ZeroType 會拒絕含明文金鑰的提示詞,學習平台的同步 API 也會以 literal_api_key 拒絕。

下一步

第一次錄音

這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。