> 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/mo-xing-yu-qing-qiu-cuo-wu.md).

# 模型與請求錯誤

排解 ApiSmart 模型 ID、不支援的模型、無效的請求參數、解析度錯誤以及模型特定的請求問題。

模型與請求錯誤通常會在模型 ID 不正確、模型使用了錯誤的端點，或請求參數不符合所選模型的要求時發生。

在重試請求前，請先檢查以下項目。

### 🧩 檢查模型 ID

ApiSmart 的模型 ID 必須完全一致。

句點（`.`）、連字號（`-`）、版本號，以及其他字元都不能更改。

例如：

```
glm-5.1
gpt-5.6-luna
doubao-seedance-2-0-fast
doubao-seedream-5-0
```

不要將句點替換為連字號，或更改版本格式。

錯誤寫法的模型 ID 可能導致非預期的 `503`，因此在變更模型後，請務必先驗證模型 ID。

你可以使用以下指令取得目前的模型清單：

```bash
curl https://gw.apismart.ai/v1/models \\
  -H "Authorization: Bearer <your-api-key>"
```

請使用回傳的 `data[].id` ，並完全依照提供的內容。

### 🔀 檢查模型與端點

有效的模型也必須支援你所呼叫的端點。

例如：

| 錯誤                            | 意義              |
| ----------------------------- | --------------- |
| `403 model_not_allowed`       | 此 API 金鑰無法使用該模型 |
| `403 model_not_image_capable` | 該模型不支援圖片生成 API  |
| `403 model_not_video_capable` | 該模型不支援影片生成 API  |
| `403 AccessDenied`            | 所請求的模型或操作不可用    |

請注意， `GET /v1/models` 會回傳系統模型清單，但這不代表每個回傳的模型都已為你的 API 金鑰啟用。

有關模型可用性與 ID，請參閱 [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md).

### ⚠️ 檢查請求主體

一個 `400` 回應通常表示請求格式或參數需要修正。

常見代碼包括：

| 代碼                       | 檢查項目       |
| ------------------------ | ---------- |
| `invalid_request_error`  | 必要參數或請求值   |
| `invalid_json`           | JSON 語法與格式 |
| `InvalidParameter`       | 模型特定的參數值   |
| `unsupported_resolution` | 所選模型支援的解析度 |

在重試前，請檢查：

* 必要參數，例如 `model` 與輸入內容
* JSON 語法
* 參數名稱與值的型別
* 該參數是否受所選模型支援
* 圖片、影片、解析度與輸入限制

不要在未變更無效輸入的情況下，反覆重試相同的 `400` 請求。

### 🖼️ 圖片請求問題

進行圖片生成時，請檢查所選模型與圖片輸入限制。

目前圖片輸入最多支援 **14 張參考圖片**，單張檔案大小上限為 **每張圖片 10 MB**。輸入與生成的圖片合計不得超過 15 張。

該 `大小` 參數也必須使用受支援的預設值或有效的像素尺寸。

完整需求請參閱 [**圖片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md).

### 🎬 影片請求問題

影片參數會因模型而異。

例如以下參數：

`長度`, `解析度`, `大小`, `內容`, `比例`, `圖片`, `圖片`，以及 `input_reference`

可能會因所選的 HappyHorse 或 Seedance 模型而有不同的適用方式。

如果你收到：

```
400 unsupported_resolution
```

請確認所要求的解析度是否受所選影片模型支援。

有關模型特定的輸入、解析度與工作流程，請參閱 [**影片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md).

### ✅ 快速疑難排解清單

當模型或請求失敗時：

1. 逐字元驗證模型 ID。
2. 確認該模型支援此端點。
3. 檢查 JSON 語法與必要參數。
4. 檢查模型特定的輸入與解析度限制。
5. 使用 `GET /v1/models` 來驗證目前的模型 ID。
6. 檢查項目 [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md) 如果問題持續存在。

如果問題與驗證、餘額或連線錯誤有關，請改參閱對應的疑難排解指南。

### ➡️ 下一步

* [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md)
* [**圖片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)
* [**影片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)
* [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
