影片模型

POST /v1/videos 上共有 12 個模型。它們共用同一套請求 schema，差異只在於單段時長、畫面尺寸、可用比例和每秒單價。從下表挑一個，把它的 ID 填進 model 欄位即可。

能力矩陣

模型 ID	模式	解析度（預設）	時長	畫面比例	起價 $/秒
`alibaba/happyhorse-1.0`	t2v · i2v · v2v	`720p` `1080p`（`1080p`）	3–15 秒	A	0.13
`alibaba/happyhorse-1.1`	t2v · i2v	`720p` `1080p`（`1080p`）	3–15 秒	A	0.13
`alibaba/wan-2.6`	t2v · i2v	`720p` `1080p`（`1080p`）	2–15 秒	A	0.10
`alibaba/wan-2.7`	t2v · i2v · v2v	`720p` `1080p`（`1080p`）	2–15 秒	A	0.10
`alibaba/wan-3.0`	t2v · i2v · v2v	`480p` `720p` `1080p`（`1080p`）	2–30 秒	C	0.054
`alibaba/wan-3.0-prime`	t2v · i2v · v2v	`480p` `720p` `1080p`（`1080p`）	2–30 秒	C	0.064
`bytedance/seedance-2.0`	t2v · i2v · v2v	`480p` `720p` `1080p` `4k`（`1080p`）	4–15 秒	B	0.07
`bytedance/seedance-2.0-fast`	t2v · i2v · v2v	`480p` `720p`（`720p`）	4–15 秒	B	0.06
`bytedance/seedance-2.0-mini`	t2v · i2v · v2v	`480p` `720p`（`720p`）	4–15 秒	B	0.04
`bytedance/seedance-2.5`	t2v · i2v · v2v	`480p` `720p` `1080p`（`720p`）	4–30 秒	D	0.11
`minimax/hailuo-3`	t2v · i2v · v2v	`768p` `2k`（`768p`）	4–15 秒	D	0.08
`minimax/hailuo-3-max`	t2v · i2v · v2v	`480p` `768p`（`768p`）	5–15 秒	D	0.05

模式 —— t2v 文生影片，i2v 圖生影片，v2v 影片生影片。請求裡不需要傳模式，系統依是否攜帶 frame_images 或 input_references 隱式判定。詳見模式判定。

畫面比例集合 —— 後一組包含前一組：

集合	取值
A	`16:9` `9:16` `1:1`
B	A + `adaptive`
C	B + `4:3` `3:4`
D	C + `21:9`

音訊 —— 12 個模型全部支援同步音軌，generate_audio 預設為 true。

起價 $/秒 取自 pricing.output_video_per_second，是該模型的最低級距，不是你實際付的價格。真正計費的是 pricing.video_pricing.tiers 中匹配到的級距，隨解析度、輸入類型和音訊而變。任務完成後，以回應裡的 usage.video_seconds 與 usage.video_cost 為實際計費秒數和費用。詳見按秒計價。

`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.io/v1/models \
  | jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'

Python

video_models.py


import requests
 
models = requests.get("https://api.ofox.io/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.io/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)
}

本頁是一份快照。新模型上線不跟著文件一起發版，需要最新清單時請直接查詢該端點。

按需求選型

需求	模型
單次任務出 30 秒	`alibaba/wan-3.0`、`alibaba/wan-3.0-prime`、`bytedance/seedance-2.5`
4K 輸出	`bytedance/seedance-2.0`
2K 輸出	`minimax/hailuo-3`
不足 4 秒的短片	全部 `alibaba/*` 模型（下限 2 秒或 3 秒）
影片生影片	除 `alibaba/happyhorse-1.1` 和 `alibaba/wan-2.6` 外的全部模型
電影感 `21:9`	`bytedance/seedance-2.5`、`minimax/hailuo-3`、`minimax/hailuo-3-max`
起價最低	`bytedance/seedance-2.0-mini`，$0.04/秒

下一步

建立影片任務供應商路由 Video API 概覽