Семейство Seedance

Модели генерации видео от ByteDance — всего четыре, вызываются через видеоэндпоинт 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.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "Лиса бежит по снегу, камера следует за ней",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Собака в кадре бежит к камере",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Бутон медленно раскрывается в пышную розу",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "Девушка с изображения 1 держит чашку с изображения 2 и улыбается у окна кафе",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Персонаж говорит с интонацией этой озвучки, операторская работа — как в этом видео",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

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

Референсы с реальными людьми

Официальный API Seedance от ByteDance не позволяет напрямую загружать референсные изображения или видео с лицами реальных людей. Официальная документация BytePlus Seedance 2.0  требует использовать разрешённые ассеты с изображением реальных людей, а руководство Volcano Engine Ark по библиотеке реальных людей  описывает шаги: отправка приглашения, проверка личности и выдача разрешения, загрузка материалов, приём разрешения и получение ID ассета.

{
  "model": "bytedance/seedance-2.0",
  "prompt": "Человек из кадра идёт по кинематографичному ночному рынку",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

• Перед отправкой OfoxAI выполняет предобработку референсов для защиты приватности. Это снижает число ложных отказов anti-deepfake-модерации upstream, но не гарантирует, что upstream примет задачу; задачи, отклонённые upstream, не тарифицируются.
• real_person — инструкция по обработке, а не подтверждение согласия. Отправляйте только изображения, на использование которых у вас есть законное право и согласие.
• Что делать, если изображение всё равно отклоняется, и коды ошибок предобработки — в разделе Референсы с реальными людьми.

Выбор провайдера

Чтобы закрепить провайдера, добавьте на верхнем уровне запроса:

"provider": { "type": "byteplus" }

Неверное значение provider.type возвращает 400 invalid_provider_type; если указанный провайдер не обслуживает модель — 400 provider_type_unavailable. Общее описание — в разделе Маршрутизация провайдеров для видео.

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

Если задача создана успешно, но завершилась неудачей на этапе генерации, запрос статуса вернёт status: "failed", а причина будет в поле error; таймаут соответствует error.code: "expired". Полный список кодов — в разделе Коды ошибок Video API.

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

• BytePlus Seedance 2.0: API генерации видео 
• Центр документации Volcano Engine Ark 
• OfoxAI · Создание задачи видео

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