🧩 常見問題與排查

本頁面彙整了 NextAI 使用過程中的常見問題與解決方案，
幫助你快速定位問題、恢復正常使用。

🔌 網路與連線問題

無法連線網路或請求逾時
- 請確認裝置已成功連網（Wi-Fi 或行動數據）。
- 若網路正常但仍顯示逾時，可能是服務商伺服器暫時不可用，請稍後再試。
- 部分地區存取海外 API（如 OpenAI）可能受限，可在 設定 → 通用設定 → 網路代理 中配置代理。
網路代理未生效
- 若已開啟代理，請確認 NextAI 已獲得系統網路存取權限；
- 建議使用 HTTP 或 SOCKS5 代理，並確保位址與連接埠正確。

🔑 模型與 API 設定問題

API Key 錯誤
- 請重新複製並貼上 Key，確認無多餘空格或換行；
- 若仍報錯，可嘗試重置 Key 或於服務商控制台重新生成。
Base URL 填寫錯誤
- 請填寫模型服務的介面位址（例如 https://api.openai.com/v1），
  而非網站或控制台連結。
- 可參考 API 設定說明章節。
新增後仍提示「請先新增模型提供方」
- 請檢查提供方是否 已啟用；
- Base URL 與 Key 是否正確；
- 目前網路是否可連線該網域（部分企業／校園網路可能限制外部 API）。

📦 匯出與檔案問題

圖片或 PDF 匯出失敗
- 請確認 NextAI 已獲得檔案讀寫權限；
- 若仍失敗，可嘗試切換網路或重新啟動應用後再匯出；
- 匯出內容較多時請稍候數秒，避免切換至背景運行。
附件無法上傳
- 請確認檔案大小未超過限制（通常 10MB 以內）；
- 若為圖片，請確認格式為 JPG 或 PNG。

⚠️ 錯誤碼速查表

錯誤碼	含義	處理建議
400	參數錯誤 / 請求格式不正確	檢查輸入或模型設定是否符合要求
401	API Key 無效或未授權	重新設定 Key 或檢查權限
403	禁止存取（帳號或區域受限）	更換網路或聯絡服務商
404	路徑錯誤	檢查 Base URL 是否完整（含 `/v1`）
429	請求過多（限速）	降低請求頻率或提升配額
500	伺服器內部錯誤	稍後重試或切換模型
503	服務暫時不可用	等待數分鐘後再次嘗試

🌐 網路排查技巧

開啟手機瀏覽器，直接訪問模型 API 位址（如 https://api.openai.com/v1）；
若無法開啟，代表當前網路被封鎖；
可切換至家庭網路／行動熱點，或在設定中啟用代理；
若仍異常，請執行「刪除提供方 → 重新新增」操作以重置設定。

💬 回饋與支援

若以上方法仍無法解決問題，請前往
👉 問題回饋頁面
提交詳細資訊（包含錯誤碼與截圖），我們將儘快協助處理。