동영상 모델

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 개요