Как использовать реальное лицо в Seedance 2.5 с помощью реальных человеческих ассетов AIHubMix

Видео, созданное ИИ, становится гораздо полезнее, когда человек в кадре остаётся узнаваемым от сцены к сцене. Реальные человеческие ассеты AIHubMix предоставляют основанный на согласии способ использовать одобренное лицо в генерации видео Seedance, при этом авторизация, обработка ассета и генерация остаются отдельными, проверяемыми этапами.

В этом руководстве объясняется, что такое видео с реальным человеком, как работает процесс AIHubMix, зачем он нужен и как создать видео Seedance 2.5 из реального лица. Также объясняется разница между нативным API Seedance 2.5 и совместимыми интеграциями Seedance 2.0.

Что такое видео с реальным человеком?

Видео с реальным человеком — это видео, созданное ИИ, которое использует авторизованного человека в качестве референса личности. Модель может менять обстановку, одежду, действие, движение камеры, голос или язык, сохраняя узнаваемую внешность человека.

Это отличается от обычной генерации видео по тексту. Текстовый промпт описывает, что должно происходить, но надёжно не идентифицирует конкретного реального человека. Реальный человеческий ассет даёт модели одобренный визуальный референс, который можно повторно использовать в нескольких видео.

Типичные применения включают аватары создателей контента, виртуальных ведущих, объяснительные ролики о продуктах, локализованные кампании, обучающие видео, брендовых персонажей и короткий контент для социальных сетей.

Как работает процесс AIHubMix

Процесс состоит из пяти основных этапов:

Создайте группу ассетов для одного человека.
Попросите человека на изображении пройти процедуру авторизации.
Добавьте портрет и дождитесь, пока ассет станет активным.
Сошлитесь на активный ассет с помощью URI asset://.
Отправьте задачу генерации видео Seedance и опрашивайте её до завершения.

Это разделение намеренное. Авторизация происходит до генерации, готовность ассета можно проверять независимо, а каждый важный этап предоставляет статус, который ваше приложение может отслеживать.

Зачем использовать AIHubMix?

Один API для всего процесса

AIHubMix предоставляет эндпоинты для групп ассетов, сессий верификации, человеческих ассетов и асинхронной генерации видео. Один и тот же аккаунт и API-ключ могут управлять всем конвейером.

Явная авторизация

Человек на портрете проходит страницу авторизации. Это создаёт понятный этап согласия до того, как изображение будет использовано как многократно применяемый реальный референс человека.

Многократно используемые ассеты личности

После того как изображение становится активным, приложения могут повторно использовать его ID ассета в нескольких запросах на генерацию видео, вместо того чтобы каждый раз загружать исходное изображение.

Генерация, готовая для Seedance

Нативный эндпоинт Seedance 2.5 поддерживает референсы в виде текста, изображений, видео и аудио, а также параметры длительности, разрешения, соотношения сторон и генерации звука.

Наблюдаемые состояния, удобные для продакшена

Ваше приложение может дождаться статусов verified, active и completed, а не гадать, завершилась ли операция. Это упрощает реализацию повторных попыток и обработки ошибок.

Пошаговое руководство

Шаг 1: Подготовьте API-ключ и портрет

Создайте API-ключ в AIHubMix Console. Храните его в секрете. В Terminal задайте его как переменную окружения:

export AIHUBMIX_API_KEY="your_api_key"

Подготовьте прямую HTTPS-ссылку на изображение. По ссылке должен возвращаться файл изображения без входа в систему и пользовательских заголовков, и ссылка должна оставаться доступной, пока AIHubMix её обрабатывает.

Рекомендуемые требования к изображению:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC или HEIF
Менее 30 МБ
Ширина и высота больше 300 пикселей и меньше 6000 пикселей
Соотношение сторон больше 0.4 и меньше 2.5
Чёткий портрет того же человека, который проходит авторизацию

Шаг 2: Создайте группу реальных человеческих ассетов

Выполните эту команду в Terminal:

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

Сохраните возвращённый id, который выглядит как ag_...:

GROUP_ID="ag_your_group_id"

Новая группа обычно начинается со статуса pending_auth.

Шаг 3: Создайте сессию авторизации

Используйте ID группы, чтобы запросить сессию верификации:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Ответ содержит временный verification_url. Откройте этот URL в браузере и попросите человека на портрете ознакомиться с целью и пройти процедуру авторизации.

Этот URL конфиденциален и временен. Не публикуйте его, не добавляйте в репозиторий и не включайте в скриншоты.

Шаг 4: Проверьте статус авторизации и группы

После того как человек завершит процедуру в браузере, запросите оба ресурса:

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Продолжайте только тогда, когда сессия верификации имеет статус verified, а группа ассетов — active. Страница ошибки в браузере не определяет итоговый результат; ориентируйтесь на статус из API.

Шаг 5: Добавьте портрет

Отправьте прямую ссылку на изображение:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

Сохраните возвращённый ID ассета и опрашивайте его:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Используйте ассет только когда его статус active. Статусы creating и processing означают, что он ещё не готов.

Шаг 6: Сгенерируйте видео Seedance 2.5

Реальный человеческий ассет указывается в input_references[].url. Его не нужно вставлять в текст промпта:

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

Ответ возвращает ID задачи видео. Опрашивайте GET /ai/v1/videos/{id}, пока задача не получит статус completed, затем скачайте результат без промедления, так как ссылки на видео временные.

Seedance 2.5 и Seedance 2.0

Seedance 2.5 использует нативный эндпоинт /ai/v1/videos, описанный выше. Более старые интеграции могут использовать Seedance 2.0 с совместимым протоколом /v1/videos и другой структурой контента.

Не смешивайте два формата запросов. Перед использованием в продакшене проверьте актуальную схему модели на предмет поддерживаемых длительностей, разрешений, типов референсов, поведения аудио и путей эндпоинтов.

Лучшие практики составления промптов

Опишите окружение, действие, тайминг, движение камеры, голос и ограничения. Удачный промпт может задавать кимоно, падающие лепестки сакуры, мягкое покачивание, японскую речь, синхронизированное движение губ, естественное движение волос и отсутствие субтитров.

Пять секунд хорошо подходят для короткого приветствия. Если видео включает несколько действий или длинное предложение, используйте большую длительность или сократите сценарий, чтобы выступление не выглядело торопливым.

Для простого теста используйте один референс личности. Добавляйте дополнительные референсы, только если схема модели их поддерживает и каждый ассет принадлежит той же группе ассетов.

Частые проблемы

Группа не активна: дождитесь, пока сессия верификации получит статус verified, а группа — active.
Ассет обрабатывается: опрашивайте исходный ID ассета; не создавайте дубликаты с новым ID.
Ссылка на изображение не работает: используйте публичную HTTPS-ссылку на файл, а не локальный путь, страницу входа или страницу публикации.
Видео отклоняет ассет: убедитесь, что ассет имеет статус active, принадлежит тому же аккаунту и имеет правильный тип медиа.
Playground не показывает asset://: загрузка изображений в Playground и регистрация реальных человеческих ассетов — это разные процессы. Для зарегистрированных ассетов используйте поле референса в API.

Итоговый чек-лист

API-ключ настроен безопасно.
Группа ассетов создана.
Авторизация человека завершена.
Статус группы: active.
Статус ассета портрета: active.
Запрос на видео использует asset://<asset_id>.
Задача видео опрашивается до статуса completed.

Реальные человеческие ассеты AIHubMix дают разработчикам практичный способ создавать основанные на согласии видеоэкспириенсы с сохранением личности с помощью Seedance. Начните с одного одобренного портрета и короткого тестового клипа, затем расширьте тот же процесс на инструменты для создателей контента, брендовый контент и производственные приложения.