> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/yu-shi-yu-lian-xian-wen-ti.md).

# 逾時與連線問題

當您的應用程式無法在預期時間內建立連線、維持請求或收到回應時，就會發生逾時與連線問題。

這些問題通常與網路狀況、用戶端設定、請求持續時間或暫時性的服務可用性有關。

在疑難排解前，請先檢查：

* 中的請求狀態 [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)
* HTTP 狀態碼
* 錯誤訊息
* 請求時間

如需一般 API 錯誤，請參閱 [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md).

***

### 檢查您的網路連線

在變更程式碼之前，請先確認：

* 您的伺服器可以存取 ApiSmart API 端點。
* DNS 解析可正常運作。
* 您的網路連線穩定。
* 防火牆或安全性規則未封鎖外送請求。

常見的網路相關問題：

* 無法連線到 API 端點
* 連線重設
* DNS 解析失敗
* SSL/TLS 連線錯誤

***

### 檢查用戶端逾時設定

在 ApiSmart 完成處理請求之前，您的應用程式可能就停止等待了。

檢視：

* HTTP 用戶端逾時設定
* Proxy 或閘道逾時設定
* 無伺服器函式執行限制

例如：

```python
timeout=60
```

對於需要較長處理時間的請求來說，可能還不夠。

請依照您的應用程式需求增加逾時時間。

***

### 請求逾時

可能在以下情況發生逾時：

* 網路連線速度緩慢。
* 用戶端逾時時間太短。
* 請求需要更長的處理時間。
* 服務暫時忙碌。

建議的處理方式：

1. 稍待片刻後重新嘗試該請求。
2. 確認該請求是否出現在 [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md).
3. 在送出另一個請求之前，先確認該請求是否已完成。

避免立即重複送出請求，尤其是生成類任務。

***

### Chat、Image 與 Video 請求差異

不同的 API 類型可能有不同的回應時間。

#### 聊天完成

聊天請求通常會直接返回。

如果請求花費太久：

檢查：

* 輸入大小
* 模型選擇
* 用戶端逾時設定

***

#### 圖片生成

圖片生成可能需要額外的處理時間。

如果請求逾時：

檢查：

* 該請求是否出現在使用記錄中。
* 是否已生成結果。
* 用戶端是否在收到回應前就已逾時。

***

#### 影片生成

影片生成通常是一個非同步工作流程。

在影片完成之前，請求可能會先回傳任務 ID。

典型流程：

```
建立影片任務
        ↓
接收任務 ID
        ↓
檢查任務狀態
        ↓
擷取結果
```

處理時間長不一定代表請求失敗。

在提交另一個請求之前，請先檢查任務狀態。

如需影片特定問題，請參閱：

[**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)

***

### 連線重設或連線失敗

如果連線中斷：

檢查：

* 網路穩定性
* 防火牆規則
* 伺服器外送存取
* 用戶端重試設定

常見原因：

* 暫時性網路中斷
* 請求被用戶端終止
* 中介 Proxy 或閘道逾時

***

### 暫時性的服務錯誤

某些連線問題可能只是暫時性的。

如果您收到：

* 502 錯誤的閘道
* 503 服務無法使用
* 連線重設

請嘗試：

1. 稍候片刻。
2. 重新嘗試該請求。
3. 檢查問題是否持續。

若反覆失敗，請儲存 Request ID 並聯絡支援。

***

### 檢查使用記錄

在疑難排解逾時問題時：

1. 開啟 **使用記錄**.

<figure><img src="/files/032362f2567318ac67465257328b78f6fb66a850" alt=""><figcaption></figcaption></figure>

2. 找出相關請求。
3. 檢查：

* 請求 ID
* 請求時間
* 模型 ID
* 狀態
* 錯誤訊息
* 費用

這有助於判斷：

* 該請求是否已送達 ApiSmart。
* 該請求是否在處理前就失敗。
* 該請求是否已完成，但用戶端逾時。

***

### 重試建議

在實作重試時：

建議：

* 只重試暫時性失敗。
* 在重試之間使用逐漸增加的延遲。
* 避免無限次重試。

避免：

* 立即重複失敗的請求。
* 建立重複的生成任務。
* 在未檢查前一個狀態的情況下重試請求。

***

### 何時聯絡支援

在以下情況請聯絡支援：

* 在檢查您的設定後，請求仍持續失敗。
* 相同的 Request ID 顯示出非預期的行為。
* 多個端點同時失敗。
* 使用記錄與您的請求結果不符。

請提供：

* 請求 ID
* API 端點
* 模型 ID
* 請求時間
* HTTP 狀態碼
* 錯誤訊息

請勿提供：

* 完整 API Token
* 帳戶密碼
* 付款資訊

> 🔐 絕不要向支援團隊提供您的完整 API Token。

***

### 🚀 下一步

繼續查看：

* [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
* [**API Token 與驗證問題**](/documentation/zh-tw/yi-nan-pai-jie/api-quan-zhang-yu-yan-zheng-wen-ti.md)
* [**模型與請求錯誤**](/documentation/zh-tw/yi-nan-pai-jie/mo-xing-yu-qing-qiu-cuo-wu.md)
* [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)
* [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)