Видеомодели

На POST /v1/videos обслуживаются двенадцать моделей. Все они принимают одну и ту же схему запроса — различаются длина ролика, размер кадра, допустимые соотношения сторон и цена за секунду. Выберите модель в матрице и передайте её ID в поле model.

Матрица возможностей

Режимы — t2v текст в видео, i2v изображение в видео, v2v видео в видео. Режим передавать не нужно: он определяется по тому, содержит ли запрос frame_images или input_references. См. Режим генерации.

Наборы соотношений — каждый набор включает предыдущий:

Аудио — все двенадцать моделей создают синхронизированную звуковую дорожку; generate_audio по умолчанию равен true.

Объект 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"]
}

Запрос актуального списка

Models API — публичный эндпоинт, API Key не нужен. Отфильтруйте по supported_endpoints, чтобы оставить только видеомодели:

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

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"])

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)
}

Выбор по требованию

Далее