影片模型

POST /v1/videos 上的所有影片模型共用同一套請求結構，差異在於可接受的解析度、時長、畫面比例與生成模式。每個模型的這些能力由 Models API 返回的 video_attributes 物件描述，本頁說明該物件的欄位與查詢方法。

各模型的參數取值見系列頁：Seedance、Wan 與 HappyHorse、Hailuo。

`video_attributes` 物件

Models API 回應中的每個影片模型都帶有一個 video_attributes 物件，它是該模型可接受參數的權威描述。


{
  "modes": ["t2v", "i2v", "v2v"],
  "resolutions": ["480p", "720p", "1080p"],
  "default_resolution": "720p",
  "min_duration_seconds": 4,
  "max_duration_seconds": 30,
  "supports_audio": true,
  "aspect_ratios": ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "adaptive"]
}

欄位	類型	說明
`modes`	string[]	模型支援的生成模式：`t2v` 文生影片，`i2v` 圖生影片，`v2v` 以影片為參考。請求中不需傳入模式，由素材欄位判斷，見模式判定
`resolutions`	string[]	可接受的 `resolution` 取值，列表之外的值會被拒絕
`default_resolution`	string	請求同時省略 `resolution` 和 `size` 時套用的值
`min_duration_seconds`	number	`duration` 下限，單位秒
`max_duration_seconds`	number	`duration` 上限，單位秒
`supports_audio`	boolean	`generate_audio: true` 是否會生成音軌
`aspect_ratios`	string[]	可接受的 `aspect_ratio` 取值，`adaptive` 表示沿用輸入圖的比例

video_attributes 是單個模型在 resolution、duration、aspect_ratio 上的事實依據。建立影片任務裡列出的參數範圍是所有模型的聯集，因此在那裡合法的取值，仍可能被某個具體模型拒絕。

查詢即時清單

Models API 是公開端點，不需要 API Key。按 supported_endpoints 過濾即可只保留影片模型：

cURL

Terminal


curl -s https://api.ofox.ai/v1/models \
  | jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'

Python

video_models.py


import requests
 
models = requests.get("https://api.ofox.ai/v1/models").json()["data"]
 
for m in models:
    if "/v1/videos" in m.get("supported_endpoints", []):
        va = m["video_attributes"]
        print(m["id"], va["modes"], va["resolutions"], va["max_duration_seconds"])

TypeScript

video-models.ts


const resp = await fetch('https://api.ofox.ai/v1/models')
const { data } = await resp.json()
 
for (const m of data) {
  if (!m.supported_endpoints?.includes('/v1/videos')) continue
  const va = m.video_attributes
  console.log(m.id, va.modes, va.resolutions, va.max_duration_seconds)
}

新模型上線不會隨文件一起發布，需要最新清單時請直接查詢該端點。

下一步

Seedance 系列 Wan 與 HappyHorse 系列 Hailuo 系列建立影片任務供應商路由 Video API 概覽