Семейство Wan и HappyHorse

Модели генерации видео от Alibaba — всего шесть, вызываются через видеоэндпоинт OfoxAI POST /v1/videos. Задачи выполняются асинхронно: после создания задачи вы получаете её ID и по нему запрашиваете результат.

Выбор модели

Все шесть моделей поддерживают текст в видео и изображение в видео, а также могут создавать синхронную звуковую дорожку (generate_audio по умолчанию true). adaptive означает сохранение пропорций входного изображения.

Таблица выше совпадает с video_attributes, которые возвращает Models API; если возможности модели изменятся, ориентируйтесь на ответ API. Оплата посекундная, фактическая стоимость определяется полем usage.video_cost в результате задачи; цены см. на странице модели .

Примеры вызова

Примеры ниже показывают только запрос на создание задачи. Полный процесс — запрос статуса и скачивание результата — описан в разделе Video API · Быстрый старт.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Утро в городке на воде в Цзяннане, лодка медленно проплывает под каменным мостом",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Человек в кадре разворачивается и уходит вдаль",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "Сохранить движение камеры и перевести изображение в стиль анимации тушью",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images и input_references нельзя передавать одновременно — это возвращает 400 references_conflict.
• Если звуковая дорожка не нужна, передайте "generate_audio": false.
• Полное описание структуры полей — в разделе Создание задачи видео.

Отличия от других семейств

• Отмена невозможна: после отправки задачи в upstream DELETE /v1/videos/{id} возвращает 400 cancel_not_supported, а задача продолжает генерироваться и тарифицируется. Проверяйте параметры перед отправкой.
• Ссылки на видео: в наших тестах завершённая задача возвращает только unsigned_urls (временные адреса Alibaba Cloud OSS), без mirror_urls. Временные адреса могут перестать работать через 24 часа — скачайте и сохраните видео заранее.
• Более короткая длительность: минимум у Wan — 2 секунды, у HappyHorse — 3 секунды, у других семейств — 4 секунды.

Отключение водяного знака

Собственные параметры моделей Alibaba передаются через provider.options.dashscope:

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options передаётся только совпавшему провайдеру, другие провайдеры его не получают. Подробнее — в разделе Маршрутизация провайдеров для видео.

Распространённые ошибки

Полный список кодов — в разделе Коды ошибок Video API.

Официальная документация

• Alibaba Cloud Model Studio · Документация по сервисам моделей 
• OfoxAI · Создание задачи видео

Часто задаваемые вопросы