Jak używać prawdziwej twarzy w Seedance 2.5 z zasobami real-human AIHubMix

Wideo generowane przez AI staje się znacznie bardziej przydatne, gdy osoba na ekranie pozostaje rozpoznawalna w kolejnych scenach. Zasoby real-human AIHubMix zapewniają oparty na zgodzie sposób użycia zatwierdzonej twarzy w generowaniu wideo Seedance, zachowując autoryzację, przetwarzanie zasobu i generowanie jako oddzielne, weryfikowalne etapy.

Ten przewodnik wyjaśnia, czym jest wideo z prawdziwym człowiekiem, jak działa przepływ pracy AIHubMix, dlaczego jest przydatny i jak utworzyć wideo Seedance 2.5 na podstawie prawdziwej twarzy. Wyjaśnia także różnicę między natywnym API Seedance 2.5 a kompatybilnymi integracjami Seedance 2.0.

Czym jest wideo z prawdziwym człowiekiem?

Wideo z prawdziwym człowiekiem to wideo wygenerowane przez AI, które wykorzystuje autoryzowaną osobę jako referencję tożsamości. Model może zmieniać otoczenie, ubiór, działanie, ruch kamery, głos lub język, zachowując rozpoznawalny wygląd tej osoby.

Różni się to od zwykłego generowania wideo z tekstu. Prompt tekstowy opisuje, co ma się wydarzyć, ale nie identyfikuje w wiarygodny sposób konkretnej prawdziwej osoby. Zasób real-human daje modelowi zatwierdzone odniesienie wizualne, które można wielokrotnie wykorzystywać w wielu wideo.

Typowe zastosowania obejmują awatary twórców, wirtualnych prezenterów, materiały wyjaśniające produkty, zlokalizowane kampanie, filmy szkoleniowe, postacie marki oraz krótkie treści do mediów społecznościowych.

Jak działa przepływ pracy AIHubMix

Przepływ pracy składa się z pięciu głównych etapów:

Utwórz grupę zasobów dla jednej osoby.
Poproś osobę ze zdjęcia o przejście procesu autoryzacji.
Dodaj portret i poczekaj, aż zasób stanie się aktywny.
Odwołaj się do aktywnego zasobu za pomocą identyfikatora URI asset://.
Wyślij zadanie generowania wideo Seedance i odpytuj o jego stan do zakończenia.

Ten podział jest celowy. Autoryzacja następuje przed generowaniem, gotowość zasobu można sprawdzać niezależnie, a każdy ważny etap udostępnia status, który Twoja aplikacja może monitorować.

Dlaczego warto używać AIHubMix?

Jedno API dla całego przepływu pracy

AIHubMix udostępnia endpointy dla grup zasobów, sesji weryfikacji, zasobów ludzkich i asynchronicznego generowania wideo. To samo konto i klucz API mogą zarządzać całym procesem.

Jawna autoryzacja

Osoba na portrecie kończy proces autoryzacji na stronie. Tworzy to wyraźny krok zgody, zanim obraz zostanie użyty jako wielokrotnie wykorzystywane odniesienie do prawdziwego człowieka.

Wielokrotnie używane zasoby tożsamości

Gdy obraz stanie się aktywny, aplikacje mogą ponownie wykorzystywać jego identyfikator zasobu w wielu żądaniach wideo, zamiast za każdym razem przesyłać oryginalny obraz.

Generowanie gotowe dla Seedance

Natywny endpoint Seedance 2.5 obsługuje referencje tekstowe, obrazowe, wideo i audio, a także ustawienia czasu trwania, rozdzielczości, proporcji obrazu i generowania dźwięku.

Przejrzyste stany przyjazne dla środowiska produkcyjnego

Twoja aplikacja może czekać na stany verified, active i completed, zamiast zgadywać, czy operacja się zakończyła. Ułatwia to implementację ponownych prób i obsługi błędów.

Samouczek krok po kroku

Krok 1: Przygotuj klucz API i portret

Utwórz klucz API w konsoli AIHubMix. Zachowaj go w tajemnicy. W Terminalu ustaw go jako zmienną środowiskową:

export AIHUBMIX_API_KEY="your_api_key"

Przygotuj bezpośredni adres URL obrazu w protokole HTTPS. Adres musi zwracać plik obrazu bez logowania i niestandardowych nagłówków oraz pozostać dostępny, dopóki AIHubMix go przetwarza.

Zalecane wymagania dotyczące obrazu:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC lub HEIF
Mniej niż 30 MB
Szerokość i wysokość większe niż 300 pikseli i mniejsze niż 6000 pikseli
Proporcja boków większa niż 0,4 i mniejsza niż 2,5
Wyraźny portret tej samej osoby, która przechodzi autoryzację

Krok 2: Utwórz grupę zasobów real-human

Uruchom to polecenie w Terminalu:

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

Zapisz zwrócone id, które wygląda jak ag_...:

GROUP_ID="ag_your_group_id"

Nowa grupa zwykle zaczyna od statusu pending_auth.

Krok 3: Utwórz sesję autoryzacji

Użyj identyfikatora grupy, aby zażądać sesji weryfikacji:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Odpowiedź zawiera tymczasowy adres verification_url. Otwórz ten adres w przeglądarce i poproś osobę z portretu o zapoznanie się z celem oraz ukończenie procesu autoryzacji.

Ten adres URL jest wrażliwy i tymczasowy. Nie publikuj go, nie zapisuj w repozytorium i nie umieszczaj na zrzutach ekranu.

Krok 4: Zweryfikuj autoryzację i status grupy

Po zakończeniu procesu w przeglądarce przez osobę, zapytaj o oba zasoby:

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"

Kontynuuj tylko wtedy, gdy sesja weryfikacji ma status verified, a grupa zasobów ma status active. Strona błędu w przeglądarce nie określa ostatecznego wyniku; korzystaj ze statusu z API.

Krok 5: Dodaj portret

Prześlij bezpośredni adres URL obrazu:

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

Zapisz zwrócony identyfikator zasobu i odpytuj o jego stan:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Używaj zasobu tylko wtedy, gdy jego status to active. creating i processing oznaczają, że nie jest jeszcze gotowy.

Krok 6: Wygeneruj wideo Seedance 2.5

Zasób real-human należy umieścić w polu input_references[].url. Nie należy wklejać go do tekstu promptu:

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\"}]
  }"

Odpowiedź zwraca identyfikator zadania wideo. Odpytuj GET /ai/v1/videos/{id}, aż zadanie będzie mieć status completed, a następnie niezwłocznie pobierz wynik, ponieważ adresy URL wideo są tymczasowe.

Seedance 2.5 i Seedance 2.0

Seedance 2.5 korzysta z natywnego endpointu /ai/v1/videos opisanego powyżej. Starsze integracje mogą używać Seedance 2.0 z kompatybilnym protokołem /v1/videos i inną strukturą treści.

Nie mieszaj obu formatów żądań. Przed wdrożeniem produkcyjnym sprawdź aktualny schemat modelu, obsługiwane czasy trwania, typy referencji, zachowanie audio i ścieżki endpointów.

Najlepsze praktyki tworzenia promptów

Opisz otoczenie, działanie, timing, ruch kamery, głos i ograniczenia. Dobry prompt może określać kimono, opadające kwiaty wiśni, delikatne machnięcie ręką, japońskie dialogi, zsynchronizowany ruch warg, naturalny ruch włosów oraz brak napisów.

Pięć sekund sprawdza się dobrze w przypadku krótkiego powitania. Jeśli wideo zawiera kilka działań lub długie zdanie, użyj dłuższego czasu trwania albo skróć scenariusz, aby występ nie wydawał się pospieszny.

Do prostego testu użyj jednej referencji tożsamości. Dodawaj kolejne referencje tylko wtedy, gdy schemat modelu je obsługuje, a każdy zasób należy do tej samej grupy zasobów.

Częste problemy

Grupa nie jest aktywna: poczekaj, aż sesja weryfikacji przejdzie w stan verified, a grupa w stan active.
Zasób jest przetwarzany: odpytuj o oryginalny identyfikator zasobu; nie twórz duplikatów z nowym identyfikatorem.
Adres URL obrazu nie działa: użyj publicznego adresu pliku HTTPS, a nie ścieżki lokalnej, strony logowania ani strony udostępniania.
Wideo odrzuca zasób: sprawdź, czy zasób ma status active, należy do tego samego konta i ma poprawny typ mediów.
Playground nie pokazuje asset://: przesyłanie obrazów w Playground i rejestracja zasobów real-human to oddzielne procesy. Dla zarejestrowanych zasobów użyj pola referencji z dokumentacji API.

Lista kontrolna końcowa

Klucz API skonfigurowany bezpiecznie.
Grupa zasobów utworzona.
Autoryzacja osoby zakończona.
Status grupy to active.
Status zasobu portretu to active.
Żądanie wideo używa asset://<asset_id>.
Zadanie wideo jest odpytywane, aż osiągnie status completed.

Zasoby real-human AIHubMix dają deweloperom praktyczny sposób tworzenia opartych na zgodzie doświadczeń wideo o spójnej tożsamości w Seedance. Zacznij od jednego zatwierdzonego portretu i krótkiego klipu testowego, a następnie rozszerz ten sam przepływ pracy na narzędzia dla twórców, treści marki i aplikacje produkcyjne.