ONOFF × DeepSeek 開通說明（網頁版・超詳盡）

目標：一次建立好 DeepSeek 的 API Key + 付費餘額，讓 ONOFF 可以長期穩定呼叫。
ONOFF 預設使用模型：deepseek-v4-flash，Base URL 預設為 https://api.deepseek.com。 因此你在 ONOFF 的進階選項通常 留空即可。
你在 DeepSeek 後台看到的流程常見是：API Keys → 立即複製 Key → Billing/Top up → 確認可用。
如果你遇到「模型沒開通 / Unpurchased」類錯誤，多半是 帳號付款資料或餘額未完成，不是你沒貼 Key。

步驟 0｜先確認你要用什麼（避免填錯）

  1. ONOFF 的 DeepSeek provider 會呼叫 deepseek-v4-flash。
  2. 金鑰字串通常以 sk- 開頭。
  3. 你在 ONOFF 內只需要貼：
    • API Key（必填）
    • Base URL / Model Name（一般留空）

步驟 1｜登入 DeepSeek 後台（platform.deepseek.com）

  1. 打開：https://platform.deepseek.com/
  2. 用你原本的帳號登入（可能是 Email / 電話 / 第三方）。也可以用 Google 帳號登入。
  3. 登入後先回到儀表板（Dashboard）或左側選單。
  4. 如果你看到「需要完成帳號驗證 / 驗證手機」之類提示：請先完成，再往下做。
DeepSeek 登入頁面
DeepSeek 開放平台登入頁面，右側輸入 Email / 手機號 + 密碼，或使用 Google 登入

步驟 2｜建立 API Key（這是 ONOFF 會用來打 API 的憑證）

  1. 在左側選單找到並點：API Keys（或「API keys / Keys」）。
  2. 確認你現在頁面是「管理 API key」的地方（會看到 Key 清單或 Create 按鈕）。
  3. 點按鈕：Create new API key（或 Create API key）。
  4. 填入「Key 名稱 / Name / Description」（建議你填：ONOFF 或 ONOFF-prod）。
    • 填什麼只是為了你之後找起來方便。
    • 不用影響 Key 的效能或模型。
  5. 按確認（Confirm / Generate / Create）。
  6. 立刻複製（非常重要）：
    • DeepSeek 通常只在「生成當下」顯示完整字串。
    • 複製後把視窗關掉也沒關係，但你要確定真的複製到了。
  7. 把 Key 存到密碼管理器（1Password / Bitwarden / iCloud 鑰匙串）或你自己的安全位置。

步驟 3｜確保你的帳號可用（Billing / Top up / 餘額）

  1. 在左側選單找到：Billing（或 Balance / Top up / Payments）。
  2. 確認狀態不是「未完成付款 / 尚未驗證」。
  3. 若需要添加付款方式：
    1. 選信用卡 / PayPal / 你可用的方式。
    2. 填地址、手機號碼、完成手機驗證（如果系統要求）。
    3. 按 Save/Submit 完成綁定。
  4. 為了讓模型呼叫成功，你通常需要先有餘額（Top up / Add credits）。
    1. 點 Top up 或 Add credits
    2. 選擇金額（建議先選小額測試）
    3. 完成付款
  5. 回到儀表板確認：Balance 顯示為可用餘額（大於 0）。

步驟 4｜確認你能呼叫 deepseek-v4-flash（避免已配 Key 但模型仍不可用）

DeepSeek Models & Pricing
DeepSeek API Docs — Models & Pricing 頁面，確認 deepseek-v4-flash 模型可用
  1. 在後台找到「模型列表 / Model / Marketplace（若有）」。
  2. 搜尋：deepseek-v4-flash。
  3. 確認該模型的狀態是「可用 / Active / Enabled」。
    • 如果有 Enable / Activate 開關：請打開。
    • 如果顯示「需付款 / Unpurchased」：回到步驟 3 完成付款或餘額。
  4. 確認沒有選到你不打算使用的版本（例如某些 Preview 可能有不同方案/Key）。

步驟 5｜（可選）用簡單測試確認 Key 正常

DeepSeek API Docs
DeepSeek API Docs — Your First API Call，確認 base_url 和 model 參數
  1. 如果你願意，先在本機用 curl 做一次最小測試。
  2. 把下面命令中的 YOUR_DEEPSEEK_KEY 換成你剛複製的 Key（只做一次測試即可）。
curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_DEEPSEEK_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role":"user","content":"ping"}],
    "stream": false
  }'
若你拿到正常 JSON 回應，表示 Key 與 endpoint 大致沒問題。

步驟 6｜回 ONOFF，把 Key 填進去並測試

  1. 在 ONOFF 的模型設定頁，選 provider：DeepSeek。
  2. 在 API Key 欄位貼上你剛才的 sk-... 金鑰。
  3. 進階選項（Advanced optional）：
    • Base URL：留空
    • Model Name：留空
  4. 點 Test Model。
  5. 顯示連線成功 → 點 Save。

步驟 7｜常見錯誤怎麼對應（你遇到哪個就做哪個）

  1. 模型沒開通 / Unpurchased：
    • 回步驟 3：確認 Billing 已完成、餘額已補足。
    • 如果有「Free quota only / 限免費」類開關：請關掉（讓它用付費呼叫）。
  2. 401 / invalid api key：
    • 你的 Key 可能貼錯（漏字、少字、空白）、或已撤銷。
    • 重新複製一次並貼回。
    • 確認是 sk- 開頭的 Key。
  3. 403 permission：
    • 模型可能需要特定權限/方案。
    • 回步驟 4：確認 deepseek-v4-flash 的狀態是 Enabled。
  4. Base URL 不匹配（通常只有你手動填了進階選項才會發生）：
    • 最安全：把進階選項留空，回到預設。
安全提醒（必讀）
1) 不要把 DeepSeek API Key 傳給任何人、也不要貼公開群組。
2) 如果你懷疑 Key 外流：立即刪除/撤銷該 Key，重新生成新的 Key 並更新 ONOFF。
3) 不要硬編碼 Key 到程式碼或前端 bundle（ONOFF 會加密儲存你的 Key）。