Как да използвате реално лице в Seedance 2.5 с real-human асети на AIHubMix

Видеото, генерирано с AI, става далеч по-полезно, когато човекът на екрана остава разпознаваем от една сцена към следваща. Real-human асетите на AIHubMix предоставят основан на съгласие начин за използване на одобрено лице в генерирането на видео със Seedance, като оторизацията, обработката на асета и генерирането остават отделни, проверими стъпки.

Това ръководство обяснява какво е real-human видео, как работи процесът на AIHubMix, защо е полезен и как да създадете видео със Seedance 2.5 от реално лице. Също така обяснява разликата между нативния API на Seedance 2.5 и съвместимите интеграции със Seedance 2.0.

Какво е real-human видео?

Real-human видеото е генерирано с AI видео, което използва оторизирано лице като референция за самоличност. Моделът може да променя обстановката, облеклото, действието, движението на камерата, гласа или езика, като запазва разпознаваемия външен вид на човека.

Това се различава от обикновеното генериране на видео от текст. Текстовият промпт описва какво трябва да се случи, но не идентифицира надеждно конкретно реално лице. Real-human асетът дава на модела одобрена визуална референция, която може да се използва повторно в множество видеа.

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

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

Процесът има пет основни етапа:

Създайте група от асети за един човек.
Помолете човека на снимката да премине през процеса на оторизация.
Добавете портрет и изчакайте асетът да стане активен.
Посочете активния асет с URI от вида asset://.
Изпратете задача за видео със Seedance и проверявайте статуса ѝ, докато приключи.

Разделението е умишлено. Оторизацията се случва преди генерирането, готовността на асета може да се проверява независимо и всеки важен етап показва статус, който вашето приложение може да следи.

Защо да използвате AIHubMix?

Един API за целия процес

AIHubMix предоставя крайни точки за групи от асети, сесии за верификация, human асети и асинхронно генериране на видео. Същият акаунт и API ключ могат да управляват целия процес.

Изрична оторизация

Човекът на портрета попълва страницата за оторизация. Това създава ясна стъпка на съгласие, преди изображението да бъде използвано като многократно използваема real-human референция.

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

След като изображението стане активно, приложенията могат да използват повторно неговия asset ID в множество заявки за видео, вместо да качват оригиналното изображение всеки път.

Генериране, готово за Seedance

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

Наблюдаеми състояния, подходящи за продукция

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

Ръководство стъпка по стъпка

Стъпка 1: Подгответе API ключ и портрет

Създайте API ключ в AIHubMix Console. Пазете го поверителен. В Terminal го задайте като променлива на средата:

export AIHUBMIX_API_KEY="your_api_key"

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

Препоръчителни изисквания към изображението:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC или HEIF
Под 30 MB
Ширина и височина над 300 пиксела и под 6000 пиксела
Съотношение на страните над 0.4 и под 2.5
Ясен портрет на същия човек, който извършва оторизацията

Стъпка 2: Създайте група от real-human асети

Изпълнете тази команда в 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: Добавете портрета

Изпратете директния 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 и проверявайте статуса му:

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\":\"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, след което изтеглете резултата навреме, тъй като URL адресите на видеата са временни.

Seedance 2.5 и Seedance 2.0

Seedance 2.5 използва нативната крайна точка /ai/v1/videos, описана по-горе. По-старите интеграции може да използват Seedance 2.0 със съвместимия протокол /v1/videos и различна структура на съдържанието.

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

Най-добри практики при промптове

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

Пет секунди работят добре за кратък поздрав. Ако видеото включва няколко действия или дълго изречение, използвайте по-голяма продължителност или скъсете текста, за да не изглежда изпълнението забързано.

За прост тест използвайте една референция за идентичност. Добавяйте допълнителни референции само когато схемата на модела ги поддържа и всеки асет принадлежи към същата група от асети.

Чести проблеми

Групата не е активна: изчакайте сесията за верификация да стане verified, а групата да стане active.
Асетът се обработва: проверявайте статуса на оригиналния asset ID; не създавайте дубликати с нов ID.
URL адресът на изображението не работи: използвайте публичен HTTPS URL към файл, а не локален път, страница за вход или страница за споделяне.
Видеото отхвърля асета: потвърдете, че асетът е active, принадлежи към същия акаунт и използва правилния тип медия.
Playground не показва asset://: качването на изображения в Playground и регистрирането на real-human асети са отделни процеси. Използвайте полето за референция в API документацията за регистрирани асети.

Финален контролен списък

API ключът е конфигуриран сигурно.
Групата от асети е създадена.
Оторизацията на човека е завършена.
Статусът на групата е active.
Статусът на портретния асет е active.
Заявката за видео използва asset://<asset_id>.
Задачата за видео се проверява, докато стане completed.

Real-human асетите на AIHubMix дават на разработчиците практичен начин да създават основани на съгласие видео преживявания с последователна идентичност чрез Seedance. Започнете с един одобрен портрет и кратко тестово видео, след което разширете същия процес към инструменти за създатели на съдържание, брандово съдържание и производствени приложения.