---
title: 模型選擇
description: 根據輸入方式、時長、清晰度和計費型別選擇模型。
icon: clapperboard
---

黑豬AI會持續同步可用影片模型。模型名稱、上下架狀態、描述、支援時長和公開價格以 [模型廣場](https://api.heizhu.lol/pricing) 為準。

## 選擇順序

<Steps>
  <Step title="確認輸入方式">
    先確認任務是文生影片、圖生影片，還是需要參考音訊或影片。只有模型描述明確支援的素材型別才能使用。
  </Step>
  <Step title="確認時長">
    有些模型僅支援固定秒數，有些支援一個時長範圍。`video_duration` 必須與模型能力匹配。
  </Step>
  <Step title="確認清晰度與比例">
    根據模型名稱和說明選擇 `480p`、`720p` 或 `1080p`，並確認所需畫面比例受到支援。
  </Step>
  <Step title="確認計費型別">
    區分按次和按秒計費，再正確填寫 `duration` 與 `video_duration`。
  </Step>
</Steps>

## 不要只依賴模型名稱

模型名稱可能包含版本、比例、清晰度、固定時長或線路資訊，但並非所有能力都能僅從名稱可靠推斷。正式接入時應同時讀取模型廣場描述。

| 檢查項 | 需要確認的內容 |
| --- | --- |
| 輸入 | 文字、圖片、音訊、影片及支援數量 |
| 時長 | 固定時長、最小時長和最長時長 |
| 輸出 | 解析度、比例、是否帶聲音 |
| 計費 | `/次` 或 `/秒`，以及當前公開售價 |
| 可用性 | 模型是否已上架並可被當前 Token 呼叫 |

## 自動同步

模型可能自動上新、更新或下架。應用不應把模型清單永久硬編碼在前端：

- 使用 `GET /v1/models` 獲取當前 Token 可呼叫的模型。
- 在需要展示價格時，引導使用者檢視模型廣場。
- 對模型不存在或已下架的錯誤提供可理解的提示。
- 儲存任務時記錄實際模型名稱，便於後續排查。

<Tip>
批次生產前先用少量任務驗證提示詞、素材、時長和成本，再逐步擴大併發。
</Tip>