動画モデル

POST /v1/videos では 12 のモデルを提供しています。リクエストのスキーマはすべて共通で、違うのはクリップの長さ、フレームサイズ、受け付けるアスペクト比、1秒あたりの料金です。表から1つ選び、その 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 があるかどうかから推定されます。生成モードをご覧ください。

アスペクト比セット — 各セットは1つ上のセットを含みます：

セット	値
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 で、そのモデルの最安 tier であり、実際に支払う価格ではありません。課金されるのは 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.run/v1/models \
  | jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'

Python

video_models.py


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

このページはスナップショットです。モデルはドキュメントのリリースを待たずに追加されるため、常に最新の一覧が必要な場合はエンドポイントを直接クエリしてください。

要件から選ぶ

要件	モデル
1回のタスクで 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 概要