> 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-jia-ge/mo-xing-yu-mo-xing-id.md). # 模型與模型 ID 了解 ApiSmart 模型 ID 的運作方式、取得最新模型清單，並為您的 API 請求選擇支援的文字、圖片與影片模型。 ApiSmart 透過統一 API 提供文字、圖片和影片模型的存取。 每個生成請求都必須包含有效的 `模型` 值。模型 ID 會精確比對，因此請務必使用文件中記載的 ID，或在整合模型前先取得最新的系統模型清單。 ### 🧩 模型 ID 此 `模型` 參數會指定由哪個模型處理你的請求。 例如： ```json { "model": "deepseek-v4-flash" } ``` 模型 ID 具有 **區分大小寫且對格式敏感**。句點（`.`）、連字號（`-`）、以及版本號都必須完全一致。 例如： ``` glm-5.1 gpt-5.6-luna doubao-seedance-2-0-fast doubao-seedream-5-0 ``` 請勿變更： ``` glm-5.1 ``` 改為： ``` glm-5-1 ``` 或： ``` doubao-seedance-2-0-fast ``` 改為： ``` doubao-seedance-2.0-fast ``` ApiSmart 不會自動修正或為模型 ID 建立別名。錯誤撰寫的模型 ID 可能導致非預期的 `503`，因此在排查與模型相關的請求時，請逐字元核對模型 ID。 ### 🔍 取得最新模型清單 若要取得目前的系統模型清單，請使用： **方法：** `GET` **端點：** `/v1/models` 範例： ```bash curl https://gw.apismart.ai/v1/models \ -H "Authorization: Bearer " ``` 回應使用與 OpenAI 相容的清單格式： ```json { "object": "list", "data": [ { "id": "doubao-seedream-5-0", "object": "model", "owned_by": "api-gateway" }, { "id": "deepseek-v4-flash", "object": "model", "owned_by": "api-gateway" } ] } ``` 請使用： ``` data[].id ``` 作為 `模型` 支援的 API 請求中的值。 {% hint style="info" %} **模型可用性可能會隨時間變更。**\ 請使用 `GET /v1/models` 當你需要最新的系統模型清單時。 {% endhint %} ### 🔑 模型可用性與 API 金鑰存取權 出現在以下內容中的模型： ``` GET /v1/models ``` 並不 **一定表示該模型已為你的 API 金鑰啟用**. 如果所選模型存在，但你的帳戶無法使用，API 可能會回傳： ``` 403 model_not_allowed ``` 在這種情況下，請選擇你帳戶可用的模型，或聯絡 [**ApiSmart Support**](/documentation/zh-tw/shuo-ming-yu-zi-yuan/lian-luo-zhi-yuan.md) 以取得存取權限。 ### 💬 文字模型 文字模型使用與 OpenAI 相容的： ``` POST /v1/chat/completions ``` 端點。 目前 ApiSmart API 規格中記載的文字模型 ID 如下： | 模型系列 | 模型 ID | | ------------ | ------------------------ | | **DeepSeek** | `deepseek-v3.2` | | | `deepseek-v4-flash` | | | `deepseek-v4-pro` | | **GLM** | `glm-5` | | | `glm-5.1` | | | `glm-5.2` | | | `glm-5-turbo` | | **GPT** | `gpt-5.4` | | | `gpt-5.4-mini` | | | `gpt-5.4-nano` | | | `gpt-5.6-luna` | | | `gpt-5.6-sol` | | | `gpt-5.6-terra` | | **Kimi** | `kimi-k2.5` | | | `kimi-k2.6` | | | `kimi-k2.7-code` | | | `kimi-k3` | | **MiniMax** | `minimax-m2.5` | | | `minimax-m2.5-highspeed` | | | `minimax-m2.7` | | | `minimax-m3` | | **Qwen** | `qwen3.5-397b-a17b` | | | `qwen3.6-plus` | | | `qwen3.7-max` | 這些 ID 來自目前的 API 規格。請使用 `GET /v1/models` 當你需要驗證最新的系統清單時。 如需請求範例與串流行為，請參閱 [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-bu-quan-api.md). ### 🖼️ 圖片模型 目前的圖片生成模型是： | 模型 | 模型 ID | | ---------------- | --------------------- | | **Seedream 5.0** | `doubao-seedream-5-0` | 請搭配以下內容使用： ``` POST /v1/images/generations ``` 若要進行本機圖片上傳與編輯，請使用文件中記載於 [**Image Generation API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md). 目前的 API 規格將 `doubao-seedream-5-0` 指定為圖片生成模型。 ### 🎬 影片模型 影片生成透過以下非同步任務進行： ``` POST /v1/video/tasks ``` 建立任務後，請使用以下方式查詢其狀態： ``` GET /v1/video/tasks/{id} ``` 目前影片生成包含 HappyHorse 與 Seedance 模型系列。 #### HappyHorse | 模型 | 模型 ID | | ------------------ | ---------------- | | **HappyHorse 1.0** | `happyhorse-1.0` | | **HappyHorse 1.1** | `happyhorse-1.1` | HappyHorse 支援多種影片生成工作流程，包括在支援時的影片編輯。 #### Seedance | 模型 | 模型 ID | | --------------------- | -------------------------- | | **Seedance 2.0** | `doubao-seedance-2.0` | | **Seedance 2.0 Fast** | `doubao-seedance-2-0-fast` | | **Seedance 2.0 Mini** | `doubao-seedance-2-0-mini` | | **Seedance 2.5** | `doubao-seedance-2-5` | 支援的解析度、輸入、工作流程與計費會因影片模型而異。 如需這些詳細資訊，請參閱 [**Video Generation API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md) 與 [**Model Pricing and Billing**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md). ### 🔀 模型與端點相容性 請將正確的模型類型搭配正確的 API 端點使用： | 工作負載 | 端點 | 模型類型 | | ---- | ----------------------------- | ------- | | 文字生成 | `POST /v1/chat/completions` | 文字模型 | | 圖片生成 | `POST /v1/images/generations` | 圖片模型 | | 圖片編輯 | `POST /v1/images/edits` | 支援的圖片模型 | | 影片生成 | `POST /v1/video/tasks` | 影片模型 | 即使 Model ID 有效，若與不相容的端點搭配使用，仍可能失敗。 例如： ``` 403 model_not_image_capable ``` 表示所選模型無法與圖片生成 API 一起使用。 ``` 403 model_not_video_capable ``` 表示所選模型無法與影片生成 API 一起使用。 ### ⚠️ 常見模型錯誤 | 錯誤 | 意義 | 檢查項目 | | ----------------------------- | ---------------- | ---------- | | `403 model_not_allowed` | 此模型不適用於你的 API 金鑰 | 模型存取權 | | `403 model_not_image_capable` | 模型不支援圖片生成 | 模型與端點 | | `403 model_not_video_capable` | 模型不支援影片生成 | 模型與端點 | | `503` 在變更模型後 | 模型 ID 可能不正確 | 句點、連字號與版本號 | 如果你遇到非預期的模型錯誤，請先取得模型清單並精確比對 ID： ```bash curl https://gw.apismart.ai/v1/models \ -H "Authorization: Bearer " ``` 如需進一步排查，請參閱 [**模型與請求錯誤**](/documentation/zh-tw/yi-nan-pai-jie/mo-xing-yu-qing-qiu-cuo-wu.md) 或 [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md). ### 💰 模型價格 模型價格與計費方式會因工作負載與模型而異。 例如，文字、圖片與影片模型不一定使用相同的計費方式。 為了將模型選擇與價格規則分開，此頁面不重複列出各模型的價格。 請參閱 [**Model Pricing and Billing**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) 以查看目前的計費資訊。 ### ✅ 使用模型前 在送出請求前，請確認 Model ID 與文件記載或由 `GET /v1/models`回傳的內容完全一致，且該模型與你所選的端點相容，並且你的 API 金鑰有權存取它。 將模型整合到正式環境應用程式時，請避免假設系統模型清單會永遠保持不變。 ### ➡️ 下一步 * [**Model Pricing and Billing**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) — 了解各模型的專屬價格 * [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-bu-quan-api.md) — 使用文字模型 * [**Image Generation API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md) — 使用圖片模型 * [**Video Generation API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md) — 使用影片模型 * [**模型與請求錯誤**](/documentation/zh-tw/yi-nan-pai-jie/mo-xing-yu-qing-qiu-cuo-wu.md) — 排查模型與請求失敗