連線與使用

呼叫失敗或對話中斷時，先用最小請求確認三件事：驗證、端點路徑及模型可用性。

無法連接平台？

請檢查：

• API 金鑰是否設定正確，且沒有多餘空白或換行。
• Base URL 是否正確，且沒有重複路徑。
• 端點路徑是否符合用戶端協定，例如 OpenAI 用戶端應使用 OpenAI 相容路徑。
• 本機網路、公司代理、防火牆、DNS 或 HTTPS 檢查是否封鎖請求。
• 金鑰是否已到期、被刪除，或屬於受限制帳戶。

OpenAI 相容呼叫可用最小非串流請求測試：

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

若最小請求仍失敗，通常是網路、驗證、路徑設定、模型權限或帳戶狀態問題。

已選模型卻沒有回應或發生錯誤？

常見原因：

• 模型 ID 錯誤，或與平台模型清單不符。
• 模型暫時不可用，或金鑰無權使用。
• 請求格式無效，例如欄位名稱、巢狀結構或型別錯誤。
• 帳戶餘額不足、上下文過長、輸出過長或服務逾時。
• 第三方用戶端未正確處理串流或錯誤回應。

從控制台或模型清單複製正確 ID，先測試最小主體，再逐步加回上下文與參數。

對話發生錯誤或斷線時怎麼辦？

先找出失敗位置：

• 請求開始前：檢查驗證、路徑、模型與參數。
• 串流期間：檢查用戶端逾時、代理鏈及 SSE 解析。
• 上下文或輸出很長時：檢查請求大小、輸出限制及服務逾時。

建議處理方式：

1. 閱讀具體錯誤欄位。
2. 暫時改用非串流，以區分模型失敗與串流解析失敗。
3. 對 429、網路不穩及部分 5xx 錯誤加入退避重試。
4. 重試時附上必要上下文，不要假設伺服器保有對話狀態。
5. 若問題持續，記錄 X-Request-ID。