Як використовувати реальне обличчя в Seedance 2.5 з активами реальних людей AIHubMix

AI-відео стає набагато кориснішим, коли людина на екрані залишається впізнаваною з однієї сцени в іншу. Реальні активи AIHubMix на основі згоди забезпечують спосіб використання затвердженого обличчя в генерації відео Seedance, зберігаючи авторизацію, обробку активів і генерацію як окремі, перевіряємi етапи.

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

Що таке відео реальних людей?

Відео реальних людей — це AI-генероване відео, яке використовує уповноважену особу як ідентифікаційне посилання. Модель може змінювати обстановку, одяг, дії, рух камери, голос або мову, зберігаючи впізнаваний вигляд людини.

Це відрізняється від звичайної генерації відео з тексту. Текстовий запит описує, що має відбутися, але не може надійно ідентифікувати конкретну реальну особу. Реальний актив надає моделі затверджене візуальне посилання, яке можна повторно використовувати в кількох відео.

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

Як працює робочий процес AIHubMix

Робочий процес має п’ять основних етапів:

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

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

Чому використовувати AIHubMix?

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

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

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

Людина на портреті завершує сторінку авторизації. Це створює чіткий етап згоди перед використанням зображення як повторно використовуваного посилання на реальну людину.

Повторно використовувані активи ідентичності

Після того, як зображення стає активним, програми можуть повторно використовувати його ID активу в кількох запитах на відео, замість того щоб завантажувати оригінальне зображення щоразу.

Генерація, готова до 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: Створіть групу активів реальних людей

Виконайте цю команду в терміналі:

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\":\"Реалістичний вертикальний влог. Людина усміхається, махає і говорить японською: やっほー！今日も笑顔でね！ Зберігайте обличчя послідовним, синхронізуйте рух губ, використовуйте природні рухи рук і не додавайте субтитри.\",
    \"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} до завершення завдання, а потім швидко завантажте вихід, оскільки 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. Почніть з одного затвердженого портрету та короткого тестового кліпу, а потім розширте той же робочий процес на інструменти творців, контент бренду та виробничі програми.