Как использовать реальное лицо в Seedance 2.5 с активами Real-Human от AIHubMix

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

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

Что такое реальное видео?

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

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

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

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

Рабочий процесс состоит из пяти основных этапов:

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

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

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

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

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

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

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

Повторно используемые активы идентичности

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

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

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

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

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

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

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

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

export AIHUBMIX_API_KEY="your_api_key"

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

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

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

Шаг 2: Создайте группу активов Real-Human

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

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Мой актив Real-Human"}'

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

GROUP_ID="ag_your_group_id"

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

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

Используйте идентификатор группы для запроса сессии проверки:

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: Добавьте портрет

Отправьте прямой URL изображения:

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"
  }'

Сохраните возвращенный идентификатор актива и опрашивайте его:

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

Актив Real-Human должен находиться в 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\":\"Реалистичный вертикальный влог. Человек улыбается, машет и говорит на японском: やっほー！今日も笑顔でね！ Сохраните лицо в одном и том же виде, синхронизируйте движение губ, используйте естественное движение рук и не добавляйте субтитры.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

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

Seedance 2.5 и Seedance 2.0

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

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

Лучшие практики запросов

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

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

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

Распространенные проблемы

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

Итоговый контрольный список

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

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