> 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).

# 模型與請求錯誤

模型和請求錯誤通常發生於所選模型、API 端點或請求參數不符合所選模型的要求時。

開始疑難排解前，請將您的請求與所選模型的 **程式碼範例** 進行比較，並確認所有欄位和值均受支援。

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

***

### 檢查模型 ID

該 **模型 ID** 必須與所選模型詳細資料頁面上顯示的值完全相符。

檢查：

* 模型 ID 拼寫
* 大寫和小寫字元
* 連字號、底線和句點
* 模型目前是否可用

範例：

```
正確：
model-name-v1

錯誤：
Model-Name-V1
model_name_v1
```

模型 ID 區分大小寫，必須完全照原樣複製。

***

### 常見模型錯誤

#### 找不到模型

找不到模型錯誤通常表示：

* 模型 ID 不正確。
* 模型名稱複製錯誤。
* 所選模型無法使用。
* 請求使用了其他供應商的模型 ID。

檢查所選模型的 **程式碼範例** 並將模型 ID 替換為所提供的完全相符值。

***

#### 不支援的模型

某些模型支援不同的功能。

例如：

| 模型類型 | 支援的工作   |
| ---- | ------- |
| 文字模型 | 聊天或文字生成 |
| 影像模型 | 影像生成    |
| 影片模型 | 影片生成    |

將影像或影片模型搭配 Chat Completions 請求使用，可能會導致錯誤。

請一律使用所選模型支援的端點和請求格式。

***

### 檢查 API 端點

確認端點與您正在使用的 API 相符。

範例：

```
Chat Completions：
POST /v1/chat/completions

影像生成：
POST /v1/images/generations

影片生成：
POST /v1/video/tasks
```

常見端點問題：

* 使用錯誤的 API 路徑
* 缺少 `/v1`
* 將請求傳送至不支援的端點
* 對影像或影片模型使用 Chat 端點

***

### 檢查請求參數

請求欄位會因模型而異。

請勿假設參數可互換使用。

常見範例：

| 參數   | 可能的變化                           |
| ---- | ------------------------------- |
| 文字輸入 | `messages`, `prompt`, `content` |
| 影像大小 | `size`, `resolution`            |
| 影片輸入 | `prompt`, `content`             |
| 輸出設定 | 模型專屬選項                          |

請一律使用所選模型的 **程式碼範例**.

***

### 常見請求錯誤

#### 400 錯誤請求

通常原因如下：

* 缺少必要欄位
* JSON 格式無效
* 參數名稱不正確
* 不支援的參數值

檢查請求主體，並與模型範例進行比較。

***

#### 無效的參數值

當參數值不受支援時，請求可能會失敗。

範例：

* 不支援的解析度
* 無效的時長
* 格式不正確
* 不支援的選項

除非參數值列為所選模型支援的項目，否則請勿修改。

***

#### 請求格式與模型不符

不同模型可能需要不同的請求結構。

例如：

```json
{
  "prompt": "生成影像"
}
```

以及：

```json
{
  "content": [
    {
      "type": "text",
      "text": "生成影像"
    }
  ]
}
```

可能無法互換使用。

請使用所選模型的 **程式碼範例**.

***

### 檢查使用記錄

如果請求失敗：

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

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

2. 找出失敗的請求。
3. 檢視：

* 請求 ID
* 模型
* 狀態
* 錯誤訊息
* 請求詳細資料

使用此資訊判斷問題是否與模型、請求格式或帳戶設定有關。

***

### 何時聯絡支援團隊

若發生以下情況，請聯絡支援團隊：

* 相同的有效請求持續失敗。
* 所選模型範例無法運作。
* 錯誤訊息不明確。
* 模型似乎意外地無法使用。

請附上：

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

請勿提供：

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

> 🔐 切勿向支援團隊提供完整的 API Token。

***

### 🚀 後續步驟

繼續進行：

* [**選擇模型並尋找其模型 ID**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-yu-mo-xing-id.md)
* [**API 基礎知識**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md)
* [**HTTP 狀態碼和 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
* [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)
* [**餘額與使用限制問題**](/documentation/zh-tw/yi-nan-pai-jie/yueyu-shi-yong-xian-zhi-wen-ti.md)