> 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/mo-xing-yu-ding-jia/mo-xing-yu-mo-xing-id.md).

# 模型與模型 ID

ApiSmart 透過統一的 API 平台，提供對支援的語言、圖片與影片模型的存取。

在送出請求之前，請選擇適合你的使用情境的模型，並複製其精確的 **模型 ID**。Model ID 會決定由哪個模型處理請求。

***

### 🤖 瀏覽可用模型

開啟 ApiSmart 的 [**模型**](https://www.apismart.ai/models) 頁面並選擇一個類別：

* 全部
* 大型語言模型（LLM）
* 圖片生成
* 影片生成

你可以在以下之間切換： **卡片檢視** 與 **列表檢視** 依照你偏好的方式瀏覽模型。

<figure><img src="/files/5313188a637317f8a55efbff364b0865a9b770bd" alt=""><figcaption></figcaption></figure>

每張模型卡片可能會顯示：

* 模型名稱
* 供應商
* 模型類別
* 計費模式
* 價格摘要
* 功能標籤
* **檢視詳細資料**
* **比較模型**

<figure><img src="/files/7f3897f901c2cfc63ba6b0aa582cee21a771e85c" alt=""><figcaption></figcaption></figure>

***

### 篩選模型列表

使用可用的篩選條件，將結果縮小為：

* **計費模式**
* **供應商**
* **上下文長度**
* **價格範圍**
* **排序選項**

對於語言模型，Context Length 表示模型在一次請求中可處理多少內容。圖片與影片模型可能會顯示 `不適用`.

> 💡 較低的列出價格不一定代表較低的總請求成本。實際成本取決於所選模型與請求設定。

***

### 比較模型

選擇 **比較模型** 在模型卡片上，並排檢視適合的模型。

<figure><img src="/files/dda6e102c5f2d45c5b34cdd8a4ccbee1cc5bf231" alt=""><figcaption></figcaption></figure>

比較以下因素：

* 供應商
* 模型類別
* 功能
* 上下文長度
* 計費模式
* 價格設定

<figure><img src="/files/535ec180f60484b3cfca6b0d46838f386858d3bb" alt=""><figcaption></figcaption></figure>

先將比較檢視作為初步參考，然後在整合模型之前選擇 **檢視詳細資料** 。

***

### 開啟模型詳細資訊

選擇 **檢視詳細資料** 以檢視完整的模型資訊。

<figure><img src="/files/01cf65130d49b302bc60e9070a524b72f8cf0bd6" alt=""><figcaption></figcaption></figure>

根據不同模型，詳細資訊頁面可能包含：

* 模型說明
* 功能
* 發佈日期
* 價格設定
* 程式碼範例
* 快速整合資訊（若有）

頁面頂部顯示的模型名稱，可能與 API 所需的 Model ID 不同。

例如：

```
顯示名稱：DeepSeek-V4-Flash.DeepSeek
Model ID：     DEEPSEEK_V4_FLASH
```

***

### 🔍 找出 Model ID

Model ID 通常可在詳細資訊頁面上的兩個位置找到。

#### 程式碼範例

請尋找指派給 `model` 欄位的值：

```python
data = {
    "model": "DEEPSEEK_V4_FLASH",
    "messages": [
        {
            "role": "user",
            "content": "哈囉！"
        }
    ]
}
```

在此範例中，Model ID 是：

```
DEEPSEEK_V4_FLASH
```

#### 快速整合

此項 **快速整合** 區段也可能顯示 Model ID。

請勿：

* 將其替換為顯示名稱
* 更改大小寫字母
* 移除底線、連字號或句點
* 加入多餘的空格

> ⚠️ **重要：** Model ID 是區分大小寫的。

***

### 在請求中使用 Model ID

#### 文字模型範例

```python
{
  "model": "DEEPSEEK_V4_FLASH"
}
```

替換 `DEEPSEEK_V4_FLASH` 請使用所選模型的程式碼範例中顯示的精確 Model ID。

如需完整的請求範例，請參閱 [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-wan-cheng-api.md), [**圖片生成 API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)，或 [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md).

***

### 使用正確的端點與請求格式

不同的模型類別使用不同的端點與請求結構。

請務必參考模型的 **程式碼範例** ，再進行整合。

| 模型類別 | 端點                       | 常見請求欄位                         |
| ---- | ------------------------ | ------------------------------ |
| 語言   | `/v1/chat/completions`   | 使用 `messages` 以及支援的語言 Model ID |
| 圖片   | `/v1/images/generations` | 使用模型專屬的圖片生成欄位                  |
| 影片   | `/v1/video/tasks`        | 建立非同步影片任務                      |

> ⚠️ **重要：** 請務必使用模型的 **程式碼範例**.

***

### 💰 在選擇前先檢視定價

在選擇模型之前，請先檢視其 **計費模式** 與 **價格設定**.

定價可能會依模型、輸入類型、輸出類型、解析度、時長或其他模型專屬設定而有所不同。

詳情請參閱 [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md).

***

### 🛠️ 疑難排解 Model ID 與請求錯誤

如果模型請求失敗，請先確認：

* Model ID 是從模型的 **程式碼範例**
* 未將顯示名稱用作 Model ID
* 大小寫與標點符號均未變更
* 正在使用正確的端點
* 請求欄位與所選模型相符
* 模型目前可用

範例：

```
顯示名稱：DeepSeek-V4-Flash.DeepSeek
Model ID：     DEEPSEEK_V4_FLASH
```

錯誤：

```
{  "model": "DeepSeek-V4-Flash.DeepSeek"}
```

正確：

```
{  "model": "DEEPSEEK_V4_FLASH"}
```

如果 Model ID 與請求格式都正確，但請求仍然失敗，請檢查你的 **API Token 狀態、剩餘可用額度、目前餘額，以及使用記錄**.

***

### 🚀 下一步

繼續進行：

* [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md)
* [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-wan-cheng-api.md)
* [**圖片生成 API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)
* [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)
* [**快速入門**](/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-ru-men.md)
* [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md)
