Jak używać prawdziwej twarzy w Seedance 2.5 z zasobami Real-Human AIHubMix

Wideo AI staje się znacznie bardziej użyteczne, gdy osoba na ekranie pozostaje rozpoznawalna z jednej sceny do drugiej. Zasoby Real-Human AIHubMix zapewniają oparte na zgodzie podejście do używania zatwierdzonej twarzy w generacji wideo Seedance, zachowując jednocześnie autoryzację, przetwarzanie zasobów i generację jako oddzielne, weryfikowalne kroki.

Ten przewodnik wyjaśnia, czym jest wideo z prawdziwymi ludźmi, jak działa przepływ pracy AIHubMix, dlaczego jest to przydatne i jak stworzyć wideo Seedance 2.5 z prawdziwą twarzą. Wyjaśnia również różnicę między natywnym API Seedance 2.5 a kompatybilnymi integracjami Seedance 2.0.

Czym jest wideo z prawdziwymi ludźmi?

Wideo z prawdziwymi ludźmi to wideo generowane przez AI, które wykorzystuje autoryzowaną osobę jako odniesienie tożsamości. Model może zmieniać otoczenie, ubranie, akcję, ruch kamery, głos lub język, zachowując rozpoznawalny wygląd danej osoby.

To różni się od zwykłej generacji wideo na podstawie tekstu. Podpowiedź tekstowa opisuje, co powinno się wydarzyć, ale nie identyfikuje niezawodnie konkretnej prawdziwej osoby. Zasób z prawdziwą osobą daje modelowi zatwierdzone odniesienie wizualne, które można ponownie wykorzystać w wielu filmach.

Typowe zastosowania obejmują awatary twórców, wirtualnych prezenterów, filmy wyjaśniające produkty, lokalizowane kampanie, filmy szkoleniowe, postacie marki oraz krótkie treści społecznościowe.

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ę na zdjęciu o zakończenie procesu autoryzacji.
Dodaj portret i czekaj, aż zasób będzie aktywny.
Odwołaj się do aktywnego zasobu za pomocą URI asset://.
Prześlij zadanie wideo Seedance i sprawdzaj je aż do zakończenia.

Separacja jest zamierzona. Autoryzacja odbywa się przed generacją, gotowość zasobu można sprawdzić niezależnie, a każdy ważny etap ujawnia status, który Twoja aplikacja może monitorować.

Dlaczego warto używać AIHubMix?

Jedno API dla całego przepływu pracy

AIHubMix zapewnia punkty końcowe dla grup zasobów, sesji weryfikacyjnych, zasobów ludzkich oraz asynchronicznej generacji wideo. To samo konto i klucz API mogą zarządzać całym procesem.

Wyraźna autoryzacja

Osoba na portrecie kończy stronę autoryzacji. Tworzy to wyraźny krok zgody przed użyciem obrazu jako wielokrotnego odniesienia z prawdziwą osobą.

Wielokrotne zasoby tożsamości

Po aktywacji obrazu aplikacje mogą ponownie używać jego identyfikatora zasobu w wielu żądaniach wideo, zamiast przesyłać oryginalny obraz za każdym razem.

Generacja gotowa do Seedance

Natywne końcówka Seedance 2.5 obsługuje odniesienia do tekstu, obrazu, wideo i dźwięku, a także kontrolki dotyczące czasu trwania, rozdzielczości, proporcji obrazu i generacji dźwięku.

Obserwowalne, przyjazne dla produkcji stany

Twoja aplikacja może czekać na 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.

Przewodnik 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 HTTPS. Adres URL musi zwracać plik obrazu bez logowania lub niestandardowych nagłówków i musi być dostępny, gdy 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 obrazu większa niż 0.4 i mniejsza niż 2.5
Wyraźny portret tej samej osoby, która kończy autoryzację

Krok 2: Utwórz grupę zasobów z prawdziwymi ludźmi

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":"Mój zasób z prawdziwymi ludźmi"}'

Zapisz zwrócony id, który wygląda jak ag_...:

GROUP_ID="ag_your_group_id"

Nowa grupa zazwyczaj zaczyna się od pending_auth.

Krok 3: Utwórz sesję autoryzacyjną

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

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

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

Adres URL jest wrażliwy i tymczasowy. Nie publikuj go, nie umieszczaj w repozytorium ani nie dołączaj do zrzutów ekranu.

Krok 4: Zweryfikuj autoryzację i status grupy

Po zakończeniu przez osobę procesu w przeglądarce, zapytaj 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 weryfikacyjna jest verified, a grupa zasobów jest active. Strona błędu przeglądarki nie określa ostatecznego wyniku; użyj statusu 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 sprawdzaj go:

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

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

Krok 6: Wygeneruj wideo Seedance 2.5

Zasób z prawdziwą osobą należy umieścić w input_references[].url. Nie powinien być wklejany do tekstu podpowiedzi:

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\":\"Realistyczny pionowy vlog. Osoba uśmiecha się, macha i mówi po japońsku: やっほー！今日も笑顔でね！ Zachowaj twarz w spójności, zsynchronizuj ruch warg, użyj naturalnych ruchów rąk i nie dodawaj napisów.\",
    \"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. Sprawdzaj GET /ai/v1/videos/{id} aż zadanie będzie completed, a następnie pobierz wynik niezwłocznie, ponieważ adresy URL wideo są tymczasowe.

Seedance 2.5 i Seedance 2.0

Seedance 2.5 używa natywnej końcówki /ai/v1/videos opisanej powyżej. Starsze integracje mogą używać Seedance 2.0 z kompatybilnym protokołem /v1/videos i inną strukturą treści.

Nie mieszaj dwóch formatów żądań. Przed użyciem produkcyjnym sprawdź schemat modelu na żywo pod kątem obsługiwanych czasów trwania, rozdzielczości, typów odniesień, zachowania dźwięku i ścieżek końcowych.

Najlepsze praktyki dotyczące podpowiedzi

Opisz otoczenie, akcję, czas, ruch kamery, głos i ograniczenia. Silna podpowiedź może określać kimono, opadające kwiaty wiśni, delikatne machanie, japoński dialog, zsynchronizowany ruch warg, naturalny ruch włosów i brak napisów.

Pięć sekund dobrze sprawdza się w przypadku krótkiego powitania. Jeśli wideo zawiera kilka akcji lub długie zdanie, użyj dłuższego czasu trwania lub skróć skrypt, aby występ nie wydawał się pośpieszony.

Użyj jednego odniesienia tożsamości do prostego testu. Dodawaj dodatkowe odniesienia tylko wtedy, gdy schemat modelu je obsługuje, a każdy zasób należy do tej samej grupy zasobów.

Typowe problemy

Grupa nie jest aktywna: czekaj, aż sesja weryfikacyjna stanie się verified, a grupa stanie się active.
Zasób jest w trakcie przetwarzania: sprawdzaj oryginalny identyfikator zasobu; nie twórz duplikatów z nowym identyfikatorem.
Adres URL obrazu nie działa: użyj publicznego adresu URL pliku HTTPS, a nie lokalnej ścieżki, strony logowania ani strony udostępniania.
Wideo odrzuca zasób: upewnij się, że zasób jest active, należy do tego samego konta i używa poprawnego typu mediów.
Playground nie pokazuje asset://: Przesyłanie obrazu w Playground i rejestracja zasobów z prawdziwymi ludźmi to oddzielne przepływy pracy. Użyj pola odniesienia API dla zarejestrowanych zasobów.

Ostateczna lista kontrolna

Klucz API skonfigurowany w sposób bezpieczny.
Utworzona grupa zasobów.
Osoba zakończyła autoryzację.
Status grupy to active.
Status zasobu portretu to active.
Żądanie wideo używa asset://<asset_id>.
Zadanie wideo jest sprawdzane aż do completed.

Zasoby Real-Human AIHubMix dają programistom praktyczny sposób na tworzenie opartych na zgodzie, spójnych tożsamościowo doświadczeń wideo z 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.