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

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

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

Какво е видео с истински хора?

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

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

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

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

Работният процес има пет основни етапа:

1. Създайте група активи за един човек.
2. Помолете човека на изображението да завърши процеса на авторизация.
3. Добавете портрет и изчакайте активът да стане активен.
4. Справете се с активния актив с asset:// URI.
5. Изпратете задача за видео в Seedance и проверявайте докато не завърши.

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

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

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

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

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

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

Многократно използваеми активи за идентичност

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

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

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

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

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

Стъпка по стъпка наръчник

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

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

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: Създайте група активи с истински хора

Изпълнете тази команда в терминала:

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

Запазете върнатото 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"
  }'

Запазете върнатото 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\":\"Реалистичен вертикален влог. Човекът се усмихва, маха и казва на японски: やっほー！今日も笑顔でね！ Запазете лицето последователно, синхронизирайте движението на устните, използвайте естествени движения на ръцете и не добавяйте субтитри.\",
    \"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.
• Активът се обработва: проверявайте оригиналното ID на актива; не създавайте дубликати с ново ID.
• URL адресът на изображението не работи: използвайте публичен HTTPS файл URL, а не локален път, страница за вход или страница за споделяне.
• Видеото отхвърля актива: уверете се, че активът е active, принадлежи на същия акаунт и използва правилния тип медия.
• Playground не показва asset://: Качването на изображение в Playground и регистрацията на активи с истински хора са отделни работни процеси. Използвайте полето за референция на API за регистрирани активи.

Краен списък за проверка

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

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