逐步設定您的 API 金鑰

Ava 無需帳號。她依賴您自有的 API 金鑰運作，您直接向各供應商付費使用量。本指南將說明有哪些金鑰、每項金鑰解鎖的功能以及如何申請。若您僅申請一項，請優先申請 Qwen 金鑰。

各金鑰功能說明

• Qwen (Alibaba Cloud)：默認採用 Maestro 風格進行對話，並支援圖片、語音旁白及影片。建議從這裡開始。
• DeepSeek：啟用 Supernova 風格，結合 DeepSeek 與 Qwen 處理更繁重的任務。使用 Supernova 需同時擁有兩組金鑰。
• Mistral：採用 Aurora 風格，獨立運行於 Mistral 模型之上，目前以 Mistral Large 4 為主導。
• Brave Search：選配項目，用於提升網頁搜尋品質。若無此金鑰，Ava 將預設使用 DuckDuckGo。

「設定」>「API 金鑰」頁面亦支援輸入 Kimi、GLM、Xiaomi MiMo、Tencent Hunyuan、NVIDIA 及 MiniMax 的金鑰，以便您自行選擇其模型。每一欄位旁均提供直達該供應商金鑰申請頁面的連結。

您的 Qwen 金鑰

1. 登入（或建立）Alibaba Cloud 帳戶，並開啟 Model Studio API Key 頁面：modelstudio.console.alibabacloud.com/ap-southeast-1/settings/api-key
2. 確認右上角區域標示為 Singapore。金鑰僅在其生成區域內有效，而 Ava 連線至新加坡節點。
3. 點擊 Create API Key，保留預設工作區，將權限設定為 All，然後點擊 OK。
4. 立即複製金鑰：Alibaba 後續將不再顯示該金鑰。
5. 在 Ava 中開啟設定，進入 API Keys，將其貼上至 Qwen (Alibaba) 旁。

您的 DeepSeek 金鑰（用於 Supernova）

1. 前往 platform.deepseek.com 註冊。此處為 API 平台，與 DeepSeek 聊天網站不同。
2. 在 Top up 下充值。餘額未超過零之前，請求將會失敗。
3. 開啟 API Keys，建立新金鑰並立即複製：金鑰僅顯示一次。
4. 在設定 > API Keys 中將其貼上至 DeepSeek 旁，隨後在模型選擇器中選取 Supernova。

您的 Mistral 金鑰（用於 Aurora）

1. 登入 console.mistral.ai 並為您的工作區設定計費，或若提供則選擇免費的 Experiment 方案。
2. 開啟 API Keys 並點擊 Create new key。設定名稱，如需亦可設定有效期。
3. 立即複製：Mistral 僅顯示一次完整金鑰。
4. 在設定 > API Keys 中將其貼上至 Mistral AI 旁，隨後在模型選擇器中選取 Aurora。

Brave Search 金鑰（選配）

Brave 能讓 Ava 獲得比預設更佳、更新鮮的網頁搜尋結果。請於 api-dashboard.search.brave.com 註冊，選擇 Search 方案，並於 API Keys 下建立金鑰。由於 Brave 的方案與每月額度可能會變動，請務必查看其儀表板上的最新條款，並設定使用上限以避免意外扣款。

希望能完全零費用？

使用 Ollama 或 LM Studio 在本機運行模型，並將 Ava 指向該本地服務。無需金鑰、無需計費，數據也不會流出您的設備。但圖片、語音旁白及影片仍需 Qwen 金鑰。

在本機免費運行 Ava

確保金鑰安全

• Ava 將您的金鑰儲存於本機作業系統的金鑰串列中。每組金鑰僅傳輸至所屬的供應商，絕不會傳送給我們。
• VS Code 擴充功能與桌面應用程式共用同一個金鑰庫，因此在其中一方新增的金鑰，在另一方也能使用。
• 金鑰相當於您與該服務商帳戶的密碼。切勿將其貼上至對話、電子郵件或 Discord。Ava 團隊絕不會向您索取此金鑰。
• 若金鑰洩漏，請在服務商的控制台中刪除它並建立新金鑰。舊金鑰將立即失效。

為何 Ava 採用自帶金鑰模式