Відео, створене ШІ, стає значно корисніším, коли людина на екрані залишається впізнаваною від сцени до сцени. Реальні людські асети 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-URL зображення. URL має повертати файл зображення без входу в систему чи власних заголовків і залишатися доступним, поки 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: Додайте портрет
Надішліть прямий 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\":\"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. - Асет обробляється: опитуйте початковий ID асета; не створюйте дублікати з новим ID.
- URL зображення не працює: використовуйте публічний HTTPS-URL файлу, а не локальний шлях, сторінку входу чи сторінку спільного доступу.
- Відео відхиляє асет: переконайтеся, що асет має статус
active, належить до того самого облікового запису і має правильний тип медіа. - Playground не показує
asset://: завантаження зображень у Playground і реєстрація реальних людських асетів є окремими робочими процесами. Для зареєстрованих асетів використовуйте поле посилання з API-довідника.
Фінальний чек-лист
- API-ключ налаштовано безпечно.
- Групу асетів створено.
- Авторизацію людини завершено.
- Статус групи —
active. - Статус асета портрета —
active. - Запит на відео використовує
asset://<asset_id>. - Завдання генерації відео опитується до статусу
completed.
Реальні людські асети AIHubMix дають розробникам практичний спосіб створювати відео на основі згоди та зі стабільною ідентичністю за допомогою Seedance. Почніть з одного затвердженого портрета і короткого тестового кліпу, а потім масштабуйте той самий робочий процес на інструменти для креаторів, брендовий контент і продакшн-застосунки.
