使用文件 / 開始使用
第一次設定
ZeroType 只需要知道兩件事:要連到哪個 AI provider,以及要用哪個金鑰。
最後更新
兩個必填項目
- 要連到哪個 AI provider(OpenAI、Groq、Azure OpenAI 或任何 OpenAI 相容服務)
- 要用哪個金鑰
最簡單的方式是在偏好設定裡填寫,ZeroType 會把它寫進 appsettings.Local.json,金鑰本體則存進 Windows 認證管理員或 macOS 鑰匙圈。
最快的設定路徑
如果你已經有 OpenAI 金鑰:
- 打開偏好設定(Windows 從系統匣選
設定 ZeroType,macOS 從選單列選ZeroType 偏好設定)。 - 在「模型設定」頁選擇供應商(例如 OpenAI),填入 API base 與金鑰名稱,按金鑰下拉選單的
新增金鑰...把金鑰存進 Windows 認證管理員或 macOS 鑰匙圈。 - 轉錄模型填供應商支援的轉錄模型(OpenAI 可用
gpt-transcribe或whisper-1);AI 校正模型填一個你帳號可用的對話模型。 - 按「測試連線」確認兩邊都通。
用設定檔設定
也可以直接編輯 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,我們會依實際行為更新文件。